Skip to main content

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​

Storybook

No Match​

Storybook

Selected​

Storybook

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​

VariantWhat it is
searchBy code or words.
favoritesChips for frequent codes.
no matchHelp text.

Accessibility​

  • Combobox pattern.

Do and don't​

  • Do: Pick the most specific billable code.
  • Don't: Allow header codes on claims.

Props​

PropTypeDefaultDescription
options *ICD10Option[]—Array<{code, label, meta?}>: the codes to search. Required
favoritesICD10Favorite[]noneArray<{code, short}>: favourite codes shown as chips
labelstring"Diagnosis (ICD-10-CM)"Field label
onSelect(option: ICD10Option) => voidnoneCalled with the chosen code (from the list or a favourite chip)
valuestringundefined (uncontrolled)Selected code (controlled)
defaultValuestringnoneInitially selected code (uncontrolled)
defaultQuerystring""Initial search text
defaultOpenbooleanfalseOpen the results on first render
placeholderstring"Code or words, such as E11.9 or diabetes"Placeholder of the search input
errorstringnoneError message under the search
requiredbooleanfalseMarks 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>
KindNameDescription
property / JSON attributeoptionsArray<{code, label, meta?}>: the codes to search. Required
property / JSON attributefavoritesArray<{code, short}>: favourite codes shown as chips; default none
attributelabelField label; default "Diagnosis (ICD-10-CM)"
attributevalueSelected code (controlled); default undefined (uncontrolled)
attributedefault-value / defaultValueInitially selected code (uncontrolled); default none
attributedefault-query / defaultQueryInitial search text; default ""
attributedefault-open / defaultOpenOpen the results on first render; default false
attributeplaceholderPlaceholder of the search input; default "Code or words, such as E11.9 or diabetes"
attributeerrorError message under the search; default none
attributerequiredMarks the field required; default false
attributedefault-checked / defaultChecked
attributeauto-focus / autoFocus
eventco-selectCalled with the chosen code (from the list or a favourite chip); default none (React: onSelect)
eventco-change (React: onChange)
eventco-input (React: onInput)