Navegar componentes
← Componentes

ToggleButtonGroup

MiscExemplo
Agrupa toggle buttons para comportamento exclusivo (single) ou multi-seleção. Usa discriminated union em type para value/onChange type-safe.
Importação
import {ToggleButtonGroup} from '@pharos-ds/core/ToggleButtonGroup';

Exemplos

Área interativa

type
orientation
size
Código
import {ToggleButtonGroup} from '@pharos-ds/core/ToggleButton';

<ToggleButtonGroup
  type="single"
  orientation="horizontal"
  size="md"
 />

Props

PropTipoPadrãoDescrição
children *ReactNodeFilhos ToggleButton.
label *stringRótulo acessível do grupo (aria-label).
type'single' | 'multiple''single'Modo de seleção. Single permite um botão ativo, multiple permite vários.
value *string | null | string[]Valor(es) atualmente selecionado(s). O tipo depende do modo de seleção.
onChange *(value: string | null | string[]) => voidChamado quando a seleção muda.
orientation'horizontal' | 'vertical''horizontal'Direção de layout do grupo de botões.
size'sm' | 'md' | 'lg''md'Tamanho padrão dos botões no grupo. Botões individuais podem substituir.
isDisabledbooleanfalseSe todos os botões do grupo estão desabilitados.
xstyleStyleXStylesEstilos StyleX para personalização de layout (margens, posicionamento, dimensionamento). Deve ser um valor stylex.create().
data-testidstringSeletor de teste para frameworks de testes automatizados.
Pacote: @pharos-ds/core · Import: @pharos-ds/core/ToggleButtonGroup
ToggleButtonGroup · Pharos