Pular para o conteúdo
Navegação

Menubar

/componentes/menubar.mdmarkdown cru, para quem lê com agent em vez de olho

Principal

Importar
import { Menubar } from '@rivocode/ui'

Quando usar

A barra de menus de aplicativo: Arquivo, Editar, Exibir.

Coordena vários Menu lado a lado: com um aberto, passar o mouse sobre o vizinho já troca, sem novo clique, e as setas andam entre eles.

Em tela de web isso quase nunca é o certo. Barra de menus é vocabulário de programa de mesa; num painel, Sidebar e Tabs dizem mais. Ela existe para editor e ferramenta, onde o usuário já espera esse arranjo.

<Menubar aria-label="Principal">
  <Menu>
    <MenubarTrigger>Arquivo</MenubarTrigger>
    <MenuContent>
      <MenuItem>Novo documento</MenuItem>
      <MenuItem>Abrir</MenuItem>
    </MenuContent>
  </Menu>
</Menubar>

As partes

MenubarTrigger é o gatilho de cada menu da barra: "Arquivo", "Editar", "Exibir". Ele já vem vestido, inclusive com o anel de foco. Dentro da barra é ele que se usa, e não um MenuTrigger com classe na mão.

Quando não usar

Para navegar entre as telas de um sistema, use Sidebar; a navegação de topo de site, com painel por seção, é NavigationMenu. Os dois listam lugares, e a barra de menus lista ações de programa de mesa, que quase nenhum painel tem.

Um menu de ações solto, numa linha ou num botão de "mais", é Menu sozinho: a barra só se paga quando há vários menus lado a lado. E os controles de edição que andam pelas setas, sem abrir lista, são Toolbar.

No React Native

Não porta, por decisão - idioma de mesa; navegação nativa é tab bar e drawer do router. Não é fila: não vai existir. A tabela de paridade diz o porquê de cada uma.

API

PropTipoPadrão
disabled0.4.0

Se a barra de menus inteira está desabilitada.

booleanfalse
loopFocus0.4.0

Se o foco do teclado volta ao primeiro item ao chegar no fim da lista pelas setas.

booleantrue
modal0.4.0

Se a barra de menus é modal.

booleantrue
orientation0.4.0

A orientação da barra de menus.

MenuRootOrientation"horizontal"
render0.4.0

Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente.

ComponentRenderFn<HTMLProps, MenubarState> | ReactElement<unknown, string | JSXElementConstructor<any>>sem padrão

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

Partes

Menubar se monta com estas peças. Todas vivem nesta página, porque separar cada uma num endereço obrigaria a abrir seis abas para montar uma tela.

/menubar-trigger.md

O gatilho de um menu dentro da barra: "Arquivo", "Editar", "Exibir".

Já vem vestido: respiro, canto, cor de texto, o realce da passagem do mouse, o estado de aberto e o anel de foco do teclado. Dentro de um Menubar é ele que se usa, e não sobra nada para escrever por fora.

<Menubar aria-label="Principal">
  <Menu>
    <MenubarTrigger>Arquivo</MenubarTrigger>
    <MenuContent>
      <MenuItem>Novo documento</MenuItem>
      <MenuItem>Abrir rascunho</MenuItem>
    </MenuContent>
  </Menu>

  <Menu>
    <MenubarTrigger>Editar</MenubarTrigger>
    <MenuContent>
      <MenuItem>Desfazer</MenuItem>
    </MenuContent>
  </Menu>
</Menubar>

O MenuTrigger sai sem estilo de propósito: o uso comum dele é render={<Button />}, e duas fontes de estilo brigariam. Quem pagava por isso era a barra. O exemplo publicado repetia as mesmas cinco classes em cada item, e toda barra montada a partir dele repetia de novo. E a cópia vinha sem o anel de foco, então a barra da documentação era a única peça do catálogo que sumia da vista ao ser percorrida com o Tab.

Os dois continuam existindo porque têm trabalhos diferentes: um é gatilho de menu em qualquer lugar, o outro é item de uma barra.

Fora de um Menubar, é MenuTrigger cru. O menu solto (os três pontinhos de uma linha de tabela, o botão de ações de um cartão) abre com render={<Button variant="ghost" />}, e a pele de item de barra ali desalinha o gatilho dos outros controles da linha e promete uma barra que não existe.

Se a dúvida for entre barra de menus e outra coisa, ela é sobre o Menubar inteiro, e não sobre o gatilho: em tela de web, Sidebar e Tabs quase sempre dizem mais.

PropTipoPadrão
closeDelay0.5.0

Quanto esperar antes de fechar o menu aberto pelo passar do ponteiro.

number0
delay0.5.0

Quanto esperar antes de o menu poder abrir pelo passar do ponteiro.

number100
disabled0.5.0

Se a peça deve ignorar a interação do usuário.

booleanfalse
handle0.5.0

Um elo para associar o gatilho a um menu.

MenuHandle<unknown>sem padrão
nativeButton0.5.0

Se a peça renderiza um `<button>` nativo quando é trocada pela prop `render`.

booleantrue
openOnHover0.5.0

Se o menu abre também quando o ponteiro passa sobre o gatilho.

booleansem padrão
payload0.5.0

Um dado a entregar ao menu quando ele abre.

unknownsem padrão
render0.5.0

Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente.

ComponentRenderFn<HTMLProps, MenuTriggerState> | ReactElement<unknown, string | JSXElementConstructor<any>>sem padrão

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.