Seleção e menus

VColorPicker

Componentev-model6 exemplos10 propsA2UI · ColorPicker

Seleção de cor para temas, branding e ferramentas criativas com popover, paletas, HEX e alpha.

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

Uso

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

  1. Full keyboard navigation (Tab, Arrow keys) — todo o fluxo operável por teclado; setas movem handles, Enter confirma, Esc fecha.
  2. Proper labels for color channels (HEX, RGB) — cada canal/campo com <label> associado e nome acessível.
  3. Announces selected color to screen readers — valor HEX/RGB anunciado via aria-live a cada mudança.
  4. Maintains sufficient contrast in UI contexts — ✓/texto sobre swatches garante contraste mínimo (anel/overlay quando a cor é clara).
  5. Supports high contrast mode — bordas/indicadores visíveis em forced-colors.
  6. Clear focus indicators — anel de foco accent em trigger, sliders e swatches via :focus-visible.
  7. ARIA compliant and semantic structure — papéis dialog/slider/listbox/option com aria-valuenow/min/max/text conforme APG.

Props

PropTipoDefaultDescrição
modelValuestring"#6366F1"—
variantVColorPickerVariant"popover"—
sizeVColorPickerSize"md"—
disabledbooleanfalse—
showAlphabooleanfalse—
presetsstring[]——
recentColorsstring[]——
labelstring——
inlineSwatchesstring[]——
selectedboolean——

Events

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

Slots

Sem slots.

Fonte: src/components/form/VColorPicker/VColorPicker.vue · tipos: src/components/form/VColorPicker/VColorPicker.types.ts