ICD10Picker
ComplexOrders and notes
<co-i-c-d10-picker>ICD10Picker searches ICD-10-CM by code or words, shows billable codes and the provider's favourites.
import { ICD10Picker } from 'health-components';
Examples
Searching
No Match
Selected
Usage
<ICD10Picker options={icd10} favorites={[{ code: "E11.9", short: "T2DM" }]} onSelect={addDx} />
When to use
- Diagnoses on notes, problems, orders and claims.
When not to use
- Procedures: CPTPicker.
Variants and states
| Variant | What it is |
|---|---|
| search | By code or words. |
| favorites | Chips for frequent codes. |
| no match | Help text. |
Accessibility
- Combobox pattern.
Do and don't
- Do: Pick the most specific billable code.
- Don't: Allow header codes on claims.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
options * | ICD10Option[] | — | Array<{code, label, meta?}>: the codes to search. Required |
favorites | ICD10Favorite[] | none | Array<{code, short}>: favourite codes shown as chips |
label | string | "Diagnosis (ICD-10-CM)" | Field label |
onSelect | (option: ICD10Option) => void | none | Called with the chosen code (from the list or a favourite chip) |
value | string | undefined (uncontrolled) | Selected code (controlled) |
defaultValue | string | none | Initially selected code (uncontrolled) |
defaultQuery | string | "" | Initial search text |
defaultOpen | boolean | false | Open the results on first render |
placeholder | string | "Code or words, such as E11.9 or diabetes" | Placeholder of the search input |
error | string | none | Error message under the search |
required | boolean | false | Marks the field required |
Also accepts native attributes, including defaultChecked, 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-i-c-d10-picker>. 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-i-c-d10-picker label="…" value="…" [options]="options" (co-select)="onSelect($event.detail)"></co-i-c-d10-picker>
| Kind | Name | Description |
|---|---|---|
| property / JSON attribute | options | Array<{code, label, meta?}>: the codes to search. Required |
| property / JSON attribute | favorites | Array<{code, short}>: favourite codes shown as chips; default none |
| attribute | label | Field label; default "Diagnosis (ICD-10-CM)" |
| attribute | value | Selected code (controlled); default undefined (uncontrolled) |
| attribute | default-value / defaultValue | Initially selected code (uncontrolled); default none |
| attribute | default-query / defaultQuery | Initial search text; default "" |
| attribute | default-open / defaultOpen | Open the results on first render; default false |
| attribute | placeholder | Placeholder of the search input; default "Code or words, such as E11.9 or diabetes" |
| attribute | error | Error message under the search; default none |
| attribute | required | Marks the field required; default false |
| attribute | default-checked / defaultChecked | |
| attribute | auto-focus / autoFocus | |
| event | co-select | Called with the chosen code (from the list or a favourite chip); default none (React: onSelect) |
| event | co-change | (React: onChange) |
| event | co-input | (React: onInput) |