ButtonGroup
Organize ações relacionadas e compartilhe tamanho, tom, variante e estado entre os botões.
Uso básico
Dê um nome ao grupo com aria-label ou aria-labelledby. Cada botão continua acessível com Tab e pode definir seu próprio size, variant ou tone.
Disposição
Use attached para unir os botões. O grupo unido fica na mesma linha, então prefira rótulos curtos. Sem attached, um grupo horizontal quebra a linha quando necessário.
Orientação vertical
Use orientation="vertical" para empilhar as ações. align posiciona o grupo no eixo principal. Com fullWidth, o grupo preenche o espaço disponível e distribui a largura entre os botões filhos diretos.
Estados
Defina disabled no grupo para bloquear todos os botões, inclusive os que têm propriedades próprias. Use o controle abaixo para experimentar.
API
ButtonGroup aceita atributos nativos de div. Use botões como filhos diretos para unir bordas ou distribuir larguras. Cada botão mantém sua própria ação.
| Propriedade | Valores e comportamento | Padrão |
|---|---|---|
orientation | horizontal, vertical | horizontal |
align | start, center, end | start |
attached | boolean | false |
fullWidth | boolean | false |
variant | solid, outline, soft, ghost, link | solid |
tone | primary, neutral, info, success, warning, danger | primary |
size | xs, sm, md, lg | md |
disabled | boolean | false |
aria-label / aria-labelledby | string | — |