GPUI Deck

Accordion

Single or multiple open sections, header navigation, disabled items, and focused-panel closure.

Rendered by GPUI’s web backend from the real component. Requires a browser with WebGPU.

AccordionState owns a fixed, ordered collection of AccordionItem::new(value, label) entries. Values must be unique. The initial state is fully collapsed; .default_open([value]) opens an enabled entry. Use .multiple(true).default_open(["general", "details"]) to allow several open panels. Defaults must identify enabled items; more than one distinct default in single-open mode is a configuration error and panics. Mark unavailable entries with .disabled(true).

Render Accordion::new(id, &state) around the headers and panels, then pair each AccordionHeader::new(&state, index) with its AccordionPanel::new(&state, index) in collection order. Plain GPUI containers can arrange each pair. The root supplies a focus scope and keyboard handling, without choosing a layout or appearance.

The header contains a native heading and a button. Its children and styles apply to the button; use .heading_level(level) to change the heading level from 3. Place only non-interactive content inside the header. The application draws the indicator and uses is_open(index) to distinguish open and closed headers.

Input on a headerBehavior
Click / Enter / SpaceToggle this panel; single-open mode also closes the previous panel
Up / DownFocus the previous / next enabled header, wrapping at either end
Home / EndFocus the first / last enabled header
Tab / Shift-TabFollow normal document order through enabled headers and open content

Arrow navigation does not expand panels. Every enabled header is a normal Tab stop. Navigation actions only apply when a header itself has focus, so an Input inside a panel retains its own Home/End and arrow behavior. Disabled headers do not activate or participate in keyboard focus traversal.

State methods include items, is_open, open_values, trigger_focus_handle, panel_focus_handle, toggle(index, window, cx), and close(window, cx). Subscribe to AccordionEvent::Change(values) for the open values in original item order; an empty vector means all panels are closed. close closes every open panel. A no-op does not emit another event. Observe the state to redraw the consumer. The catalogue's Navigation help mounts two independent answers with .multiple(true), so opening the command explanation preserves the alignment answer. The session Help keeps the default single-open contract.

Closing a panel removes its layout, focus stops, and accessibility nodes. Keep form values and child entities in the application view if they must survive remounting. Panels are named regions without their own Tab stop by default; use .tab_stop(true) for static content that should receive focus itself.

If a programmatic change closes the panel that owns keyboard focus, focus moves to its surviving header, or the newly opened header when switching sections. A change does not steal focus from an unrelated control. Moving focus before panel removal also lets a nested Popover complete its dismissal lifecycle. If the entire Accordion host is removed, the application must focus a surviving control.

The library emits heading level, button role, expanded/disabled states, and a named Region. Explicit native button-to-panel controls/labelled-by relationships are not emitted: the pinned GPUI API does not expose the required sibling-node IDs.