Skip to content

Menu ​

Menú vertical estilo terminal con items, divisores, deshabilitados y slot personalizado.

Menu

Líneas de diseño ​

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    <Menu :items="items" :active-index="0" design="tuix" />8  </TabPanel>9  <TabPanel value="rubik">10    <Menu :items="items" :active-index="0" design="rubik" />11  </TabPanel>12</Tabs>

Demo ​

Items (items) ​

Array de objetos con label, icon, disabled, divider.

vue
1<Menu :items="[2  { label: 'Nuevo archivo', icon: '+' },3  { label: 'Abrir archivo...', icon: '↗' },4  { label: 'Guardar', disabled: true },5  { label: '', divider: true },6  { label: 'Preferencias' },7]" :active-index="0" />

Índice activo (activeIndex) ​

Resalta un item con el marcador >.

vue
1<Menu :items="[{ label: 'Uno' }, { label: 'Dos' }, { label: 'Tres' }]" :activeIndex="0" />2<Menu :items="[{ label: 'Uno' }, { label: 'Dos' }, { label: 'Tres' }]" :activeIndex="1" />3<Menu :items="[{ label: 'Uno' }, { label: 'Dos' }, { label: 'Tres' }]" :activeIndex="2" />

Color (color) ​

Color del item activo.

vue
1<Menu :items="[{ label: 'Primary' }, { label: 'Item 2' }]" color="primary" :activeIndex="0" />2<Menu :items="[{ label: 'Success' }, { label: 'Item 2' }]" color="success" :activeIndex="0" />3<Menu :items="[{ label: 'Danger' }, { label: 'Item 2' }]" color="danger" :activeIndex="0" />

Divider y disabled ​

Separadores visuales e items no interactivos.

vue
1<Menu2  :items="[3    { label: 'Nuevo archivo' },4    { label: 'Abrir archivo', icon: '>' },5    { label: 'Guardar', disabled: true },6    { label: '', divider: true },7    { label: 'Preferencias' },8    { label: '', divider: true },9    { label: 'Salir' },10  ]"11  :activeIndex="0"12/>

API ​

PropTipoPor defectoDescripción
itemsArray<{label, icon?, disabled?, divider?}>[]Items del menú
color'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger' | 'light' | 'medium' | 'dark''primary'Color del item activo
activeIndexnumber-1Índice del item resaltado
design'tuix' | 'rubik'— (hereda de data-design)Línea de diseño (o hereda de data-design).

items — cada ítem tiene esta forma:

CampoTipoRequeridoDescripción
labelstring✅Texto del item
iconstring❌Icono o emoji opcional
disabledboolean❌Item deshabilitado
dividerboolean❌Línea separadora

Eventos ​

EventoPayloadDescripción
selectindex: numberSe emite al hacer clic en un item

Slots ​

SlotPropsDescripción
default—Alternativa a items
item{ item, index, active }Renderizado personalizado por item

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.
--bgdesde el tema (--ctp-latte-base / --ctp-mocha-base)Fondo base de la superficie.
--bg-altdesde el tema (--ctp-latte-mantle / --ctp-mocha-mantle)Fondo alternativo (la capa por debajo del fondo base).
--bg-paneldesde el tema (--ctp-latte-surface1 / --ctp-mocha-surface1)Fondo de superficies tipo panel (cards, accordions).
--borderdesde el tema (--ctp-latte-surface0 / --ctp-mocha-surface0)Color de contorno y divisor de superficies.
--textdesde el tema (--ctp-latte-text / --ctp-mocha-text)Color de texto principal dentro del componente.
--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).

Ver Theming para la convención completa.