Superfícies

VInspectorPanel

Componentev-model11 exemplos14 props

Painel lateral flexível para inspecionar e editar conteúdo, propriedades e definições do item selecionado. Organiza controlos com abas e secções colapsáveis.

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

Uso

Exemplo
<VInspectorPanel v-model:open="showInspector" title="Inspector">
  <template #general>
    <!-- campos da secção General -->
  </template>
</VInspectorPanel>

Playground

Os controles abaixo são gerados a partir das props declaradas em VInspectorPanel.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 { VInspectorPanel } from 'vueui-nova-kit'
</script>

<template>
  <VInspectorPanel v-model="value" open />
</template>

Minimal

Variação Minimal. Props: variant="minimal".

Ver código
vue
<script setup lang="ts">
import { VInspectorPanel } from 'vueui-nova-kit'
</script>

<template>
  <VInspectorPanel v-model="value" variant="minimal" open />
</template>

Tabs

Variação Tabs. Props: variant="tabs".

Ver código
vue
<script setup lang="ts">
import { VInspectorPanel } from 'vueui-nova-kit'
</script>

<template>
  <VInspectorPanel v-model="value" variant="tabs" open />
</template>

Floating

Variação Flutuante. Props: variant="floating".

Ver código
vue
<script setup lang="ts">
import { VInspectorPanel } from 'vueui-nova-kit'
</script>

<template>
  <VInspectorPanel v-model="value" variant="floating" open />
</template>

Sizes

Variação Tamanhos.

Ver código
vue
<script setup lang="ts">
import { VInspectorPanel } from 'vueui-nova-kit'

const args = {
  size: 'default',
  variant: 'default',
  title: 'Inspector',
  open: true
}
</script>

<template>
  <div style="display: grid; gap: 16px; justify-items: end;">
    <VInspectorPanel v-bind="args" size="compact" title="Compact — 320px" />
    <VInspectorPanel v-bind="args" size="default" title="Default — 360px" />
    <VInspectorPanel v-bind="args" size="wide" title="Wide — 440px" />
  </div>
</template>

Collapsed

Variação Recolhido.

Ver código
vue
<script setup lang="ts">
import { VInspectorPanel } from 'vueui-nova-kit'

const expandedSections = []
</script>

<template>
  <VInspectorPanel
    v-model="value"
    open
    :expanded-sections="expandedSections" />
</template>

Disabled

Variação Desabilitado. Props: disabled=true.

Ver código
vue
<script setup lang="ts">
import { VInspectorPanel } from 'vueui-nova-kit'
</script>

<template>
  <VInspectorPanel v-model="value" open disabled />
</template>

Loading

Variação Carregando. Props: loading=true.

Ver código
vue
<script setup lang="ts">
import { VInspectorPanel } from 'vueui-nova-kit'
</script>

<template>
  <VInspectorPanel v-model="value" open loading />
</template>

Closed

Variação Fechado. Props: open=false. O play abre o painel pelo botão de demonstração.

Ver código
vue
<script setup lang="ts">
import { VInspectorPanel } from 'vueui-nova-kit'
</script>

<template>
  <VInspectorPanel v-model="value" :open="false" />
</template>

No Close Button

Variação Sem Close Button. Props: showClose=false.

Ver código
vue
<script setup lang="ts">
import { VInspectorPanel } from 'vueui-nova-kit'
</script>

<template>
  <VInspectorPanel v-model="value" open :show-close="false" />
</template>

Not Dismissible

Variação Not Dismissible. Props: dismissible=false.

Ver código
vue
<script setup lang="ts">
import { VInspectorPanel } from 'vueui-nova-kit'
</script>

<template>
  <VInspectorPanel v-model="value" open :dismissible="false" />
</template>

Acessibilidade

  • role="complementary" com aria-label ou aria-labelledby.
  • Navegação por teclado: Tab/Shift+Tab, setas nas tabs, Enter/Space nas secções.
  • Esc fecha o painel e devolve o foco ao elemento que o abriu.
  • Estados expostos via aria-selected, aria-expanded, aria-busy, aria-disabled.
  • Foco visível em todos os controlos interativos.

Estados

Default · Hover row · Focus field · Collapsed group · Loading · Disabled

Motion

TriggerPropertyDurationEasing
Slide in/outtransform, opacity300ms / 100msease-out
Tab switchcolor, underline100msease-out
Section collapseopacity160msease-out

Respeitar prefers-reduced-motion.

Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.

Props

PropTipoDefaultDescrição
openbooleanundefinedControls visibility. `v-model:open` (primary) — `modelValue` accepted as alias.
modelValuebooleanundefined—
titlestring"Inspector"—
tabsVInspectorPanelTab[]——
activeTabstring——
sectionsVInspectorPanelSection[]——
expandedSectionsstring[]——
sizeVInspectorPanelSize"default"—
variantVInspectorPanelVariant"default"—
showClosebooleantrue—
dismissiblebooleantrueEscape closes the panel and returns focus to the opener.
disabledbooleanfalse—
loadingbooleanfalse—
ariaLabelstring——

Events

EventoPayloadDescrição
@update:openvalue: boolean—
@update:modelValuevalue: boolean—
@update:activeTabvalue: string—
@update:expandedSectionsvalue: string[]—
@open-changevalue: boolean—
@tab-changevalue: string—
@section-togglevalue: string, expanded: boolean—
@close——
@dismiss——

Slots

SlotProps do slot
#header—
#actions—
#[vm.activeTab.value]—
#[section.value]section
#default—

Fonte: src/components/containment/VInspectorPanel/VInspectorPanel.vue · tipos: src/components/containment/VInspectorPanel/VInspectorPanel.types.ts