Guia · Fundamentos
Customização de estilo
Toda a aparência da lib sai de tokens CSS --v-*. Sobrescreva-os no :root (ou em qualquer elemento) para mudar cores, raios, espaçamento, tipografia e motion, sem tocar nos componentes.
Experimente ao vivo
Os controles abaixo mudam tokens apenas dentro da caixa de exemplo. Os novos valores derivam de outros tokens da paleta (--v-color-purple-base, --v-color-pink-base…).
/* valores padrão — nada a sobrescrever */Cores
A primária tem uma escala de --v-color-primary-50 a --v-color-primary-900 e três aliases semânticos: --v-color-primary (fundos de ação), --v-color-primary-hover e --v-color-primary-text (texto e links). Superfícies e texto usam --v-color-bg, --v-color-surface, --v-color-text, --v-color-text-muted e --v-color-border. Estados usam --v-color-success-*, --v-color-error-* e --v-color-info-*.
/* app.css — importe DEPOIS de 'vueui-nova-kit/style.css' */
:root {
/* escala da primária: 50 (mais clara) → 900 (mais escura) */
--v-color-primary-500: var(--v-color-purple-base);
--v-color-primary-600: color-mix(in srgb, var(--v-color-purple-base) 86%, black);
--v-color-primary-700: var(--v-color-purple-dark);
/* aliases semânticos usados pelos componentes */
--v-color-primary: var(--v-color-primary-600);
--v-color-primary-hover: var(--v-color-primary-700);
--v-color-primary-text: var(--v-color-primary-600);
}
/* no escuro, ajuste só o que precisa de mais contraste */
[data-theme='dark'] {
--v-color-primary-text: color-mix(in srgb, var(--v-color-purple-base) 60%, white);
} Tokens de componente (como --v-button-radius) são declarados no :root com base nos tokens globais. Ao sobrescrever num elemento interno, sobrescreva também o token do componente, como faz o exemplo acima.
Raios
:root {
/* escala: --v-radius-0 | 4 | 8 | 12 | 16 | 24 | pill | full | circle */
--v-radius-sm: var(--v-radius-4);
--v-radius-md: var(--v-radius-8);
--v-radius-lg: var(--v-radius-12);
/* tokens por componente (resolvidos no :root — sobrescreva também) */
--v-button-radius: var(--v-radius-pill);
--v-card-radius: var(--v-radius-24);
}Espaçamento
:root {
/* escala de espaçamento: 0 | 1 | 2 | 3 | 4 | 6 | 8 | 12 | 16 | 24 (×4px) */
--v-space-2: 6px;
--v-space-3: 10px;
--v-space-4: 14px;
}Tipografia
:root {
--v-font-family-sans: 'Geist', system-ui, sans-serif;
--v-font-family-mono: 'JetBrains Mono', ui-monospace, monospace;
/* tamanhos: caption, text-small | medium | large, h1–h5, display-1 | 2 */
--v-font-size-text-medium: 15px;
--v-font-weight-medium: 550;
}Motion
Durações e curvas também são tokens. Componentes com animação aceitam a prop motion (default, expressive ou none).
:root {
/* durações */
--v-motion-fast: 0.1s; /* hover, foco */
--v-motion-normal: 0.16s; /* transições padrão */
--v-motion-slow: 0.3s; /* painéis, overlays */
--v-motion-emphasis: 0.42s; /* entradas destacadas */
--v-motion-press: 80ms; /* feedback de clique */
/* curvas */
--v-ease-standard: cubic-bezier(0.2, 0, 0, 1);
--v-ease-out: cubic-bezier(0, 0, 0.2, 1);
--v-ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
}Tokens em runtime
Para editores de tema ou preferências do usuário, use os helpers exportados pela entrada principal:
import { setToken, resetTokens, listTokens } from 'vueui-nova-kit'
setToken('--v-color-primary-500', 'var(--v-color-pink-base)') // aplica no <html>
listTokens() // [{ name: '--v-color-bg', value: '...' }, ...]
resetTokens() // desfaz tudo que foi alterado via setTokenMovimento reduzido
Quando o sistema operacional pede prefers-reduced-motion: reduce, a lib zera os tokens de duração (--v-motion-* passa a 0ms) e desliga as animações de entrada. Este site faz o mesmo com suas próprias animações.
<script setup lang="ts">
import { useReducedMotion, VButton } from 'vueui-nova-kit'
const reduced = useReducedMotion() // Ref<boolean>, reage à preferência do SO
</script>
<template>
<!-- todo componente animado aceita motion="default" | "expressive" | "none" -->
<VButton :motion="reduced ? 'none' : 'expressive'">Salvar</VButton>
</template>