ADTPanel
ComplexInpatient flow
<co-adt-panel>ADTPanel admits, transfers and discharges a patient: level of care, attending and reason for admit and transfer, and disposition for discharge.
import { ADTPanel } from 'health-components';
Examples
Showcase
Transfer
Discharge Blocked
Submitted
Usage
<ADTPanel mode="transfer" patient={pt} onSubmit={({ mode, level, reason }) => adt.send(mode, level, reason)} />
When to use
- Admitting, transfer centre and discharge workflows, from the chart or the bed board.
When not to use
- Picking the bed itself: BedBoard.
- Order review at transfer: OrderReconciliation.
Variants and states
| Variant | What it is |
|---|---|
| admit | Level of care, inpatient vs observation, attending, admitting diagnosis. |
| transfer | New level, target unit, attending, reason. Warns when stepping down from ICU. |
| discharge | Disposition, date and time, transport. Lists blockers; AMA shows the form reminder. |
| done | Success alert after submit. |
| errors | showErrors marks missing reason or disposition. |
| blocked | Discharge button off while blockers remain. |
| readOnly | Locked fields. |
Accessibility
- The action tabs are a tablist; tabs that do not apply to the status are disabled with a reason in the status.
- Errors are linked to the fields.
Do and don't
- Do: Show the blockers in the discharge tab itself.
- Don't: Let a discharge go through with a medication reconciliation still open.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
patient * | ADTPatient | — | { name, mrn, location, level, isolation, status }; required |
mode | ADTMode | 'admit' | 'admit' | 'transfer' | 'discharge': the starting action (uncontrolled) |
modeValue | ADTMode | uncontrolled | The action (controlled); pair with onModeChange |
onModeChange | (mode: ADTMode) => void | none | Called with the new action |
level | string | 'medsurg' | Starting level of care (uncontrolled) |
levelValue | string | uncontrolled | Level of care (controlled) |
onLevelChange | (level: string) => void | none | Called with the new level of care |
reason | string | '' | Starting reason, diagnosis or disposition (uncontrolled) |
reasonValue | string | uncontrolled | Reason (controlled) |
onReasonChange | (reason: string) => void | none | Called with the new reason |
blockers | string[] | [] | string[]: open discharge items that block discharge |
units | string[] | sample list | string[]: target units for a transfer |
attendings | string[] | sample list | string[]: attendings |
dischargeAt | string | '10/09/2026 14:30' | Discharge date and time shown at start |
showErrors | boolean | false | Shows required-field errors |
done | boolean | false | Shows the confirmation (already submitted) |
readOnly | boolean | false | View only |
onSubmit | (value: ADTSubmit) => void | none | function({ mode, level, reason }) on the main action |
onCancel | () => void | none | function on Cancel |
rangeContext | RangeContextId | 'inpatient' 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-adt-panel>. 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-adt-panel mode="…" mode-value="…" [patient]="patient" (co-mode-change)="onModeChange($event.detail)"></co-adt-panel>
| Kind | Name | Description |
|---|---|---|
| property / JSON attribute | patient | { name, mrn, location, level, isolation, status }; required |
| attribute | mode | 'admit' | 'transfer' | 'discharge': the starting action (uncontrolled); default 'admit' |
| attribute | mode-value / modeValue | The action (controlled); pair with onModeChange; default uncontrolled |
| attribute | level | Starting level of care (uncontrolled); default 'medsurg' |
| attribute | level-value / levelValue | Level of care (controlled); default uncontrolled |
| attribute | reason | Starting reason, diagnosis or disposition (uncontrolled); default '' |
| attribute | reason-value / reasonValue | Reason (controlled); default uncontrolled |
| property / JSON attribute | blockers | string[]: open discharge items that block discharge; default [] |
| property / JSON attribute | units | string[]: target units for a transfer; default sample list |
| property / JSON attribute | attendings | string[]: attendings; default sample list |
| attribute | discharge-at / dischargeAt | Discharge date and time shown at start; default '10/09/2026 14:30' |
| attribute | show-errors / showErrors | Shows required-field errors; default false |
| attribute | done | Shows the confirmation (already submitted); default false |
| attribute | read-only / readOnly | View only; default false |
| attribute | range-context / rangeContext | Which shared reference range flags use; the lab range on a result 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-mode-change | Called with the new action; default none (React: onModeChange) |
| event | co-level-change | Called with the new level of care; default none (React: onLevelChange) |
| event | co-reason-change | Called with the new reason; default none (React: onReasonChange) |
| event | co-submit | function({ mode, level, reason }) on the main action; default none (React: onSubmit) |
| event | co-cancel | function on Cancel; default none (React: onCancel) |