Subheader

A faixa de controle no topo da index e do documento — CTA "Novo X", ButtonBar, busca, gráfico e view switcher. Três variantes.

Bloco EletroDS — Subheader, usado no código como <MeSubheader>. No Figma, use o bloco da Library; é a casca canônica do topo de uma tela. Não remonte CTA + ações + busca à mão.

O Subheader é a faixa de controle logo abaixo do header global. Ele monta numa peça só o que antes seriam vários elementos soltos: o toggle de sidebar, a ação primária ("Novo X", split com menu), a ButtonBar ao centro, a busca, o toggle de gráfico e o view switcher. É o ponto onde mora a hierarquia de ações de uma index.

Uso em tela

Três regiões — esquerda · centro · direita. A esquerda traz o toggle de sidebar e a ação primária; o centro, a ButtonBar; a direita, busca, gráfico e a troca de visualização. Como tudo vem do bloco, a posição e o espaçamento já saem padronizados — você passa props, não recria layout.

A ação primária ("Novo X") fica sempre à esquerda e usa o split quando há mais de um tipo a criar (ex.: "Nova transação ▾"). As ações secundárias vão na ButtonBar; as de tela (busca, gráfico, view) ficam à direita.

Aplicação

A variante muda conforme a tela:

TelaVarianteO que mostra
Index (listagem)primarytoggle sidebar · split "Novo X" · ButtonBar · busca · gráfico · view switcher
Documento / formuláriosecondaryButtonBar ao centro · Voltar e Confirmar à direita
Toolbar embutida (dentro de um bloco)tertiarysó a ButtonBar — ignora CTA/busca/etc.

Variantes

Quero…Use
Topo de uma indexvariant="primary"
Topo de um documento/edição com Voltar + Confirmarvariant="secondary" (props back, confirm)
Só uma fileira de ações, sem CTAvariant="tertiary"

Regiões (variante primary)

RegiãoPropO que é
Toggle de sidebartoggleSidebarhambúrguer que abre/fecha a sidebar
Ação primáriacreateActionsbotão "Novo X" + menu de tipos (split)
Ações de suportebuttonBara ButtonBar central
Buscasearchcampo de busca da listagem
GráficotoggleChartalterna a visão de gráfico (com chip de notificação)
View switchergridModetroca Tabela · Lista · Cards · Preview

Subheader de documento

No documento o subheader tem regiões fixas: à esquerda, as ações do status (até 3 aparentes + "Mais ações" no overflow); à direita, "Opções" (configurações da tela). As ações mudam conforme o status/fase — ver Ações por status. Quando o documento aparece em preview (master-detail da index), surge um ícone "abrir em outra janela" à direita de "Opções" — atalho para a página única.

Responsividade

Segue a régua geral em Foundations › Breakpoints; o que é próprio do subheader:

LarguraComportamento
Desktop · ≥ 1024pxLayout completo — título, todas as CTAs e ações secundárias visíveis.
Tablet · 640–1024pxTítulo + CTA primária + no máximo 1 secundária; as demais recolhem em "Mais ações".
Mobile · < 640pxNo mobile o subheader perde o hambúrguer (vai pro header), o "Novo X" (vira FAB) e a busca (vai pro header) — sobram só as ações em massa + gráfico/view. As secundárias colapsam em "Mais ações" (nunca rolam na horizontal nem quebram em linhas).

Overflow das ações (ResizeObserver)

O MeSubheader observa a largura da ButtonBar (ResizeObserver): as ações que não cabem colapsam progressivamente num "Mais ações" (ícone + label + chevron). Nunca scroll horizontal, nunca quebra de linha. Ordene por frequência de uso; separe a ação destrutiva por um divisor. Não empilhe além de ~3 ações + "Mais ações", senão o centro abre gaps.

Gotchas de montagem (verificados na index real)

  • Altura 56px (h-14). O MeSubheader é flush → dê w-full h-full + wrapper items-stretch, senão o gap vira linha dupla na borda inferior.
  • inheritAttrs: false: a class/style que você passa vão pro inner, não pro root — para esticar o root, estilize o wrapper.
  • Busca é gatilho: abre o painel de busca, não busca inline no campo.

No código

<MeSubheader> é um bloco EletroDS. Props, eventos e tipos completos — para quem for implementar — ficam no doc técnico: eletro.design/blocks/subheader. Aqui o foco é o uso em Design.

Acessibilidade

O toggle de sidebar e os botões só-ícone (gráfico, view) precisam de rótulo acessível. A ação primária split deve abrir o menu por teclado. Garanta ordem de foco coerente com a leitura (esquerda → centro → direita).

Onde se aplica