Menubar
Principal
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
| Prop | Tipo | Padrão |
|---|---|---|
disabled0.4.0Se a barra de menus inteira está desabilitada. | boolean | false |
loopFocus0.4.0Se o foco do teclado volta ao primeiro item ao chegar no fim da lista pelas setas. | boolean | true |
modal0.4.0Se a barra de menus é modal. | boolean | true |
orientation0.4.0A orientação da barra de menus. | MenuRootOrientation | "horizontal" |
render0.4.0Troca 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.
MenubarTrigger
/menubar-trigger.mdO 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>
Por que ele existe, se já há MenuTrigger
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.
Quando não usar
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.
| Prop | Tipo | Padrão |
|---|---|---|
closeDelay0.5.0Quanto esperar antes de fechar o menu aberto pelo passar do ponteiro. | number | 0 |
delay0.5.0Quanto esperar antes de o menu poder abrir pelo passar do ponteiro. | number | 100 |
disabled0.5.0Se a peça deve ignorar a interação do usuário. | boolean | false |
handle0.5.0Um elo para associar o gatilho a um menu. | MenuHandle<unknown> | sem padrão |
nativeButton0.5.0Se a peça renderiza um `<button>` nativo quando é trocada pela prop `render`. | boolean | true |
openOnHover0.5.0Se o menu abre também quando o ponteiro passa sobre o gatilho. | boolean | sem padrão |
payload0.5.0Um dado a entregar ao menu quando ele abre. | unknown | sem padrão |
render0.5.0Troca 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.