Site color

Choose your site’s color palette.

Saved on this device.

ExpandablePanel

ExpandablePanelProgressive disclosure

Keep the overview easy to scan and reveal details on demand. Native disclosure with an expressive summary.

Layout & content

In context

A release checklistCOMPOSITION
Release readiness Ready The essentials before you publish.
3 checks

Content reviewed, navigation checked, and themes verified.

Read the guides

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.

What ships with a component? 3 parts Source, theme styles and composition
Open for details
  • A typed component contract.
  • Theme-aware presentation.
  • Composable slots and native HTML.
<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.

Content authoring

Write content in MDX and use registered components directly.

Browser state

Mount a RegorApp when a sample needs reactive state.

<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.

Build report Passing

The documentation build completed successfully.

<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.

All semantic tonesCOMPOSITION
neutral
neutral

Details stay close to their summary.

accent
accent

Details stay close to their summary.

feature
feature

Details stay close to their summary.

secondary
secondary

Details stay close to their summary.

custom
custom

Details stay close to their summary.

ghost
ghost

Details stay close to their summary.

info
info

Details stay close to their summary.

success
success

Details stay close to their summary.

warning
warning

Details stay close to their summary.

danger
danger

Details stay close to their summary.

Every value is visible. Compare treatments in the site’s light and dark themes.

All visual variants

All eighteen supported treatments, shown together.

All visual variantsCOMPOSITION
solid
solid

Details stay close to their summary.

surface
surface

Details stay close to their summary.

surfaceAlt
surfaceAlt

Details stay close to their summary.

spotlight
spotlight

Details stay close to their summary.

glass
glass

Details stay close to their summary.

flat
flat

Details stay close to their summary.

flatAlt
flatAlt

Details stay close to their summary.

flatSolid
flatSolid

Details stay close to their summary.

outlineFill
outlineFill

Details stay close to their summary.

outline
outline

Details stay close to their summary.

subtle
subtle

Details stay close to their summary.

subtleBtn
subtleBtn

Details stay close to their summary.

link
link

Details stay close to their summary.

sheen
sheen

Details stay close to their summary.

underline
underline

Details stay close to their summary.

rail
rail

Details stay close to their summary.

bracket
bracket

Details stay close to their summary.

none
none

Details stay close to their summary.

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.

All summary treatmentsCOMPOSITION
solid
solid

Details stay close to their summary.

surface
surface

Details stay close to their summary.

surfaceAlt
surfaceAlt

Details stay close to their summary.

spotlight
spotlight

Details stay close to their summary.

glass
glass

Details stay close to their summary.

flat
flat

Details stay close to their summary.

flatAlt
flatAlt

Details stay close to their summary.

flatSolid
flatSolid

Details stay close to their summary.

outlineFill
outlineFill

Details stay close to their summary.

outline
outline

Details stay close to their summary.

subtle
subtle

Details stay close to their summary.

subtleBtn
subtleBtn

Details stay close to their summary.

link
link

Details stay close to their summary.

sheen
sheen

Details stay close to their summary.

underline
underline

Details stay close to their summary.

rail
rail

Details stay close to their summary.

bracket
bracket

Details stay close to their summary.

none
none

Details stay close to their summary.

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.

Open and closed statesCOMPOSITION
false
Initially collapsed 3 checks Click the summary to toggle.

Content in the default slot.

true
Initially expanded 3 checks Click the summary to toggle.

Content in the default slot.

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.