MarsalaDS

Buscar

Páginas e componentes da documentação

Toggle Group

Uso

Grupo de toggles para filtros segmentados, toolbars e escolha entre poucas opções visíveis ao mesmo tempo.

Quando usar

  • Filtros de categoria (como em Blocos) com variant outline, size sm e espaçamento entre itens.
  • Barra de formatação com vários toggles e aria-label quando só há ícone.
  • Seleção única com value controlado; use toggleMultiple para várias opções ativas.

Evite quando

  • Não use para navegação entre páginas — Tabs ou links.
  • Evite muitas opções em linha — considere Select ou menu.

Instalação

Com o namespace @youxgroup configurado em components.json (veja Instalação).

pnpm dlx shadcn@latest add @youxgroup/toggle-group

Exemplos

Variações comuns de uso.

Filtro segmentado

Barra de formatação

Vertical

Marsala Design System