Audiogram
<co-audiogram>Audiogram plots hearing thresholds for each ear from 250 to 8000 Hz with the standard symbols, shades the degree of loss, and lists every value with the pure tone average.
import { Audiogram } from 'health-components';
Examples
Conductive And Profound
Usage
<Audiogram right={{ ac: { 250: 15, 500: 20, 1000: 20, 2000: 35, 4000: 55, 8000: 60 } }} left={{ ac: { 250: 15, 500: 15, 1000: 20, 2000: 30, 4000: 50, 8000: 55 } }} />
When to use
- Audiology, ENT and occupational hearing results; hearing screening follow-up.
When not to use
- A pass or refer newborn screen: a Badge.
- Tympanometry or speech-in-noise results on their own.
Variants and states
| Variant | What it is |
|---|---|
| air conduction | Right ear red circles (O), left ear blue crosses (X), joined by lines. |
| bone conduction | Right < and left > beside the frequency, not joined. |
| no response | An arrow under the symbol at the limit of the audiometer. |
| degree bands | Normal up to 25, mild 26 to 40, moderate 41 to 55, moderately severe 56 to 70, severe 71 to 90, profound above 90 dB HL. |
| table | Each threshold, the 3-frequency pure tone average and a degree badge per ear. |
| speech | Optional speech results line. |
Clinical values
Every number goes through the shared clinical value rules (CareOS.fmt and ClinicalValue from the clinical-values card): tabular digits, the unit always shown, a fixed precision per measure, the reference range in the tooltip, and H, L or critical flags. Medication amounts follow the ISMP dose style through fmt.doseNumber: rounded to the stated precision, then shown with no trailing zero (5 mg, never 5.0 mg) and a leading zero (0.5 mL). The specialty measures this card adds sit in CareOS.specialty.MEAS with their precision: thresholds whole dB HL. Ranges in the previews are sample values for the design system, not clinical guidance; a real deployment passes its own.
Accessibility
- Colour follows the audiology convention but every ear also has its own symbol shape.
- The chart label gives each ear’s average and degree; the table below has every value.
- Frequency and level axes are labelled in text.
Do and don't
- Do: Use the standard symbols so audiologists can read it at a glance.
- Do: Show the table under the chart.
- Don't: Swap red and blue between ears.
- Don't: Draw bone conduction lines joined like air.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
right * | AudiogramEar | — | Right ear {ac, bc?, nr?}; required |
left * | AudiogramEar | — | Left ear {ac, bc?, nr?}; required |
speech | string | none | Speech results line |
title | string | 'Audiogram' | Card title |
subtitle | string | none | Line under the title |
rangeContext | RangeContextId | the global context, else 'outpatient' | 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-audiogram>. 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.
<co-audiogram speech="…" title="…" [right]="right"></co-audiogram>
| Kind | Name | Description |
|---|---|---|
| property / JSON attribute | right | Right ear {ac, bc?, nr?}; required |
| property / JSON attribute | left | Left ear {ac, bc?, nr?}; required |
| attribute | speech | Speech results line; default none |
| attribute | title | Card title; default 'Audiogram' |
| attribute | subtitle | Line under the title; default none |
| attribute | range-context / rangeContext | Which shared reference range flags use; the lab range on a result still wins; default the global context, else 'outpatient' |
| attribute | default-checked / defaultChecked | |
| property / JSON attribute | default-value / defaultValue | |
| attribute | auto-focus / autoFocus |