headless component
A component that provides behaviour, state and accessibility but no styling, leaving the look entirely to the consumer.
In more detail
A headless disclosure, for example, tracks open or closed, returns the right aria-expanded and aria-controls attributes and handles keys, but renders no CSS. Teams style it with their own tokens without fighting library styles. Radix UI, React Aria and Zag are well-known headless libraries.
Related terms
- primitive — A small, general-purpose building block, such as a button, input or dialog, that product components are assembled from.
- prop getter — A function returned by a headless hook, such as getTriggerProps(), that gives back the attributes and event handlers an element needs.
- Radix UI — An open-source library of unstyled, accessible React primitives such as Dialog, Tabs and Popover.
- React Aria — Adobe's library of React hooks and components that provide accessible behaviour and keyboard interactions without styles.
- Zag — A library of framework-agnostic UI component logic written as state machines, used by Ark UI and others.
- design system — A shared set of design decisions, reusable components and rules that keeps every screen of a company's products looking and behaving the same way.
- 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.
Taught in
- Design Systems Architecture: Foundations, Layers & Taxonomy — Design Systems & Component Engineering
- Headless Architecture: State vs Presentation Separation — Design Systems & Component Engineering
- Focus Management: Trapping, Restoration & Focus Rings — Design Systems & Component Engineering
- Floating Primitives: Popovers, Tooltips & Positioning — Design Systems & Component Engineering
- Higher-Order Components And Render Props: Tradeoff Analysis — React 19 & Modern Component Architecture
- Slot Patterns And Headless UI Architecture in React — React 19 & Modern Component Architecture
- Virtualization: Rendering Infinite Datasets Efficiently — React 19 & Modern Component Architecture
- Accessible Headless Primitives: ARIA, Focus, And Keyboard — React 19 & Modern Component Architecture