ShiftHandoff
ComplexInpatient nursing
<co-shift-handoff>ShiftHandoff is the SBAR nurse-to-nurse report: Situation, Background, Assessment with formatted values, Recommendation, what is due next, and the receiving nurse accepting it.
import { ShiftHandoff } from 'health-components';
Examples
Waiting
Accepted
Incomplete
Usage
<ShiftHandoff from="L. Chen RN" to="J. Ortiz RN" situation={{ text: "..." }} assessment={{ values: [...] }} />
When to use
- Shift change, transfer between units, handoff to rapid response.
When not to use
- Provider sign-out with a task list: use the I-PASS pattern.
Variants and states
| Variant | What it is |
|---|---|
| full | All four sections, flags, due list. |
| accepted | Green "Received by" badge with time. |
| missing section | Shows "Not filled in". |
| flags | Isolation, fall risk, code status in the header. |
Accessibility
- Each section has a visible heading; the S, B, A, R letters are decorative.
- Values carry their flags in words.
Do and don't
- Do: Put numbers in
valuesso they are formatted and flagged. - Don't: Paste vitals as free text.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
situation | HandoffSection | none (shows Not filled in) | S: Situation |
background | HandoffSection | — | B: Background |
assessment | HandoffSection | — | A: Assessment |
recommendation | HandoffSection | — | R: Recommendation |
pending | string[] | none | What is due in the next 4 hours |
flags | HandoffFlag[] | none | Header flags |
from | string | — | Giving nurse |
to | string | — | Receiving nurse |
acknowledged | boolean | — | Controlled accepted state |
defaultAcknowledged | boolean | false | Initial accepted state (uncontrolled) |
ackTime | string | none | When it was accepted ('19:12') |
onAcknowledge | () => void | — | Called when the receiving nurse accepts |
title | string | 'Shift Handoff (SBAR)' | Card title |
subtitle | string | none | Unit line |
rangeContext | RangeContextId | 'inpatient' when no global context is set | Which shared reference range flags use; a value's own range still wins |
Also accepts native attributes, including defaultChecked, defaultValue, autoFocus, plus className and event handlers on the root element.
Angular, Vue and HTML
Register the elements once (Angular guide), then use <co-shift-handoff>. Attributes take strings; arrays and objects are set as properties (Angular [prop], Vue :prop) or as JSON attributes. Callbacks are DOM events with the value in event.detail.
Angular template
<co-shift-handoff from="…" to="…" [situation]="situation" (co-acknowledge)="onAcknowledge($event.detail)"></co-shift-handoff>
| Kind | Name | Description |
|---|---|---|
| property / JSON attribute | situation | S: Situation; default none (shows Not filled in) |
| property / JSON attribute | background | B: Background |
| property / JSON attribute | assessment | A: Assessment |
| property / JSON attribute | recommendation | R: Recommendation |
| property / JSON attribute | pending | What is due in the next 4 hours; default none |
| property / JSON attribute | flags | Header flags; default none |
| attribute | from | Giving nurse |
| attribute | to | Receiving nurse |
| attribute | acknowledged | Controlled accepted state |
| attribute | default-acknowledged / defaultAcknowledged | Initial accepted state (uncontrolled); default false |
| attribute | ack-time / ackTime | When it was accepted ('19:12'); default none |
| attribute | title | Card title; default 'Shift Handoff (SBAR)' |
| attribute | subtitle | Unit line; default none |
| attribute | range-context / rangeContext | Which shared reference range flags use; a value's own range still wins; default 'inpatient' when no global context is set |
| attribute | default-checked / defaultChecked | |
| property / JSON attribute | default-value / defaultValue | |
| attribute | auto-focus / autoFocus | |
| event | co-acknowledge | Called when the receiving nurse accepts (React: onAcknowledge) |