Ações

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.

PropriedadeValores e comportamentoPadrão
orientationhorizontal, verticalhorizontal
alignstart, center, endstart
attachedbooleanfalse
fullWidthbooleanfalse
variantsolid, outline, soft, ghost, linksolid
toneprimary, neutral, info, success, warning, dangerprimary
sizexs, sm, md, lgmd
disabledbooleanfalse
aria-label / aria-labelledbystring—