Pular para o conteúdo
Navegação

NavigationMenu

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

Lateral de portal, com a página aberta

Importar
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

PropTipoPadrão
actionsRef0.4.0

Uma ref para as ações imperativas.

RefObject<NavigationMenuRootActions | null>sem padrão
closeDelay0.4.0

Quanto esperar antes de fechar o painel de navegação.

number50
defaultValue0.4.0

O item escolhido de início, no modo não controlado.

unknownnull
delay0.4.0

Quanto esperar antes de abrir o painel de navegação.

number50
onOpenChangeComplete0.4.0

Chamado depois que as animações terminam, quando o menu de navegação fecha.

((open: boolean) => void)sem padrão
onValueChange0.4.0

Chamado 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.0

Troca 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.0

O item do menu de navegação aberto agora, no modo controlado.

unknownnull

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.