Gatilho da barra lateral

`SidebarToggleButton`: botão controlado (`open` + `onToggle`) para colapsar/expandir uma sidebar cujo estado vive no seu layout (ex.: Header). Alterna entre ícones PanelLeftOpen e PanelLeftClose. Dentro de `SidebarProvider`, use `SidebarTrigger` (ver Barra lateral), que não recebe `open`/`onToggle`. No código: sidebar-trigger — src/components/sidebar-trigger.tsx · Navegação

Quando usar

Em layouts com sidebar colapsável, onde a pessoa precisa controlar a visibilidade do menu lateral. Também em cabeçalhos ou barras de ferramentas que alternam a sidebar em dispositivos móveis.

Quando não usar

Quando a sidebar não pode ser colapsada (fixa sempre visível). Para navegação entre seções sem sidebar, use NavigationMenu ou Tabs.

Acessibilidade

  • aria-expanded reflete o estado — leitores anunciam "menu expandido"/"menu recolhido".
  • Rótulo acessível muda entre "Fechar menu"/"Abrir menu" (labelOpen/labelClosed).
  • Ícone decorativo (aria-hidden); a informação está no rótulo e no aria-expanded.
  • Recebe foco visível por padrão (herda do IconButton).

open controla o ícone; onToggle é chamado ao clicar.

Preview

Variantes e composição

Prop / grupoValores
propsopen · onToggle · labelOpen · labelClosed
a11yaria-expanded · aria-label dinâmico (Abrir/Fechar menu)

Uso

Fonte do componente