ButtonGroup
Agrupa botones TUI horizontalmente con gap y estilos consistentes.
ButtonGroup
Líneas de diseño
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 <ButtonGroup fill="solid" color="primary" :buttons="[{ label: 'A', onClick: () => {} }, { label: 'B', onClick: () => {} }]" design="tuix" />8 </TabPanel>9 <TabPanel value="rubik">10 <ButtonGroup fill="solid" color="primary" :buttons="[{ label: 'A', onClick: () => {} }, { label: 'B', onClick: () => {} }]" design="rubik" />11 </TabPanel>12</Tabs>Demo
Grupo (buttons)
Uso mínimo: se pasa buttons y el grupo renderiza un botón por ítem.
1<ButtonGroup fill="solid" color="secondary" :buttons="[2 { icon: '↖', label: 'Izquierda', onClick: () => {} },3 { icon: '⬆', label: 'Centro', onClick: () => {} },4 { icon: '↗', label: 'Derecha', onClick: () => {} },5]" />67<ButtonGroup fill="outline" color="primary" :gap="0.8" :buttons="[8 { icon: '✕', label: 'Cancelar', onClick: () => {} },9 { icon: '✓', label: 'Aceptar', onClick: () => {} },10]" />Fill (fill)
fill solid y outline aplicados a todo el grupo.
1<ButtonGroup fill="solid" color="primary" :buttons="[2 { label: 'A', onClick: () => {} },3 { label: 'B', onClick: () => {} },4]" />5<ButtonGroup fill="outline" color="primary" :buttons="[6 { label: 'A', onClick: () => {} },7 { label: 'B', onClick: () => {} },8]" />Color (color)
El color del grupo aplicado a todos los botones.
1<ButtonGroup fill="solid" color="success" :buttons="[2 { label: 'A', onClick: () => {} },3 { label: 'B', onClick: () => {} },4]" />Separación (gap)
Dos valores de gap que muestran la separación entre botones.
1<ButtonGroup fill="solid" color="primary" :gap="0.2" :buttons="[2 { label: 'A', onClick: () => {} },3 { label: 'B', onClick: () => {} },4 { label: 'C', onClick: () => {} },5]" />6<ButtonGroup fill="solid" color="primary" :gap="1" :buttons="[7 { label: 'A', onClick: () => {} },8 { label: 'B', onClick: () => {} },9 { label: 'C', onClick: () => {} },10]" />Deshabilitado (disabled)
El grupo entero deshabilitado, más un ítem deshabilitado suelto.
1<ButtonGroup :disabled="true" fill="solid" color="primary" :buttons="[2 { label: 'A', onClick: () => {} },3 { label: 'B', onClick: () => {} },4]" />56<ButtonGroup fill="solid" color="primary" :buttons="[7 { label: 'Habilitado', onClick: () => {} },8 { label: 'Ítem deshabilitado', onClick: () => {}, disabled: true },9]" />Props
buttons
Array de botones.
| Tipo | Por defecto | Requerido |
|---|---|---|
Array<{label, icon?, onClick, fill?, color?, disabled?}> | — | ✅ |
Cada botón tiene esta forma:
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
label | string | ✅ | Texto del botón |
icon | string | ❌ | Icono o emoji |
onClick | (e: MouseEvent) => void | ✅ | Callback al hacer clic |
fill | Fill | ❌ | Estilo de relleno |
color | Color | ❌ | Color semántico |
disabled | boolean | ❌ | Deshabilita este botón |
fill
Fill global para todos los botones. Puede sobrescribirse por ítem.
| Tipo | Por defecto | Requerido |
|---|---|---|
'solid' | 'outline' | 'clear' | 'solid' | ❌ |
color
Color global para todos los botones. Puede sobrescribirse por ítem.
| Tipo | Por defecto | Requerido |
|---|---|---|
'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger' | 'light' | 'medium' | 'dark' | 'primary' | ❌ |
gap
Espaciado entre botones (en rem).
| Tipo | Por defecto | Requerido |
|---|---|---|
number | 0.4 | ❌ |
disabled
Deshabilita todos los botones del grupo. Cada ítem puede además definir su propio disabled, que se combina con el del grupo.
| Tipo | Por defecto | Requerido |
|---|---|---|
boolean | false | ❌ |
design
Línea de diseño (o hereda de data-design), se propaga a cada botón del grupo.
| Tipo | Por defecto | Requerido |
|---|---|---|
'tuix' | 'rubik' | — (hereda de data-design) | ❌ |
CSS Custom Properties
| Token | Por defecto | Descripción |
|---|
Ver Theming para la convención completa.