Seleção e menus
VColorPicker
Seleção de cor para temas, branding e ferramentas criativas com popover, paletas, HEX e alpha.
<script setup lang="ts">
import { VColorPicker } from 'vueui-nova-kit'
</script>Uso
<script setup lang="ts">
</script>
<template>
</template>Playground
Os controles abaixo são gerados a partir das props declaradas em VColorPicker.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. Props: variant="popover", showAlpha=true.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VColorPicker } from 'vueui-nova-kit'
const value = ref('#6366F1')
</script>
<template>
<VColorPicker v-model="value" show-alpha />
</template>Variants
Variação Variantes. Interativo: o estado é mantido na própria story (v-model).
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VColorPicker } from 'vueui-nova-kit'
const color = ref('#6366F1')
const presets = [
'#6366F1',
'#8B5CF6',
'#EC4899',
'#F97316',
'#22C55E',
'#94A3B8'
]
</script>
<template>
<div style="display:flex;flex-direction:column;gap:24px;">
<VColorPicker v-model="color" variant="popover" :show-alpha="true" />
<VColorPicker v-model="color" variant="inline" />
<VColorPicker v-model="color" variant="hex" />
<VColorPicker v-model="color" variant="opacity" :show-alpha="true" />
<VColorPicker v-model="color" variant="preset" :presets="presets" />
</div>
</template>Sizes
Variação Tamanhos. Interativo: o estado é mantido na própria story (v-model).
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VColorPicker } from 'vueui-nova-kit'
const color = ref('#6366F1')
</script>
<template>
<div style="display:flex;gap:16px;align-items:center;">
<VColorPicker v-model="color" size="sm" />
<VColorPicker v-model="color" size="md" />
<VColorPicker v-model="color" size="lg" />
</div>
</template>Disabled
Variação Desabilitado. Props: disabled=true.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VColorPicker } from 'vueui-nova-kit'
const value = ref('#6366F1')
</script>
<template>
<VColorPicker v-model="value" disabled />
</template>Recent Colors
Variação Recent Colors. Props: variant="popover", label="Cor".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VColorPicker } from 'vueui-nova-kit'
const value = ref('#6366F1')
const recentColors = ['#ef4444', '#f59e0b', '#10b981', '#3b82f6']
</script>
<template>
<VColorPicker v-model="value" :recent-colors="recentColors" label="Cor" />
</template>Inline Swatches
Variação Inline Swatches. Props: variant="inline", label="Cor".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VColorPicker } from 'vueui-nova-kit'
const value = ref('#6366F1')
const inlineSwatches = ['#ef4444', '#f59e0b', '#10b981', '#3b82f6', '#8b5cf6']
</script>
<template>
<VColorPicker
v-model="value"
variant="inline"
:inline-swatches="inlineSwatches"
label="Cor" />
</template>Acessibilidade
- Full keyboard navigation (Tab, Arrow keys) — todo o fluxo operável por teclado; setas movem handles, Enter confirma, Esc fecha.
- Proper labels for color channels (HEX, RGB) — cada canal/campo com
<label>associado e nome acessível. - Announces selected color to screen readers — valor HEX/RGB anunciado via
aria-livea cada mudança. - Maintains sufficient contrast in UI contexts —
✓/texto sobre swatches garante contraste mínimo (anel/overlay quando a cor é clara). - Supports high contrast mode — bordas/indicadores visíveis em forced-colors.
- Clear focus indicators — anel de foco accent em trigger, sliders e swatches via
:focus-visible. - ARIA compliant and semantic structure — papéis
dialog/slider/listbox/optioncomaria-valuenow/min/max/textconforme APG.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
modelValue | string | "#6366F1" | — |
variant | VColorPickerVariant | "popover" | — |
size | VColorPickerSize | "md" | — |
disabled | boolean | false | — |
showAlpha | boolean | false | — |
presets | string[] | — | — |
recentColors | string[] | — | — |
label | string | — | — |
inlineSwatches | string[] | — | — |
selected | boolean | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: string | — |
@change | value: string | — |
@open-change | value: boolean | — |
Slots
Sem slots.
Fonte: src/components/form/VColorPicker/VColorPicker.vue · tipos: src/components/form/VColorPicker/VColorPicker.types.ts