NavigationMenu
Topo de site
Lateral de portal, com a página aberta
import { NavigationMenu } from '@rivocode/ui'Quando usar
A navegação de topo de site, com painel por seção.
Não é Menu: aquele lista ações que se executam, este lista lugares para onde
ir, e o painel pode ter texto, imagem e várias colunas. O leitor de tela anuncia
os dois de formas diferentes, e trocar um pelo outro faz o menu de ações
prometer navegação que não existe.
Em tela de aplicação, Sidebar costuma servir melhor. Este é para página de
marketing e portal.
<NavigationMenu>
<NavigationMenuList>
<NavigationMenuItem>
<NavigationMenuTrigger>Produtos</NavigationMenuTrigger>
<NavigationMenuContent>
<NavigationMenuLink href="/agenda">Agenda online</NavigationMenuLink>
<NavigationMenuLink href="/cobranca">Cobrança</NavigationMenuLink>
</NavigationMenuContent>
</NavigationMenuItem>
</NavigationMenuList>
<NavigationMenuViewport />
</NavigationMenu>
O painel é único e fica fora da lista: é ele que desliza de uma seção para a
outra em vez de piscar entre painéis. Sem o <NavigationMenuViewport /> o
painel nunca aparece, porque é dentro dele que o conteúdo se desenha.
As partes
NavigationMenuViewport é o painel onde o conteúdo do item aberto aparece.
Fica fora dos itens, e não dentro de cada um: assim a troca entre dois menus
vizinhos anima de um para o outro em vez de fechar e abrir.
A página aberta
active no NavigationMenuLink marca onde a pessoa está: sai com
aria-current="page", que o leitor de tela anuncia, e com o fundo e o texto
do item ativo da Sidebar, em peso médio. Passe-o a partir da rota, no link
da página aberta e só nele.
<NavigationMenuLink href="/precos" active={pathname === '/precos'}>
Preços
</NavigationMenuLink>
Em pé
orientation="vertical" empilha os itens numa coluna, para a lateral de um
portal ou de uma central de ajuda. O gatilho ocupa a linha com a seta apontando
para o lado, o painel abre ao lado da coluna e as setas do teclado andam para
cima e para baixo.
<NavigationMenu orientation="vertical">
<NavigationMenuList>
<NavigationMenuItem>
<NavigationMenuTrigger>Produtos</NavigationMenuTrigger>
<NavigationMenuContent>
<NavigationMenuLink href="/agenda">Agenda online</NavigationMenuLink>
</NavigationMenuContent>
</NavigationMenuItem>
</NavigationMenuList>
<NavigationMenuViewport />
</NavigationMenu>
No celular
Abaixo de 640px o painel abre como folha encostada embaixo, em largura cheia e
acima do teclado, com a tarja atrás: o mesmo do Menu, do Select e do
Combobox, porque o painel preso ao gatilho, num topo de 375px, sai cortado ou
cobre o próprio gatilho. mobileSheet={false} no NavigationMenuViewport
mantém o painel preso ao gatilho em toda largura.
Quando não usar
Em sistema com muitas telas, use Sidebar: ela dá conta de muitos destinos e
fica sempre à vista, que é o que tela de aplicação pede.
Ações que se executam, como baixar ou duplicar, são Menu, e a barra de
Arquivo e Editar de uma ferramenta é Menubar. Conteúdo que alterna dentro da
mesma página, sem trocar de endereço, é Tabs.
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 |
|---|---|---|
actionsRef0.4.0Uma ref para as ações imperativas. | RefObject<NavigationMenuRootActions | null> | sem padrão |
closeDelay0.4.0Quanto esperar antes de fechar o painel de navegação. | number | 50 |
defaultValue0.4.0O item escolhido de início, no modo não controlado. | unknown | null |
delay0.4.0Quanto esperar antes de abrir o painel de navegação. | number | 50 |
onOpenChangeComplete0.4.0Chamado depois que as animações terminam, quando o menu de navegação fecha. | ((open: boolean) => void) | sem padrão |
onValueChange0.4.0Chamado quando o valor muda. | ((value: unknown, eventDetails: NavigationMenuRootChangeEventDetails) => void) | sem padrão |
orientation0.4.0`horizontal` e a barra de topo de site, com o painel abrindo embaixo do gatilho; `vertical` empilha os itens numa coluna, para a lateral de um portal, e o painel abre ao lado. | Orientation | "horizontal" |
render0.4.0Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente. | ComponentRenderFn<HTMLProps, NavigationMenuRootState> | ReactElement<unknown, string | JSXElementConstructor<any>> | sem padrão |
value0.4.0O item do menu de navegação aberto agora, no modo controlado. | unknown | null |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.