Ações
VActionList
Lista de ações/propriedades em seções rotuladas — o painel "Environment" de apps de agentes/IDE. Itens com `href` viram links externos (↗); `trailing="chevron"` indica submenu. Slots: `trailing-{value}` (ex.: `VDiffStat`), `section-{id}` (conteúdo livre), `label`.
<script setup lang="ts">
import { VActionList } from 'vueui-nova-kit'
</script>Uso
<VActionList :sections="sections" @select="onSelect">
<template #trailing-changes><VDiffStat :additions="193" :deletions="130" /></template>
</VActionList>Playground
Os controles abaixo são gerados a partir das props declaradas em VActionList.types.ts; o código acompanha cada mudança.
Exemplos
Variantes, tamanhos e estados, extraídos das stories da biblioteca.
Default
Variação Painel Environment com VDiffStat, uso e recap.
Ver código
<script setup lang="ts">
import { VActionList, VDiffStat } from 'vueui-nova-kit'
const args = {
sections: [
{
id: 'environment',
label: 'Environment',
actionIcon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M9.8826 3.31L9.6447 5.26C9.5876 5.73 9.3203 6.14 8.9222 6.37L8.7712 6.46C8.3732 6.7 7.8905 6.73 7.467 6.55L5.6993 5.78C5.0174 5.49 4.228 5.76 3.8579 6.41L3.1967 7.59C2.8267 8.24 2.9918 9.07 3.5819 9.53L5.1117 10.71C5.4781 11 5.6935 11.44 5.6935 11.91V12.09C5.6935 12.56 5.4781 13 5.1117 13.29L3.5819 14.47C2.9918 14.93 2.8267 15.76 3.1967 16.41L3.8579 17.59C4.228 18.24 5.0174 18.51 5.6993 18.22L7.467 17.45C7.8905 17.27 8.3732 17.3 8.7712 17.54L8.9222 17.63C9.3203 17.86 9.5876 18.27 9.6447 18.74L9.8826 20.69C9.9744 21.44 10.5987 22 11.3388 22H12.6612C13.4013 22 14.0256 21.44 14.1173 20.69L14.3554 18.74C14.4124 18.27 14.6798 17.86 15.0778 17.63L15.2287 17.54C15.6268 17.3 16.1095 17.27 16.5329 17.45L18.3007 18.22C18.9826 18.51 19.772 18.24 20.1421 17.59L20.8033 16.41C21.1733 15.76 21.0082 14.93 20.4181 14.47L18.8883 13.29C18.5219 13 18.3066 12.56 18.3066 12.09V11.91C18.3066 11.44 18.5219 11 18.8883 10.71L20.4181 9.53C21.0082 9.07 21.1733 8.24 20.8033 7.59L20.1421 6.41C19.772 5.76 18.9826 5.49 18.3007 5.78L16.5329 6.55C16.1095 6.73 15.6268 6.7 15.2287 6.46L15.0778 6.37C14.6798 6.14 14.4124 5.73 14.3554 5.26L14.1173 3.31C14.0256 2.56 13.4013 2 12.6612 2H11.3388C10.5987 2 9.9744 2.56 9.8826 3.31ZM12 9.5C13.3807 9.5 14.5 10.6193 14.5 12C14.5 13.3807 13.3807 14.5 12 14.5C10.6193 14.5 9.5 13.3807 9.5 12C9.5 10.6193 10.6193 9.5 12 9.5Z\'/>'
},
actionLabel: 'Environment settings',
items: [
{
value: 'changes',
label: 'Changes',
icon: {
width: 24,
height: 24,
body: '<g fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\'><path d=\'M6 3H18C19.6569 3 21 4.34315 21 6V18C21 19.6569 19.6569 21 18 21H6C4.34315 21 3 19.6569 3 18V6C3 4.34315 4.34315 3 6 3Z\'/><path d=\'M8 12H16M11.995 16.005V8.005\'/></g>'
}
},
{
value: 'worktree',
label: 'Worktree',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M6 21V9C6.16667 12 8.2 18 15 18M18 9V3M15 6H21M6 9C7.65685 9 9 7.65685 9 6C9 4.34315 7.65685 3 6 3C4.34315 3 3 4.34315 3 6C3 7.65685 4.34315 9 6 9ZM18 21C19.6569 21 21 19.6569 21 18C21 16.3431 19.6569 15 18 15C16.3431 15 15 16.3431 15 18C15 19.6569 16.3431 21 18 21Z\'/>'
}
},
{
value: 'branch',
label: 'synara/include-merged-pull-requests',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M6 21V9C6.16667 12 8.2 18 15 18M6 9C7.65685 9 9 7.65685 9 6C9 4.34315 7.65685 3 6 3C4.34315 3 3 4.34315 3 6C3 7.65685 4.34315 9 6 9ZM18 21C19.6569 21 21 19.6569 21 18C21 16.3431 19.6569 15 18 15C16.3431 15 15 16.3431 15 18C15 19.6569 16.3431 21 18 21Z\'/>'
},
trailing: 'chevron'
},
{
value: 'push',
label: 'Commit & push',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M6 19L18 19C20.2091 19 22 17.2091 22 15C22 12.7909 20.2091 11 18 11C18 7.6863 15.3137 5 12 5C8.6863 5 6 7.6863 6 11C3.7909 11 2 12.7909 2 15C2 17.2091 3.7909 19 6 19Z\'/>'
},
trailing: 'chevron'
},
{
value: 'servers',
label: 'Local Servers',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M22 12C22 17.5228 17.5228 22 12 22C6.47715 22 2 17.5228 2 12C2 6.47715 6.47715 2 12 2C17.5228 2 22 6.47715 22 12ZM2 12H22M12 2C14.6667 5 16 8.5 16 12C16 15.5 14.6667 19 12 22C9.33333 19 8 15.5 8 12C8 8.5 9.33333 5 12 2Z\'/>'
},
hint: '0',
trailing: 'chevron'
}
]
},
{
id: 'usage',
label: 'Usage',
items: [
{
value: 'claude',
label: 'Claude',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M15.4651 9.1794L16.7409 12.4141C16.8933 12.8006 17.1994 13.1067 17.5859 13.2591L20.8206 14.5349C21.0117 14.6102 21.1372 14.7947 21.1372 15C21.1372 15.2053 21.0117 15.3898 20.8206 15.4651L17.5859 16.7409C17.1994 16.8933 16.8933 17.1994 16.7409 17.5859L15.4651 20.8206C15.3898 21.0117 15.2053 21.1372 15 21.1372C14.7947 21.1372 14.6102 21.0117 14.5349 20.8206L13.2591 17.5859C13.1067 17.1994 12.8006 16.8933 12.4141 16.7409L9.1794 15.4651C8.9883 15.3898 8.8628 15.2053 8.8628 15C8.8628 14.7947 8.9883 14.6102 9.1794 14.5349L12.4141 13.2591C12.8006 13.1067 13.1067 12.8006 13.2591 12.4141L14.5349 9.1794C14.6102 8.9883 14.7947 8.8628 15 8.8628C15.2053 8.8628 15.3898 8.9883 15.4651 9.1794ZM6.7151 3.1794L7.2131 4.4419C7.3655 4.8285 7.6715 5.1345 8.0581 5.2869L9.3206 5.7849C9.5117 5.8602 9.6372 6.0447 9.6372 6.25C9.6372 6.4553 9.5117 6.6398 9.3206 6.7151L8.0581 7.2131C7.6715 7.3655 7.3655 7.6715 7.2131 8.0581L6.7151 9.3206C6.6398 9.5117 6.4553 9.6372 6.25 9.6372C6.0447 9.6372 5.8602 9.5117 5.7849 9.3206L5.2869 8.0581C5.1345 7.6715 4.8285 7.3655 4.4419 7.2131L3.1794 6.7151C2.9883 6.6398 2.8628 6.4553 2.8628 6.25C2.8628 6.0447 2.9883 5.8602 3.1794 5.7849L4.4419 5.2869C4.8285 5.1345 5.1345 4.8285 5.2869 4.4419L5.7849 3.1794C5.8602 2.9883 6.0447 2.8628 6.25 2.8628C6.4553 2.8628 6.6398 2.9883 6.7151 3.1794Z\'/>'
},
trailing: 'chevron'
}
]
},
{
id: 'repository',
label: 'Repository',
items: [
{
value: 'repo',
label: 'acme/synara',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M9.4551 9.9845L14.5449 7.0155M9.4551 14.0155L14.5449 16.9845M21 5C21 6.6569 19.6569 8 18 8C16.3431 8 15 6.6569 15 5C15 3.3431 16.3431 2 18 2C19.6569 2 21 3.3431 21 5ZM9 12C9 13.6569 7.6569 15 6 15C4.3431 15 3 13.6569 3 12C3 10.3431 4.3431 9 6 9C7.6569 9 9 10.3431 9 12ZM21 19C21 20.6569 19.6569 22 18 22C16.3431 22 15 20.6569 15 19C15 17.3431 16.3431 16 18 16C19.6569 16 21 17.3431 21 19Z\'/>'
},
href: 'https://example.com'
}
]
},
{
id: 'editor',
label: 'Editor',
items: [
{
value: 'editor',
label: 'Editor view',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M4 3H9C9.55228 3 10 3.44772 10 4V11C10 11.55228 9.55228 12 9 12H4C3.44772 12 3 11.55228 3 11V4C3 3.44772 3.44772 3 4 3ZM4 16H9C9.55228 16 10 16.44772 10 17V20C10 20.55228 9.55228 21 9 21H4C3.44772 21 3 20.55228 3 20V17C3 16.44772 3.44772 16 4 16ZM15 3H20C20.55228 3 21 3.44772 21 4V7C21 7.55228 20.55228 8 20 8H15C14.44772 8 14 7.55228 14 7V4C14 3.44772 14.44772 3 15 3ZM15 12H20C20.55228 12 21 12.44772 21 13V20C21 20.55228 20.55228 21 20 21H15C14.44772 21 14 20.55228 14 20V13C14 12.44772 14.44772 12 15 12Z\'/>'
}
},
{
value: 'finder',
label: 'Open in Finder',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M3 7C3 5.3431 4.3431 4 6 4L8.6716 4C9.202 4 9.7107 4.2107 10.0858 4.5858L11.4142 5.9142C11.7893 6.2893 12.298 6.5 12.8284 6.5L18 6.5C19.6569 6.5 21 7.8431 21 9.5L21 17C21 18.6569 19.6569 20 18 20L6 20C4.3431 20 3 18.6569 3 17Z\'/>'
},
trailing: 'chevron'
}
]
},
{
id: 'recap',
label: 'Recap'
}
],
variant: 'card',
size: 'md',
dividers: true,
ariaLabel: 'Environment'
}
</script>
<template>
<VActionList v-bind="args">
<template #trailing-changes><VDiffStat :additions="193" :deletions="130" /></template>
<template #trailing-claude>
<span style="display:grid;grid-template-columns:auto auto;column-gap:10px;font-size:11px;line-height:1.3;text-align:right;">
<span>5h</span><span>79%</span><span>Weekly</span><span>22%</span>
</span>
</template>
<template #section-recap>
Filtro Status da Code review: adicionada a opção Merged, com persistência e ?state=merged. Restam testes manuais no app.
</template>
</VActionList>
</template>Plain
Variação Plain compacta (sem cartão).
Ver código
<script setup lang="ts">
import { VActionList, VDiffStat } from 'vueui-nova-kit'
const args = {
sections: [
{
id: 'environment',
label: 'Environment',
actionIcon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M9.8826 3.31L9.6447 5.26C9.5876 5.73 9.3203 6.14 8.9222 6.37L8.7712 6.46C8.3732 6.7 7.8905 6.73 7.467 6.55L5.6993 5.78C5.0174 5.49 4.228 5.76 3.8579 6.41L3.1967 7.59C2.8267 8.24 2.9918 9.07 3.5819 9.53L5.1117 10.71C5.4781 11 5.6935 11.44 5.6935 11.91V12.09C5.6935 12.56 5.4781 13 5.1117 13.29L3.5819 14.47C2.9918 14.93 2.8267 15.76 3.1967 16.41L3.8579 17.59C4.228 18.24 5.0174 18.51 5.6993 18.22L7.467 17.45C7.8905 17.27 8.3732 17.3 8.7712 17.54L8.9222 17.63C9.3203 17.86 9.5876 18.27 9.6447 18.74L9.8826 20.69C9.9744 21.44 10.5987 22 11.3388 22H12.6612C13.4013 22 14.0256 21.44 14.1173 20.69L14.3554 18.74C14.4124 18.27 14.6798 17.86 15.0778 17.63L15.2287 17.54C15.6268 17.3 16.1095 17.27 16.5329 17.45L18.3007 18.22C18.9826 18.51 19.772 18.24 20.1421 17.59L20.8033 16.41C21.1733 15.76 21.0082 14.93 20.4181 14.47L18.8883 13.29C18.5219 13 18.3066 12.56 18.3066 12.09V11.91C18.3066 11.44 18.5219 11 18.8883 10.71L20.4181 9.53C21.0082 9.07 21.1733 8.24 20.8033 7.59L20.1421 6.41C19.772 5.76 18.9826 5.49 18.3007 5.78L16.5329 6.55C16.1095 6.73 15.6268 6.7 15.2287 6.46L15.0778 6.37C14.6798 6.14 14.4124 5.73 14.3554 5.26L14.1173 3.31C14.0256 2.56 13.4013 2 12.6612 2H11.3388C10.5987 2 9.9744 2.56 9.8826 3.31ZM12 9.5C13.3807 9.5 14.5 10.6193 14.5 12C14.5 13.3807 13.3807 14.5 12 14.5C10.6193 14.5 9.5 13.3807 9.5 12C9.5 10.6193 10.6193 9.5 12 9.5Z\'/>'
},
actionLabel: 'Environment settings',
items: [
{
value: 'changes',
label: 'Changes',
icon: {
width: 24,
height: 24,
body: '<g fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\'><path d=\'M6 3H18C19.6569 3 21 4.34315 21 6V18C21 19.6569 19.6569 21 18 21H6C4.34315 21 3 19.6569 3 18V6C3 4.34315 4.34315 3 6 3Z\'/><path d=\'M8 12H16M11.995 16.005V8.005\'/></g>'
}
},
{
value: 'worktree',
label: 'Worktree',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M6 21V9C6.16667 12 8.2 18 15 18M18 9V3M15 6H21M6 9C7.65685 9 9 7.65685 9 6C9 4.34315 7.65685 3 6 3C4.34315 3 3 4.34315 3 6C3 7.65685 4.34315 9 6 9ZM18 21C19.6569 21 21 19.6569 21 18C21 16.3431 19.6569 15 18 15C16.3431 15 15 16.3431 15 18C15 19.6569 16.3431 21 18 21Z\'/>'
}
},
{
value: 'branch',
label: 'synara/include-merged-pull-requests',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M6 21V9C6.16667 12 8.2 18 15 18M6 9C7.65685 9 9 7.65685 9 6C9 4.34315 7.65685 3 6 3C4.34315 3 3 4.34315 3 6C3 7.65685 4.34315 9 6 9ZM18 21C19.6569 21 21 19.6569 21 18C21 16.3431 19.6569 15 18 15C16.3431 15 15 16.3431 15 18C15 19.6569 16.3431 21 18 21Z\'/>'
},
trailing: 'chevron'
},
{
value: 'push',
label: 'Commit & push',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M6 19L18 19C20.2091 19 22 17.2091 22 15C22 12.7909 20.2091 11 18 11C18 7.6863 15.3137 5 12 5C8.6863 5 6 7.6863 6 11C3.7909 11 2 12.7909 2 15C2 17.2091 3.7909 19 6 19Z\'/>'
},
trailing: 'chevron'
},
{
value: 'servers',
label: 'Local Servers',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M22 12C22 17.5228 17.5228 22 12 22C6.47715 22 2 17.5228 2 12C2 6.47715 6.47715 2 12 2C17.5228 2 22 6.47715 22 12ZM2 12H22M12 2C14.6667 5 16 8.5 16 12C16 15.5 14.6667 19 12 22C9.33333 19 8 15.5 8 12C8 8.5 9.33333 5 12 2Z\'/>'
},
hint: '0',
trailing: 'chevron'
}
]
}
],
variant: 'plain',
size: 'sm',
dividers: true,
ariaLabel: 'Environment'
}
</script>
<template>
<VActionList v-bind="args">
<template #trailing-changes><VDiffStat :additions="193" :deletions="130" /></template>
<template #trailing-claude>
<span style="display:grid;grid-template-columns:auto auto;column-gap:10px;font-size:11px;line-height:1.3;text-align:right;">
<span>5h</span><span>79%</span><span>Weekly</span><span>22%</span>
</span>
</template>
<template #section-recap>
Filtro Status da Code review: adicionada a opção Merged, com persistência e ?state=merged. Restam testes manuais no app.
</template>
</VActionList>
</template>Active And Disabled
Variação Ativo / desabilitado.
Ver código
<script setup lang="ts">
import { VActionList, VDiffStat } from 'vueui-nova-kit'
const args = {
sections: [
{
id: 'view',
label: 'View',
items: [
{
value: 'board',
label: 'Board',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M4 3H9C9.55228 3 10 3.44772 10 4V11C10 11.55228 9.55228 12 9 12H4C3.44772 12 3 11.55228 3 11V4C3 3.44772 3.44772 3 4 3ZM4 16H9C9.55228 16 10 16.44772 10 17V20C10 20.55228 9.55228 21 9 21H4C3.44772 21 3 20.55228 3 20V17C3 16.44772 3.44772 16 4 16ZM15 3H20C20.55228 3 21 3.44772 21 4V7C21 7.55228 20.55228 8 20 8H15C14.44772 8 14 7.55228 14 7V4C14 3.44772 14.44772 3 15 3ZM15 12H20C20.55228 12 21 12.44772 21 13V20C21 20.55228 20.55228 21 20 21H15C14.44772 21 14 20.55228 14 20V13C14 12.44772 14.44772 12 15 12Z\'/>'
},
active: true
},
{
value: 'list',
label: 'List',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M3 7C3 5.3431 4.3431 4 6 4L8.6716 4C9.202 4 9.7107 4.2107 10.0858 4.5858L11.4142 5.9142C11.7893 6.2893 12.298 6.5 12.8284 6.5L18 6.5C19.6569 6.5 21 7.8431 21 9.5L21 17C21 18.6569 19.6569 20 18 20L6 20C4.3431 20 3 18.6569 3 17Z\'/>'
}
},
{
value: 'timeline',
label: 'Timeline (soon)',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M6 21V9C6.16667 12 8.2 18 15 18M6 9C7.65685 9 9 7.65685 9 6C9 4.34315 7.65685 3 6 3C4.34315 3 3 4.34315 3 6C3 7.65685 4.34315 9 6 9ZM18 21C19.6569 21 21 19.6569 21 18C21 16.3431 19.6569 15 18 15C16.3431 15 15 16.3431 15 18C15 19.6569 16.3431 21 18 21Z\'/>'
},
disabled: true
}
]
}
],
variant: 'card',
size: 'md',
dividers: true,
ariaLabel: 'Environment'
}
</script>
<template>
<VActionList v-bind="args">
<template #trailing-changes><VDiffStat :additions="193" :deletions="130" /></template>
<template #trailing-claude>
<span style="display:grid;grid-template-columns:auto auto;column-gap:10px;font-size:11px;line-height:1.3;text-align:right;">
<span>5h</span><span>79%</span><span>Weekly</span><span>22%</span>
</span>
</template>
<template #section-recap>
Filtro Status da Code review: adicionada a opção Merged, com persistência e ?state=merged. Restam testes manuais no app.
</template>
</VActionList>
</template>Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
sections | VActionListSection[] | — | — |
variant | VActionListVariant | "card" | — |
size | VActionListSize | "md" | — |
dividers | boolean | true | Hairline between sections. |
ariaLabel | string | — | — |
dataTestId | string | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@select | item: VActionListItem, section: VActionListSection | — |
@section-action | sectionId: string | — |
Slots
| Slot | Props do slot |
|---|---|
#label | item |
#[`trailing-${item.value}`] | item |
#[`section-${section.id}`] | section |
Fonte: src/components/navigation/VActionList/VActionList.vue · tipos: src/components/navigation/VActionList/VActionList.types.ts