Skip to content

ButtonGroup ​

Agrupa botones TUI horizontalmente con gap y estilos consistentes.

ButtonGroup

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

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

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

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

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

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

TipoPor defectoRequerido
Array<{label, icon?, onClick, fill?, color?, disabled?}>—✅

Cada botón tiene esta forma:

CampoTipoRequeridoDescripción
labelstring✅Texto del botón
iconstring❌Icono o emoji
onClick(e: MouseEvent) => void✅Callback al hacer clic
fillFill❌Estilo de relleno
colorColor❌Color semántico
disabledboolean❌Deshabilita este botón

fill ​

Fill global para todos los botones. Puede sobrescribirse por ítem.

TipoPor defectoRequerido
'solid' | 'outline' | 'clear''solid'❌

color ​

Color global para todos los botones. Puede sobrescribirse por ítem.

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

gap ​

Espaciado entre botones (en rem).

TipoPor defectoRequerido
number0.4❌

disabled ​

Deshabilita todos los botones del grupo. Cada ítem puede además definir su propio disabled, que se combina con el del grupo.

TipoPor defectoRequerido
booleanfalse❌

design ​

Línea de diseño (o hereda de data-design), se propaga a cada botón del grupo.

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

CSS Custom Properties ​

TokenPor defectoDescripción

Ver Theming para la convención completa.