EDTrackingBoard
ComplexED & periop
<co-ed-tracking-board>EDTrackingBoard is the emergency department whiteboard: every patient with ESI acuity, room, chief complaint, wait against the ESI target, status, provider and nurse, last vitals and safety flags.
import { EDTrackingBoard } from 'health-components';
Examples
Showcase
Wall Board
My Patients
Empty
ESI Badges
Usage
<EDTrackingBoard patients={edPatients} currentProvider="Dr. Priya Raman" />
<ESIBadge level={2} showLabel />
When to use
- The main ED view for charge nurses, providers and techs.
- A wall display in the department (use density compact).
When not to use
- One patient: PatientBanner. Inpatient bed boards: a census table.
Variants and states
| Variant | What it is |
|---|---|
| full | Summary tiles, filter, table with last vitals. |
| compact | density compact hides the vitals column for wall boards. |
| ESI 1 row | Red row and ringed ESI 1 tag. |
| over target | Waiting patients past the ESI wait target get a red "Over N min target" tag. |
| lobby | No room yet shows Lobby. |
| flags | Sepsis, Stroke, STEMI, Trauma, Isolation, Fall Risk, Behavioral, Interpreter. |
| filters | All, Waiting, Boarding, My patients. |
| empty | No patients, or none matching the filter. |
Accessibility
- Table has a caption; rows sort by ESI then wait, so screen readers hear the sickest first.
- ESI tags say "ESI 2" in words, and the tooltip names the level.
- Wait over target is a text tag, not colour alone.
Do and don't
- Do: Keep the board sorted by acuity.
- Do: Show who owns each patient.
- Don't: Hide patients without a room.
- Don't: Use colour alone for acuity.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
patients * | EDPatient[] | — | Patients in the department; required |
waitTargets | Partial<Record<ESILevel, number>> | {1: 0, 2: 10, 3: 30, 4: 60, 5: 120} | Wait targets in minutes per ESI level |
currentProvider | string | none | Provider name for the My patients filter |
density | EDDensity | 'comfortable' | 'comfortable' | 'compact' (hides the vitals column, for wall boards) |
filter | EDFilter | uncontrolled | Filter (controlled): 'all' | 'waiting' | 'boarding' | 'mine' |
defaultFilter | EDFilter | 'all' | Initial filter (uncontrolled) |
onFilterChange | (filter: EDFilter) => void | none | Called with the new filter |
summary | boolean | true | Shows the summary tiles |
readOnly | boolean | false | Hides the Quick Register action |
onQuickRegister | () => void | none | Called by Quick Register |
title | string | 'ED Tracking Board' | Card title |
subtitle | string | none | Line under the title |
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 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-ed-tracking-board>. 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-ed-tracking-board current-provider="…" density="…" [patients]="patients" (co-filter-change)="onFilterChange($event.detail)"></co-ed-tracking-board>
| Kind | Name | Description |
|---|---|---|
| property / JSON attribute | patients | Patients in the department; required |
| property / JSON attribute | wait-targets / waitTargets | Wait targets in minutes per ESI level; default {1: 0, 2: 10, 3: 30, 4: 60, 5: 120} |
| attribute | current-provider / currentProvider | Provider name for the My patients filter; default none |
| attribute | density | 'comfortable' | 'compact' (hides the vitals column, for wall boards); default 'comfortable' |
| attribute | filter | Filter (controlled): 'all' | 'waiting' | 'boarding' | 'mine'; default uncontrolled |
| attribute | default-filter / defaultFilter | Initial filter (uncontrolled); default 'all' |
| attribute | summary | Shows the summary tiles; default true |
| attribute | read-only / readOnly | Hides the Quick Register action; default false |
| attribute | title | Card title; default 'ED Tracking Board' |
| attribute | subtitle | Line under the title; default none |
| 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 |
| attribute | default-checked / defaultChecked | |
| property / JSON attribute | default-value / defaultValue | |
| attribute | auto-focus / autoFocus | |
| event | co-filter-change | Called with the new filter; default none (React: onFilterChange) |
| event | co-quick-register | Called by Quick Register; default none (React: onQuickRegister) |