Superfícies

VAccordion

Componentev-model11 exemplos7 propsA2UI · Accordion

Progressive disclosure for FAQs, settings panels, and any content that benefits from a clear, compact hierarchy.

Importação
<script setup lang="ts">
import { VAccordion } from 'vueui-nova-kit'
</script>

Uso

Exemplo
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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

TriggerPropertyDurationEasing
Hover/pressedbackground/color--v-motion-fast--v-ease-out
Focus-visibleoutline--v-motion-fast--v-ease-out
Expand/collapsegrid rows/opacity--v-motion-normal--v-ease-out
Indicatortransform--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

PropTipoDefaultDescrição
modelValueVAccordionModelValue——
multiplebooleanfalse—
sizeVAccordionSize"md"—
variantVAccordionVariant"default"—
ariaLabelstring——
attachedbooleanfalseRemove o espaçamento entre itens e compartilha a borda (modo empilhado).
disabledbooleanfalseDesabilita todos os itens do grupo.

Events

EventoPayloadDescrição
@update:modelValuevalue: VAccordionModelValue—
@open-changevalue: VAccordionModelValue—

Slots

SlotProps do slot
#default—

Fonte: src/components/feedback/VAccordion/VAccordion.vue · tipos: src/components/feedback/VAccordion/VAccordion.types.ts