Superfícies
VAccordion
Progressive disclosure for FAQs, settings panels, and any content that benefits from a clear, compact hierarchy.
<script setup lang="ts">
import { VAccordion } from 'vueui-nova-kit'
</script>Uso
<script setup lang="ts">
const open = ref<string | null>('pricing')
</script>
<template>
<VAccordion v-model="open" aria-label="FAQ">
<VAccordionItem id="pricing" title="How does pricing work?">
<p>We offer a free plan for individuals and a Pro plan for teams.</p>
</VAccordionItem>
</VAccordion>
</template>Playground
Os controles abaixo são gerados a partir das props declaradas em VAccordion.types.ts; o código acompanha cada mudança.
Exemplos
Variantes, tamanhos e estados, extraídos das stories da biblioteca.
Default
Variação Padrão. Estado padrão do componente; use a aba Controls para experimentar as props ao vivo.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VAccordion, VAccordionItem, VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
multiple: false,
attached: false,
disabled: false
}
const open = ref('pricing')
const faqItems = [
{
id: 'what-is',
title: 'What is VueUI Nova?',
body: 'VueUI Nova is a modern UI library for Vue 3, designed for speed and clarity.'
},
{
id: 'pricing',
title: 'How does pricing work?',
body: 'VueUI Nova is open source and free for personal use. We also offer a Pro plan with advanced components, team collaboration, and priority support.'
},
{
id: 'commercial',
title: 'Can I use it in commercial projects?',
body: 'Yes. Use VueUI Nova in commercial projects under the project license.'
},
{
id: 'help',
title: 'Where can I get help?',
body: 'Read the documentation or open an issue in the project repository.'
}
]
</script>
<template>
<VAccordion v-bind="args" v-model="open" aria-label="Frequently asked questions">
<VAccordionItem v-for="item in faqItems" :key="item.id" :id="item.id" :title="item.title">
<p>{{ item.body }}</p>
<div v-if="item.id === 'pricing'" class="v-accordion__actions">
<VButton size="sm" data-test-id="accordion-button-learn-more">Learn more ›</VButton>
<VButton size="sm" variant="outline" data-test-id="accordion-button-view-pricing">View pricing</VButton>
</div>
</VAccordionItem>
</VAccordion>
</template>Variants
Variação Variantes. Slots usados: #icon.
Ver código
<script setup lang="ts">
import { VAccordion, VAccordionItem } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
multiple: false,
attached: false,
disabled: false
}
</script>
<template>
<div class="grid gap-6">
<VAccordion v-bind="args" variant="default" aria-label="Default variant">
<VAccordionItem id="general" title="General">General settings</VAccordionItem>
<VAccordionItem id="account" title="Account">Account settings</VAccordionItem>
</VAccordion>
<VAccordion v-bind="args" variant="divided" aria-label="Divided variant">
<VAccordionItem id="profile" title="Profile">Profile details</VAccordionItem>
<VAccordionItem id="notifications" title="Notifications">Notification preferences</VAccordionItem>
</VAccordion>
<VAccordion v-bind="args" variant="bordered" aria-label="Bordered variant">
<VAccordionItem id="appearance" title="Appearance">Appearance settings</VAccordionItem>
<VAccordionItem id="integrations" title="Integrations">Integration settings</VAccordionItem>
</VAccordion>
<VAccordion v-bind="args" variant="leading-icon" aria-label="Leading icon variant">
<VAccordionItem id="settings" title="Settings"><template #icon>⚙</template>Manage settings</VAccordionItem>
<VAccordionItem id="members" title="Members"><template #icon>♙</template>Manage members</VAccordionItem>
</VAccordion>
</div>
</template>Sizes
Variação Tamanhos.
Ver código
<script setup lang="ts">
import { VAccordion, VAccordionItem } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
multiple: false,
attached: false,
disabled: false
}
</script>
<template>
<div class="grid gap-4">
<VAccordion v-bind="args" size="sm" aria-label="Small accordion"><VAccordionItem title="Small">Compact density</VAccordionItem></VAccordion>
<VAccordion v-bind="args" size="md" aria-label="Medium accordion"><VAccordionItem title="Medium (default)">Default density</VAccordionItem></VAccordion>
<VAccordion v-bind="args" size="lg" aria-label="Large accordion"><VAccordionItem title="Large">Spacious density</VAccordionItem></VAccordion>
</div>
</template>States
Variação Estados.
Ver código
<script setup lang="ts">
import { VAccordion, VAccordionItem } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
multiple: false,
attached: false,
disabled: false
}
</script>
<template>
<div class="grid gap-3">
<VAccordion v-bind="args" aria-label="Collapsed"><VAccordionItem id="collapsed" title="Collapsed">Content</VAccordionItem></VAccordion>
<VAccordion v-bind="args" model-value="expanded" aria-label="Expanded"><VAccordionItem id="expanded" title="Expanded">Content</VAccordionItem></VAccordion>
</div>
</template>Multiple
Variação Múltiplo.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VAccordion, VAccordionItem, VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
multiple: true,
attached: false,
disabled: false
}
const open = ref([
'pricing',
'help'
])
const faqItems = [
{
id: 'what-is',
title: 'What is VueUI Nova?',
body: 'VueUI Nova is a modern UI library for Vue 3, designed for speed and clarity.'
},
{
id: 'pricing',
title: 'How does pricing work?',
body: 'VueUI Nova is open source and free for personal use. We also offer a Pro plan with advanced components, team collaboration, and priority support.'
},
{
id: 'commercial',
title: 'Can I use it in commercial projects?',
body: 'Yes. Use VueUI Nova in commercial projects under the project license.'
},
{
id: 'help',
title: 'Where can I get help?',
body: 'Read the documentation or open an issue in the project repository.'
}
]
</script>
<template>
<VAccordion v-bind="args" v-model="open" aria-label="Frequently asked questions">
<VAccordionItem v-for="item in faqItems" :key="item.id" :id="item.id" :title="item.title">
<p>{{ item.body }}</p>
<div v-if="item.id === 'pricing'" class="v-accordion__actions">
<VButton size="sm" data-test-id="accordion-button-learn-more">Learn more ›</VButton>
<VButton size="sm" variant="outline" data-test-id="accordion-button-view-pricing">View pricing</VButton>
</div>
</VAccordionItem>
</VAccordion>
</template>Attached
Variação Attached. Itens coladas com uma única linha de 1px entre elas; cantos arredondados apenas nas pontas.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VAccordion, VAccordionItem, VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
multiple: false,
attached: true,
disabled: false
}
const open = ref('pricing')
const faqItems = [
{
id: 'what-is',
title: 'What is VueUI Nova?',
body: 'VueUI Nova is a modern UI library for Vue 3, designed for speed and clarity.'
},
{
id: 'pricing',
title: 'How does pricing work?',
body: 'VueUI Nova is open source and free for personal use. We also offer a Pro plan with advanced components, team collaboration, and priority support.'
},
{
id: 'commercial',
title: 'Can I use it in commercial projects?',
body: 'Yes. Use VueUI Nova in commercial projects under the project license.'
},
{
id: 'help',
title: 'Where can I get help?',
body: 'Read the documentation or open an issue in the project repository.'
}
]
</script>
<template>
<VAccordion v-bind="args" v-model="open" aria-label="Frequently asked questions">
<VAccordionItem v-for="item in faqItems" :key="item.id" :id="item.id" :title="item.title">
<p>{{ item.body }}</p>
<div v-if="item.id === 'pricing'" class="v-accordion__actions">
<VButton size="sm" data-test-id="accordion-button-learn-more">Learn more ›</VButton>
<VButton size="sm" variant="outline" data-test-id="accordion-button-view-pricing">View pricing</VButton>
</div>
</VAccordionItem>
</VAccordion>
</template>Attached Sizes
Variação Attached · Tamanhos. O modo empilhado mantém a mesma densidade de sm, md e lg.
Ver código
<script setup lang="ts">
import { VAccordion, VAccordionItem } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
multiple: false,
attached: true,
disabled: false
}
</script>
<template>
<div class="grid gap-4">
<VAccordion v-bind="args" size="sm" aria-label="Small attached accordion"><VAccordionItem id="a-sm-1" title="Small one">Compact density</VAccordionItem><VAccordionItem id="a-sm-2" title="Small two">Compact density</VAccordionItem></VAccordion>
<VAccordion v-bind="args" size="md" aria-label="Medium attached accordion"><VAccordionItem id="a-md-1" title="Medium one">Default density</VAccordionItem><VAccordionItem id="a-md-2" title="Medium two">Default density</VAccordionItem></VAccordion>
<VAccordion v-bind="args" size="lg" aria-label="Large attached accordion"><VAccordionItem id="a-lg-1" title="Large one">Spacious density</VAccordionItem><VAccordionItem id="a-lg-2" title="Large two">Spacious density</VAccordionItem></VAccordion>
</div>
</template>Attached Multiple
Variação Attached · Múltiplo. Vários itens podem permanecer abertos dentro do bloco empilhado.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VAccordion, VAccordionItem, VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
multiple: true,
attached: true,
disabled: false
}
const open = ref([
'pricing',
'help'
])
const faqItems = [
{
id: 'what-is',
title: 'What is VueUI Nova?',
body: 'VueUI Nova is a modern UI library for Vue 3, designed for speed and clarity.'
},
{
id: 'pricing',
title: 'How does pricing work?',
body: 'VueUI Nova is open source and free for personal use. We also offer a Pro plan with advanced components, team collaboration, and priority support.'
},
{
id: 'commercial',
title: 'Can I use it in commercial projects?',
body: 'Yes. Use VueUI Nova in commercial projects under the project license.'
},
{
id: 'help',
title: 'Where can I get help?',
body: 'Read the documentation or open an issue in the project repository.'
}
]
</script>
<template>
<VAccordion v-bind="args" v-model="open" aria-label="Frequently asked questions">
<VAccordionItem v-for="item in faqItems" :key="item.id" :id="item.id" :title="item.title">
<p>{{ item.body }}</p>
<div v-if="item.id === 'pricing'" class="v-accordion__actions">
<VButton size="sm" data-test-id="accordion-button-learn-more">Learn more ›</VButton>
<VButton size="sm" variant="outline" data-test-id="accordion-button-view-pricing">View pricing</VButton>
</div>
</VAccordionItem>
</VAccordion>
</template>Attached With Variants
Variação Attached · Variantes. O modo empilhado combinado com cada variante visual.
Ver código
<script setup lang="ts">
import { VAccordion, VAccordionItem } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
multiple: false,
attached: true,
disabled: false
}
</script>
<template>
<div class="grid gap-6">
<VAccordion v-bind="args" variant="default" aria-label="Default attached variant">
<VAccordionItem id="att-general" title="General">General settings</VAccordionItem>
<VAccordionItem id="att-account" title="Account">Account settings</VAccordionItem>
</VAccordion>
<VAccordion v-bind="args" variant="divided" aria-label="Divided attached variant">
<VAccordionItem id="att-profile" title="Profile">Profile details</VAccordionItem>
<VAccordionItem id="att-notifications" title="Notifications">Notification preferences</VAccordionItem>
</VAccordion>
<VAccordion v-bind="args" variant="bordered" aria-label="Bordered attached variant">
<VAccordionItem id="att-appearance" title="Appearance">Appearance settings</VAccordionItem>
<VAccordionItem id="att-integrations" title="Integrations">Integration settings</VAccordionItem>
</VAccordion>
<VAccordion v-bind="args" variant="leading-icon" aria-label="Leading icon attached variant">
<VAccordionItem id="att-settings" title="Settings"><template #icon>⚙</template>Manage settings</VAccordionItem>
<VAccordionItem id="att-members" title="Members"><template #icon>♙</template>Manage members</VAccordionItem>
</VAccordion>
</div>
</template>Attached Dark
Variação Attached · Escuro. Mesmo modo empilhado com data-theme="dark" aplicado via global theme.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VAccordion, VAccordionItem, VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
multiple: false,
attached: true,
disabled: false
}
const open = ref('pricing')
const faqItems = [
{
id: 'what-is',
title: 'What is VueUI Nova?',
body: 'VueUI Nova is a modern UI library for Vue 3, designed for speed and clarity.'
},
{
id: 'pricing',
title: 'How does pricing work?',
body: 'VueUI Nova is open source and free for personal use. We also offer a Pro plan with advanced components, team collaboration, and priority support.'
},
{
id: 'commercial',
title: 'Can I use it in commercial projects?',
body: 'Yes. Use VueUI Nova in commercial projects under the project license.'
},
{
id: 'help',
title: 'Where can I get help?',
body: 'Read the documentation or open an issue in the project repository.'
}
]
</script>
<template>
<VAccordion v-bind="args" v-model="open" aria-label="Frequently asked questions">
<VAccordionItem v-for="item in faqItems" :key="item.id" :id="item.id" :title="item.title">
<p>{{ item.body }}</p>
<div v-if="item.id === 'pricing'" class="v-accordion__actions">
<VButton size="sm" data-test-id="accordion-button-learn-more">Learn more ›</VButton>
<VButton size="sm" variant="outline" data-test-id="accordion-button-view-pricing">View pricing</VButton>
</div>
</VAccordionItem>
</VAccordion>
</template>Disabled
Variação Desabilitado. Todos os gatilhos do grupo ficam inativos (aria-disabled).
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VAccordion, VAccordionItem, VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
multiple: false,
attached: false,
disabled: true
}
const open = ref('pricing')
const faqItems = [
{
id: 'what-is',
title: 'What is VueUI Nova?',
body: 'VueUI Nova is a modern UI library for Vue 3, designed for speed and clarity.'
},
{
id: 'pricing',
title: 'How does pricing work?',
body: 'VueUI Nova is open source and free for personal use. We also offer a Pro plan with advanced components, team collaboration, and priority support.'
},
{
id: 'commercial',
title: 'Can I use it in commercial projects?',
body: 'Yes. Use VueUI Nova in commercial projects under the project license.'
},
{
id: 'help',
title: 'Where can I get help?',
body: 'Read the documentation or open an issue in the project repository.'
}
]
</script>
<template>
<VAccordion v-bind="args" v-model="open" aria-label="Frequently asked questions">
<VAccordionItem v-for="item in faqItems" :key="item.id" :id="item.id" :title="item.title">
<p>{{ item.body }}</p>
<div v-if="item.id === 'pricing'" class="v-accordion__actions">
<VButton size="sm" data-test-id="accordion-button-learn-more">Learn more ›</VButton>
<VButton size="sm" variant="outline" data-test-id="accordion-button-view-pricing">View pricing</VButton>
</div>
</VAccordionItem>
</VAccordion>
</template>Acessibilidade
Triggers are native buttons with aria-expanded, aria-controls, and a visible :focus-visible ring. Panels use role="region" and aria-labelledby. Enter and Space use native button activation; Arrow Up/Down/Left/Right, Home, and End move focus between enabled triggers. Disabled triggers are removed from the tab order by native disabled semantics.
Motion
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Hover/pressed | background/color | --v-motion-fast | --v-ease-out |
| Focus-visible | outline | --v-motion-fast | --v-ease-out |
| Expand/collapse | grid rows/opacity | --v-motion-normal | --v-ease-out |
| Indicator | transform | --v-motion-fast | --v-ease-standard |
The panel uses a grid-row transition so content pushes the following item instead of floating over it. prefers-reduced-motion: reduce disables all accordion transitions.
Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
modelValue | VAccordionModelValue | — | — |
multiple | boolean | false | — |
size | VAccordionSize | "md" | — |
variant | VAccordionVariant | "default" | — |
ariaLabel | string | — | — |
attached | boolean | false | Remove o espaçamento entre itens e compartilha a borda (modo empilhado). |
disabled | boolean | false | Desabilita todos os itens do grupo. |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: VAccordionModelValue | — |
@open-change | value: VAccordionModelValue | — |
Slots
| Slot | Props do slot |
|---|---|
#default | — |
Fonte: src/components/feedback/VAccordion/VAccordion.vue · tipos: src/components/feedback/VAccordion/VAccordion.types.ts