InsuranceCoverageCard
ComplexRevenue
<co-insurance-coverage-card>InsuranceCoverageCard lists a patient's active coverages in billing order (COB), with reorder arrows, eligibility status and a suggested-order warning.
import { InsuranceCoverageCard } from 'health-components';
Examples
Suggested Order
Self Pay
Read Only
Usage
<InsuranceCoverageCard coverages={patient.coverages} suggested="Medicare first, then AARP Supplement" onReorder={saveOrder} />
When to use
- Insurance section of the chart; check-in coverage review.
When not to use
- Editing one coverage's fields: a form in a Drawer.
Variants and states
| Variant | What it is |
|---|---|
| ordered | Primary card highlighted. |
| suggested order | Warning with Apply Suggested Order and Keep Current Order. |
| self-pay | Warning, claims stop. |
| readOnly | No arrows or Add. |
Accessibility
- Arrow buttons are named "Move Aetna up"; order is also written (Primary, Secondary).
Do and don't
- Do: Explain the CARC 22 risk.
- Don't: Drag-only reordering.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
coverages | Coverage[] | uncontrolled | Coverages in billing order (controlled): Array<{payer, plan, memberId, group?, subscriber?, status?, checked?}> |
defaultCoverages | Coverage[] | [] | Initial coverages in billing order (uncontrolled) |
onReorder | (coverages: Coverage[]) => void | none | Called with the new order after a move |
suggested | string | none | Suggested order text; shows the order warning |
selfPay | boolean | false | Self-pay warning (no active coverage) |
readOnly | boolean | false | No arrows and no Add Coverage |
onAdd | () => void | none | Add Coverage |
onApplySuggested | () => void | none | Apply Suggested Order in the order warning |
onKeepOrder | () => void | none | Keep Current Order in the order warning |
onCheckEligibility | (coverage: Coverage) => void | none | Check Eligibility on a coverage |
onCoverageAction | (action: CoverageAction, coverage: Coverage) => void | none | An item of a coverage's More menu |
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-insurance-coverage-card>. 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-insurance-coverage-card suggested="…" self-pay [coverages]="coverages" (co-reorder)="onReorder($event.detail)"></co-insurance-coverage-card>
| Kind | Name | Description |
|---|---|---|
| property / JSON attribute | coverages | Coverages in billing order (controlled): Array<{payer, plan, memberId, group?, subscriber?, status?, checked?}>; default uncontrolled |
| property / JSON attribute | default-coverages / defaultCoverages | Initial coverages in billing order (uncontrolled); default [] |
| attribute | suggested | Suggested order text; shows the order warning; default none |
| attribute | self-pay / selfPay | Self-pay warning (no active coverage); default false |
| attribute | read-only / readOnly | No arrows and no Add Coverage; default false |
| attribute | default-checked / defaultChecked | |
| property / JSON attribute | default-value / defaultValue | |
| attribute | auto-focus / autoFocus | |
| event | co-reorder | Called with the new order after a move; default none (React: onReorder) |
| event | co-add | Add Coverage; default none (React: onAdd) |
| event | co-apply-suggested | Apply Suggested Order in the order warning; default none (React: onApplySuggested) |
| event | co-keep-order | Keep Current Order in the order warning; default none (React: onKeepOrder) |
| event | co-check-eligibility | Check Eligibility on a coverage; default none (React: onCheckEligibility) |
| event | co-coverage-action | An item of a coverage's More menu; default none (React: onCoverageAction) |