Skip to main content

Audiogram

ComplexSpecialty<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​

Storybook

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​

VariantWhat it is
air conductionRight ear red circles (O), left ear blue crosses (X), joined by lines.
bone conductionRight < and left > beside the frequency, not joined.
no responseAn arrow under the symbol at the limit of the audiometer.
degree bandsNormal 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.
tableEach threshold, the 3-frequency pure tone average and a degree badge per ear.
speechOptional 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​

PropTypeDefaultDescription
right *AudiogramEar—Right ear {ac, bc?, nr?}; required
left *AudiogramEar—Left ear {ac, bc?, nr?}; required
speechstringnoneSpeech results line
titlestring'Audiogram'Card title
subtitlestringnoneLine under the title
rangeContextRangeContextIdthe 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.

Angular template
<co-audiogram speech="…" title="…" [right]="right"></co-audiogram>
KindNameDescription
property / JSON attributerightRight ear {ac, bc?, nr?}; required
property / JSON attributeleftLeft ear {ac, bc?, nr?}; required
attributespeechSpeech results line; default none
attributetitleCard title; default 'Audiogram'
attributesubtitleLine under the title; default none
attributerange-context / rangeContextWhich shared reference range flags use; the lab range on a result still wins; default the global context, else 'outpatient'
attributedefault-checked / defaultChecked
property / JSON attributedefault-value / defaultValue
attributeauto-focus / autoFocus