ExpandablePanel
ExpandablePanelProgressive disclosure Keep the overview easy to scan and reveal details on demand. Native disclosure with an expressive summary.
Layout & contentIn context
The summary includes title, description, metadata, badge, and icon. This example starts open; click or press Enter on its summary to collapse it.
<ExpandablePanel title="Release readiness" description="The essentials before you publish." meta="3 checks" badge="Ready" icon="lucide:check" tone="success" variant="surface" summaryVariant="outline" :open="true">
<Flex direction="column">
<p>Content reviewed, navigation checked, and themes verified.</p>
<BtnLink href="/guides/" tone="success" variant="outline">Read the guides</BtnLink>
</Flex>
</ExpandablePanel> Release details
Open the summary to reveal supporting information. Native details preserves a useful interface before any app mounts.
<ExpandablePanel
title="What ships with a component?"
description="Source, theme styles and composition"
badge="3 parts"
icon="lucide:check"
meta="Open for details"
tone="accent"
>
<ul>
<li>A typed component contract.</li>
<li>Theme-aware presentation.</li>
<li>Composable slots and native HTML.</li>
</ul>
</ExpandablePanel> Independent disclosure sections
An initially open panel can sit beside a closed one. These disclosures are independent, not a single-selection accordion.
<Flex direction="column">
<ExpandablePanel
title="Content authoring"
:open="true"
variant="outline"
summaryVariant="surface"
>
<p>Write content in MDX and use registered components directly.</p>
</ExpandablePanel>
<ExpandablePanel title="Browser state" summaryVariant="subtle">
<p>Mount a RegorApp when a sample needs reactive state.</p>
</ExpandablePanel>
</Flex> A custom summary
Replace the generated summary content while preserving the native summary element.
<ExpandablePanel tone="success">
<template #summary>
<Flex align="center" justify="between" wrap="true">
<strong>Build report</strong>
<Badge tone="success">Passing</Badge>
</Flex>
</template>
<p>The documentation build completed successfully.</p>
</ExpandablePanel> All semantic tones
All ten supported tones. A semantic palette communicates intent; visible labels keep the meaning explicit.
neutral accent feature secondary custom ghost info success warning danger Every value is visible. Compare treatments in the site’s light and dark themes.
All visual variants
All eighteen supported treatments, shown together.
solid surface surfaceAlt spotlight glass flat flatAlt flatSolid outlineFill outline subtle subtleBtn link sheen underline rail bracket none Every value is visible. Compare treatments in the site’s light and dark themes.
All summary treatments
summaryVariant styles the disclosure summary independently from the outer variant. All eighteen values are visible with their details expanded.
solid surface surfaceAlt spotlight glass flat flatAlt flatSolid outlineFill outline subtle subtleBtn link sheen underline rail bracket none Every value is visible. Compare treatments in the site’s light and dark themes.
Open and closed states
The open prop selects the initial native details state. Both summaries remain keyboard-operable.
false true Every value is visible. Compare treatments in the site’s light and dark themes.
Behavior and accessibility
Focus the summary and press Enter or Space to toggle it. Do not put nested buttons or links inside a summary. The native toggle event reports open state; the open prop sets the element state but native user toggling does not write back to a parent ref automatically.
API reference
ExpandablePanel contract
Props below are the public template API. RefOrValue accepts a literal or a reactive ref; bind refs with a colon-prefixed attribute. Native attributes and events can be passed through the component root.
title
RefOrValue<string> - Default
not set
Visible heading. Choose a short title that identifies the content or task.
description
RefOrValue<string> - Default
not set
Supporting description for the content.
meta
RefOrValue<string> - Default
not set
Secondary context such as an update time, limitation or reassurance.
badge
RefOrValue<string> - Default
not set
Optional compact label rendered with Badge.
icon
RefOrValue<string> - Default
not set
Registered SVG icon name. In browser apps, include the icon in the resolver passed to defineIconComponents.
tone
RefOrValue<SemanticTone> - Default
inherited
Semantic intent: neutral, accent, secondary, info, success, warning, danger, feature, custom or ghost. The active skin supplies the colors.
variant
RefOrValue<ComponentVariant> - Default
surface
Visual treatment. Accepts solid, surface, surfaceAlt, spotlight, glass, flat, flatAlt, flatSolid, outlineFill, outline, subtle, subtleBtn, link, sheen, underline, rail, bracket or none.
summaryVariant
RefOrValue<ComponentVariant> - Default
surface
Independent visual treatment for the stateful summary.
open
RefOrValue<boolean> - Default
false
Initial or externally bound native details open state. Listen to toggle if application state must track user changes.
Composition
Default slot: disclosure body. summary: replaces the generated icon, title, description and badge row. Register defineExpandablePanelComponents and its Panel, Flex, Badge and Icon dependencies.