Skip to content

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).

TipoPor defectoRequerido
booleanfalse❌

color ​

Color del texto cuando está activo.

TipoPor defectoRequerido
'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger' | 'light' | 'medium' | 'dark''primary'❌

disabled ​

Deshabilita la interacción.

TipoPor defectoRequerido
booleanfalse❌

labels ​

Texto personalizado para los estados on/off.

TipoPor defectoRequerido
{on: string, off: string}{ on: 'ON', off: 'OFF' }❌

El objeto labels tiene esta forma:

CampoTipoRequeridoDescripción
onstring✅Texto estado ON
offstring✅Texto estado OFF

design ​

Línea de diseño (o hereda de data-design).

TipoPor defectoRequerido
'tuix' | 'rubik'— (hereda de data-design)❌

Eventos ​

EventoPayloadDescripción
update:modelValuebooleanSe emite al hacer toggle

CSS Custom Properties ​

TokenPor defectoDescripción
--font-mono"JetBrains Mono", ui-monospace, monospaceStack monoespaciado para contenido tipo código (etiquetas, logs, chips).
--accentdesde el tema (--ctp-latte-mauve / --ctp-mocha-mauve)Color de acento, mapeado desde el color semántico activo.
--text-muteddesde el tema (--ctp-latte-subtext1 / --ctp-mocha-subtext1)Texto secundario para pistas, anotaciones y estado deshabilitado.
--color-primarydesde el tema (--ctp-latte-mauve / --ctp-mocha-mauve)Color semántico primario (mauve en Catppuccin).
--color-secondarydesde el tema (--ctp-latte-lavender / --ctp-mocha-lavender)Color semántico secundario (lavender en Catppuccin).
--color-tertiarydesde el tema (--ctp-latte-blue / --ctp-mocha-blue)Color semántico terciario (blue en Catppuccin).
--color-successdesde el tema (--ctp-latte-green / --ctp-mocha-green)Color semántico de éxito (green en Catppuccin).
--color-warningdesde el tema (--ctp-latte-yellow / --ctp-mocha-yellow)Color semántico de advertencia (yellow en Catppuccin).
--color-dangerdesde el tema (--ctp-latte-red / --ctp-mocha-red)Color semántico de peligro (red en Catppuccin).
--color-lightdesde el tema (--ctp-latte-surface1 / --ctp-mocha-rosewater)Color semántico claro (tono de contraste más claro).
--color-mediumdesde el tema (--ctp-latte-overlay0 / --ctp-mocha-overlay2)Color semántico medio (tono intermedio).
--color-darkdesde el tema (--ctp-latte-text / --ctp-mocha-subtext1)Color semántico oscuro (texto de alto contraste).
--cp-easecubic-bezier(.4, 0, .2, 1)Curva de easing por defecto para transiciones.

Ver Theming para la convención completa.