MedicationList
ComplexMedications
<co-medication-list>MedicationList is the Medications card with reconciliation status, Reconcile and Prescribe, made of MedicationRows.
import { MedicationList } from 'health-components';
Examples
Not Reconciled
With Controlled Substance
Read Only
Usage
<MedicationList items={meds} reconciled="10/09/2026" />
When to use
- Chart Medications; med reconciliation.
When not to use
- Pharmacy refill queue: InboxItem kind refill.
Variants and states
| Variant | What it is |
|---|---|
| editable | Reconcile and Prescribe. |
| readOnly | No actions. |
Accessibility
- List semantics.
Do and don't
- Do: Show last reconciliation date.
- Don't: Hide discontinued meds from history.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
items * | Medication[] | — | MedicationRow med[]; required |
reconciled | string | none (Not reconciled this visit) | Reconciliation date and person ("10/09/2026 by James Bell MD") |
readOnly | boolean | false | Hides Reconcile, Prescribe and the row menus |
onReconcile | () => void | none | Reconcile clicked |
onPrescribe | () => void | none | Prescribe clicked |
onItemAction | (action: MedicationAction, med: Medication) => void | none | A row menu action was chosen |
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-medication-list>. 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-medication-list reconciled="…" read-only [items]="items" (co-reconcile)="onReconcile($event.detail)"></co-medication-list>
| Kind | Name | Description |
|---|---|---|
| property / JSON attribute | items | MedicationRow med[]; required |
| attribute | reconciled | Reconciliation date and person ("10/09/2026 by James Bell MD"); default none (Not reconciled this visit) |
| attribute | read-only / readOnly | Hides Reconcile, Prescribe and the row menus; default false |
| attribute | default-checked / defaultChecked | |
| property / JSON attribute | default-value / defaultValue | |
| attribute | auto-focus / autoFocus | |
| event | co-reconcile | Reconcile clicked; default none (React: onReconcile) |
| event | co-prescribe | Prescribe clicked; default none (React: onPrescribe) |
| event | co-item-action | A row menu action was chosen; default none (React: onItemAction) |