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
Time Out In Progress
Completed
Site Mismatch
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
| Variant | What it is |
|---|---|
| Sign In active | First phase open, others locked. |
| in progress | Count of items checked; Confirm disabled until all checked. |
| confirmed | Green phase with the confirmation time. |
| Time Out active | After Sign In. |
| all confirmed | Every phase green. |
| site mismatch | Red stop alert. |
| readOnly | Review 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
| Prop | Type | Default | Description |
|---|---|---|---|
checked | Record<string, boolean> | uncontrolled | Checked items (controlled), keyed phase + index ('signin0') |
defaultChecked | Record<string, boolean> | {} | Initially checked items (uncontrolled), keyed phase + index ('signin0') |
onCheckedChange | (checked: Record<string, boolean>) => void | none | Called with every checked item when one changes |
confirmed | SafetyConfirmations | {} | Phases already confirmed, with their time 'HH:MM' (initial state) |
clock | string | the device clock | Time 'HH:MM' stamped on a new confirmation |
mismatch | string | none | Site or procedure mismatch: shows a red stop alert |
readOnly | boolean | false | Review only: nothing can be checked or confirmed |
subtitle | string | 'WHO checklist, adapted. Each phase is confirmed aloud by the team.' | Line under the title |
onConfirm | (phase: SafetyPhase, time: string) => void | none | Called when the team confirms a phase, with the time stamped |
rangeContext | RangeContextId | 'ed' when no global context is set | Which 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>
| Kind | Name | Description |
|---|---|---|
| property / JSON attribute | checked | Checked items (controlled), keyed phase + index ('signin0'); default uncontrolled |
| property / JSON attribute | default-checked / defaultChecked | Initially checked items (uncontrolled), keyed phase + index ('signin0'); default {} |
| property / JSON attribute | confirmed | Phases already confirmed, with their time 'HH:MM' (initial state); default {} |
| attribute | clock | Time 'HH:MM' stamped on a new confirmation; default the device clock |
| attribute | mismatch | Site or procedure mismatch: shows a red stop alert; default none |
| attribute | read-only / readOnly | Review only: nothing can be checked or confirmed; default false |
| attribute | subtitle | Line under the title; default 'WHO checklist, adapted. Each phase is confirmed aloud by the team.' |
| attribute | range-context / rangeContext | Which shared reference range flags use; the lab range on a result still wins; default 'ed' when no global context is set |
| property / JSON attribute | default-value / defaultValue | |
| attribute | auto-focus / autoFocus | |
| event | co-checked-change | Called with every checked item when one changes; default none (React: onCheckedChange) |
| event | co-confirm | Called when the team confirms a phase, with the time stamped; default none (React: onConfirm) |
| event | co-change | (React: onChange) |
| event | co-input | (React: onInput) |