Skip to main content

SurgicalSafetyChecklist

ComplexED & periop<co-surgical-safety-checklist>

SurgicalSafetyChecklist runs the WHO Surgical Safety Checklist in its three phases, Sign In, Time Out and Sign Out, each confirmed by the team before the next unlocks.

import { SurgicalSafetyChecklist } from 'health-components';

Examples​

Showcase​

Storybook

Time Out In Progress​

Storybook

Completed​

Storybook

Site Mismatch​

Storybook

Usage​

<SurgicalSafetyChecklist confirmed={{ signin: "07:41" }} clock={nowHHMM} onConfirm={logPhase} />

When to use​

  • In the OR on the room display or the circulator's workstation.

When not to use​

  • Pre-op nursing assessment: a form.

Variants and states​

VariantWhat it is
Sign In activeFirst phase open, others locked.
in progressCount of items checked; Confirm disabled until all checked.
confirmedGreen phase with the confirmation time.
Time Out activeAfter Sign In.
all confirmedEvery phase green.
site mismatchRed stop alert.
readOnlyReview after the case.

Accessibility​

  • Each phase is a labelled section; locked phases say Locked in text.
  • Confirm stays disabled with a help line until every item is checked.

Do and don't​

  • Do: Confirm each phase aloud, then click.
  • Don't: Pre-check items before the team speaks them.

Props​

PropTypeDefaultDescription
checkedRecord<string, boolean>uncontrolledChecked items (controlled), keyed phase + index ('signin0')
defaultCheckedRecord<string, boolean>{}Initially checked items (uncontrolled), keyed phase + index ('signin0')
onCheckedChange(checked: Record<string, boolean>) => voidnoneCalled with every checked item when one changes
confirmedSafetyConfirmations{}Phases already confirmed, with their time 'HH:MM' (initial state)
clockstringthe device clockTime 'HH:MM' stamped on a new confirmation
mismatchstringnoneSite or procedure mismatch: shows a red stop alert
readOnlybooleanfalseReview only: nothing can be checked or confirmed
subtitlestring'WHO checklist, adapted. Each phase is confirmed aloud by the team.'Line under the title
onConfirm(phase: SafetyPhase, time: string) => voidnoneCalled when the team confirms a phase, with the time stamped
rangeContextRangeContextId'ed' when no global context is setWhich shared reference range flags use; the lab range on a result still wins

Also accepts native attributes, including defaultValue, autoFocus, onChange, onInput, plus className and event handlers on the root element.

Angular, Vue and HTML​

Register the elements once (Angular guide), then use <co-surgical-safety-checklist>. 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-surgical-safety-checklist clock="…" mismatch="…" [checked]="checked" (co-checked-change)="onCheckedChange($event.detail)"></co-surgical-safety-checklist>
KindNameDescription
property / JSON attributecheckedChecked items (controlled), keyed phase + index ('signin0'); default uncontrolled
property / JSON attributedefault-checked / defaultCheckedInitially checked items (uncontrolled), keyed phase + index ('signin0'); default {}
property / JSON attributeconfirmedPhases already confirmed, with their time 'HH:MM' (initial state); default {}
attributeclockTime 'HH:MM' stamped on a new confirmation; default the device clock
attributemismatchSite or procedure mismatch: shows a red stop alert; default none
attributeread-only / readOnlyReview only: nothing can be checked or confirmed; default false
attributesubtitleLine under the title; default 'WHO checklist, adapted. Each phase is confirmed aloud by the team.'
attributerange-context / rangeContextWhich shared reference range flags use; the lab range on a result still wins; default 'ed' when no global context is set
property / JSON attributedefault-value / defaultValue
attributeauto-focus / autoFocus
eventco-checked-changeCalled with every checked item when one changes; default none (React: onCheckedChange)
eventco-confirmCalled when the team confirms a phase, with the time stamped; default none (React: onConfirm)
eventco-change (React: onChange)
eventco-input (React: onInput)