Skip to main content

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​

Storybook

Accepted​

Storybook

Incomplete​

Storybook

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​

VariantWhat it is
fullAll four sections, flags, due list.
acceptedGreen "Received by" badge with time.
missing sectionShows "Not filled in".
flagsIsolation, 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 values so they are formatted and flagged.
  • Don't: Paste vitals as free text.

Props​

PropTypeDefaultDescription
situationHandoffSectionnone (shows Not filled in)S: Situation
backgroundHandoffSection—B: Background
assessmentHandoffSection—A: Assessment
recommendationHandoffSection—R: Recommendation
pendingstring[]noneWhat is due in the next 4 hours
flagsHandoffFlag[]noneHeader flags
fromstring—Giving nurse
tostring—Receiving nurse
acknowledgedboolean—Controlled accepted state
defaultAcknowledgedbooleanfalseInitial accepted state (uncontrolled)
ackTimestringnoneWhen it was accepted ('19:12')
onAcknowledge() => void—Called when the receiving nurse accepts
titlestring'Shift Handoff (SBAR)'Card title
subtitlestringnoneUnit line
rangeContextRangeContextId'inpatient' when no global context is setWhich 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>
KindNameDescription
property / JSON attributesituationS: Situation; default none (shows Not filled in)
property / JSON attributebackgroundB: Background
property / JSON attributeassessmentA: Assessment
property / JSON attributerecommendationR: Recommendation
property / JSON attributependingWhat is due in the next 4 hours; default none
property / JSON attributeflagsHeader flags; default none
attributefromGiving nurse
attributetoReceiving nurse
attributeacknowledgedControlled accepted state
attributedefault-acknowledged / defaultAcknowledgedInitial accepted state (uncontrolled); default false
attributeack-time / ackTimeWhen it was accepted ('19:12'); default none
attributetitleCard title; default 'Shift Handoff (SBAR)'
attributesubtitleUnit line; default none
attributerange-context / rangeContextWhich shared reference range flags use; a value's own range still wins; default 'inpatient' when no global context is set
attributedefault-checked / defaultChecked
property / JSON attributedefault-value / defaultValue
attributeauto-focus / autoFocus
eventco-acknowledgeCalled when the receiving nurse accepts (React: onAcknowledge)