aria-describedby
An ARIA attribute that links an element to other elements, by id, whose text gives it a longer description.
In more detail
Screen readers read the description after the name and role, often after a short pause. Inputs use it for hint and error text, dialogs for their explanatory paragraph, and tooltips for the text they show.
Example
<input aria-describedby={`${id}-hint`} />Related terms
- aria-labelledby — An ARIA attribute that names an element using the text of one or more other elements, referenced by their id.
- aria-errormessage — An ARIA attribute that points from an invalid input to the element holding its error message.
- tooltip — A small text label that appears when a control is hovered or focused, describing it briefly.
- form control — An element that collects user input, such as a text input, checkbox, switch, select or button.
- ARIA — The W3C standard of HTML attributes, such as role and aria-expanded, that tell assistive technology what a custom widget is and what state it is in.
- useId — The React hook that generates a unique ID string that is stable across renders and matches between server and browser.
- label element — The HTML element that names a form control; its for attribute (htmlFor in React) holds the control's id.
Taught in
- Actionable Form Primitives: Buttons, Switches & Inputs — Design Systems & Component Engineering
- Modal Dialogs & Alert Dialogs: Accessible Overlay Patterns — Design Systems & Component Engineering
- Floating Primitives: Popovers, Tooltips & Positioning — Design Systems & Component Engineering
- useId: Generating Stable Accessible Form Element Identifiers — React 19 & Modern Component Architecture