Collapsible
A disclosure that shows or hides one panel of content from a trigger. Three custom elements share state through context.
Tag <sb-collapsible> · status stable · version 0.1.0
Example
Order details
<sb-collapsible style="display:block;width:350px">
<div style="display:flex;align-items:center;justify-content:space-between;gap:16px">
<strong>Order details</strong>
<sb-collapsible-trigger aria-label="Toggle details">
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m7 15 5 5 5-5" /><path d="m7 9 5-5 5 5" /></svg>
</sb-collapsible-trigger>
</div>
<sb-collapsible-content>Billing address and delivery notes appear here.</sb-collapsible-content>
</sb-collapsible>
Properties
| Name | Type | Default | Notes |
|---|---|---|---|
expanded |
boolean | false |
Whether the panel is shown. The trigger flips it; code can set it too. |
disabled |
boolean | false |
Disables the trigger. The current state is kept. |
Events
| Name | Notes |
|---|---|
sb-toggle |
Fires on the sb-collapsible host after expanded changes, from the trigger or from code (like <details> toggle, but it bubbles; shaped like Dialog's sb-toggle). Read host.expanded for the new state. |
Parts
<sb-collapsible-trigger>
The control that toggles its collapsible. Renders a native button around its slotted content.
| Event | Notes |
|---|---|
click |
Pointer, Enter or Space; toggles the collapsible. |
Keyboard
| Key | Does |
|---|---|
Enter |
toggle the content |
Space |
toggle the content |
Tab |
move focus to the trigger and past it; closed content is out of the tab order |
Accessibility
- Role:
button (the trigger); the content has no role - Native element:
button - Accessible name: Trigger text. Host aria-label on sb-collapsible-trigger is forwarded to the inner button (ID references do not cross shadow roots, SB-0009).