menu-item
Visão Geral
Para a documentação completa, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o Design System do GovBR.
Propriedades
active
| Atributo | active |
| Descrição | Define se o item do menu está ativo/selecionado. Quando ativado, aplica estilos visuais para destacar o item como atual ou selecionado. |
| Tipo | boolean |
| Valor padrão | false |
displayMode
| Atributo | display-mode |
| Descrição | Define o modo de exibição do item, controlando os ícones de expansão. - accordion: exibe setas para cima/baixo (usado em menus de nível 0).- drill-down: exibe seta para a direita (usado em menus de níveis 1+).- none: não exibe ícones de expansão. |
| Tipo | "accordion" | "drill-down" | "none" |
| Valor padrão | 'none' |
divider
| Atributo | divider |
| Descrição | Define se o item deve exibir um divisor visual. Quando ativado, adiciona uma linha separadora para organizar visualmente os itens do menu. |
| Tipo | boolean |
| Valor padrão | false |
expanded
| Atributo | expanded |
| Descrição | Indica se o item está expandido para fins de acessibilidade (ARIA). Este estado é controlado externamente (por exemplo, por br-menu-list). Não altera o estado visual de "active". |
| Tipo | boolean |
| Valor padrão | false |
href
| Atributo | href |
| Descrição | URL de destino do link do item do menu. Utilize esta propriedade para definir o endereço para onde o usuário será direcionado ao clicar no item. |
| Tipo | string |
| Valor padrão | '#' |
icon
| Atributo | icon |
| Descrição | Ícone exibido no item do menu. Utilize esta propriedade para definir o ícone que será mostrado ao lado do conteúdo do item. |
| Tipo | string |
| Valor padrão | --- |
isSpaLinkBehavior
| Atributo | is-spa-link-behavior |
| Descrição | Define se o link deve se comportar como uma navegação SPA (Single Page Application). - true: Previne o comportamento padrão de recarregamento da página e emite o evento brSpaNavigate.Se o evento não for prevenido pelo consumidor, realiza history.pushState.- false (padrão): Segue o comportamento 100% nativo do link, sem emitir brSpaNavigate. |
| Tipo | boolean |
| Valor padrão | false |
target
| Atributo | target |
| Descrição | Define como o link será aberto. - _self: abre no mesmo contexto de navegação (padrão)- _blank: abre em nova aba ou janela- _parent: abre no contexto pai- _top: abre no contexto de nível superior |
| Tipo | "_blank" | "_parent" | "_self" | "_top" |
| Valor padrão | '_blank' |
Slots
| Nome | Descrição |
|---|---|
"default" | Conteúdo textual principal exibido no item de menu. |
Eventos
| Evento | Descrição | Propagação |
|---|---|---|
brSpaNavigate | Evento emitido quando o link é clicado em modo de navegação SPA (isSpaLinkBehavior = true). Originado em br-link (bubbles + composed), re-declarado aqui para geração de tipos e wrappers. Cancele o evento para impedir o pushState e assumir o controle da navegação. Em modo nativo (isSpaLinkBehavior = false) o evento não é emitido. | true |
CSS Shadow Parts
| Nome | Descrição |
|---|---|
"content" | Conteúdo textual do item de menu. |
"icon" | Ícone do item de menu. |
"link" | Elemento âncora do item de menu. |
"support" | Ícone de suporte (seta para baixo/direita). |