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`.
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 / grupo | Valores |
|---|---|
props | open · onToggle · labelOpen · labelClosed |
a11y | aria-expanded · aria-label dinâmico (Abrir/Fechar menu) |