Toggle
Toggle switch estilo terminal con [ON] / [OFF].
Toggle
Líneas de diseño
[ON]
vue
1<Tabs defaultValue="tuix">2 <TabsList>3 <Tab value="tuix">TUIX</Tab>4 <Tab value="rubik">Rubik</Tab>5 </TabsList>6 <TabPanel value="tuix">7 <Toggle :model-value="true" design="tuix" />8 </TabPanel>9 <TabPanel value="rubik">10 <Toggle :model-value="true" design="rubik" />11 </TabPanel>12</Tabs>Demo
Básico (modelValue)
Vincula el estado del toggle con v-model mediante modelValue.
vue
1<Toggle v-model="enabled" />2<Toggle v-model="custom" :labels="{ on: 'SI', off: 'NO' }" color="success" />Color (color)
Cada toggle está activo con estado propio para que el color se vea.
vue
1<script setup lang="ts">2import { ref } from 'vue'3import { Toggle } from '@dowardev/herdrate-vue'45const colorOnPrimary = ref(true)6const colorOnSuccess = ref(true)7const colorOnWarning = ref(true)8const colorOnDanger = ref(true)9</script>1011<template>12 <Toggle v-model="colorOnPrimary" color="primary" />13 <Toggle v-model="colorOnSuccess" color="success" />14 <Toggle v-model="colorOnWarning" color="warning" />15 <Toggle v-model="colorOnDanger" color="danger" />16</template>Props
modelValue
Estado del toggle (v-model booleano).
| Tipo | Por defecto | Requerido |
|---|---|---|
boolean | false | ❌ |
color
Color del texto cuando está activo.
| Tipo | Por defecto | Requerido |
|---|---|---|
'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger' | 'light' | 'medium' | 'dark' | 'primary' | ❌ |
disabled
Deshabilita la interacción.
| Tipo | Por defecto | Requerido |
|---|---|---|
boolean | false | ❌ |
labels
Texto personalizado para los estados on/off.
| Tipo | Por defecto | Requerido |
|---|---|---|
{on: string, off: string} | { on: 'ON', off: 'OFF' } | ❌ |
El objeto labels tiene esta forma:
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
on | string | ✅ | Texto estado ON |
off | string | ✅ | Texto estado OFF |
design
Línea de diseño (o hereda de data-design).
| Tipo | Por defecto | Requerido |
|---|---|---|
'tuix' | 'rubik' | — (hereda de data-design) | ❌ |
Eventos
| Evento | Payload | Descripción |
|---|---|---|
update:modelValue | boolean | Se emite al hacer toggle |
CSS Custom Properties
| Token | Por defecto | Descripción |
|---|---|---|
--font-mono | "JetBrains Mono", ui-monospace, monospace | Stack monoespaciado para contenido tipo código (etiquetas, logs, chips). |
--accent | desde el tema (--ctp-latte-mauve / --ctp-mocha-mauve) | Color de acento, mapeado desde el color semántico activo. |
--text-muted | desde el tema (--ctp-latte-subtext1 / --ctp-mocha-subtext1) | Texto secundario para pistas, anotaciones y estado deshabilitado. |
--color-primary | desde el tema (--ctp-latte-mauve / --ctp-mocha-mauve) | Color semántico primario (mauve en Catppuccin). |
--color-secondary | desde el tema (--ctp-latte-lavender / --ctp-mocha-lavender) | Color semántico secundario (lavender en Catppuccin). |
--color-tertiary | desde el tema (--ctp-latte-blue / --ctp-mocha-blue) | Color semántico terciario (blue en Catppuccin). |
--color-success | desde el tema (--ctp-latte-green / --ctp-mocha-green) | Color semántico de éxito (green en Catppuccin). |
--color-warning | desde el tema (--ctp-latte-yellow / --ctp-mocha-yellow) | Color semántico de advertencia (yellow en Catppuccin). |
--color-danger | desde el tema (--ctp-latte-red / --ctp-mocha-red) | Color semántico de peligro (red en Catppuccin). |
--color-light | desde el tema (--ctp-latte-surface1 / --ctp-mocha-rosewater) | Color semántico claro (tono de contraste más claro). |
--color-medium | desde el tema (--ctp-latte-overlay0 / --ctp-mocha-overlay2) | Color semántico medio (tono intermedio). |
--color-dark | desde el tema (--ctp-latte-text / --ctp-mocha-subtext1) | Color semántico oscuro (texto de alto contraste). |
--cp-ease | cubic-bezier(.4, 0, .2, 1) | Curva de easing por defecto para transiciones. |
Ver Theming para la convención completa.