Copiar página como Markdown para IA
Header Link
Subcomponente de Composição
O br-header-link representa um link de navegação institucional no cabeçalho. Deve ser utilizado dentro de um <br-header-list> no slot links do <br-header>.
Visão Geral
Link do br-header, dentro de um br-header-list no slot links. Informe o destino em href e o texto no conteúdo.
Em SPA, use navigation-mode="event" e trate brNavigate.
Propriedades
customId
| Atributo | custom-id |
|---|---|
| Descrição | Identificador único do componente. Quando omitido, um valor é gerado automaticamente. > Padrão: valor único gerado por generateUniqueId(). |
| Tipo | string |
| Valor padrão | generateUniqueId() |
href
| Atributo | href |
|---|---|
| Descrição | URL do link. |
| Tipo | string |
| Valor padrão | --- |
navigationMode
| Atributo | navigation-mode |
|---|---|
| Descrição | Controla como o componente integra a navegação mantendo href real no elemento navegável.- native (padrão): preserva o comportamento do navegador, conforme HTML/W3C.- event: emite brNavigate; se o evento for cancelado, bloqueia a navegação nativa para a SPA assumir.Cliques com modificadores, botão do meio ou target diferente de _self permanecem nativos. |
| Tipo | "event" | "native" |
| Valor padrão | 'native' |
target
| Atributo | target |
|---|---|
| Descrição | Define o alvo do link quando href está presente. Pode ser:- _blank para abrir em uma nova aba,- _self para abrir na mesma aba,- _parent para abrir na aba pai,- _top para abrir na aba superior. |
| Tipo | "_blank" | "_parent" | "_self" | "_top" |
| Valor padrão | '_self' |
Slots
| Nome | Descrição |
|---|---|
"default" | Slot para o conteúdo do link exibido no cabeçalho. |
Eventos
| Evento | Descrição | Depreciação | Propagação |
|---|---|---|---|
brNavigate | Evento cancelável emitido em navigation-mode="event" para cliques primários sem modificadores em links _self. Chame event.preventDefault() no listener para impedir a navegação nativa e entregar event.detail.href ao roteador da SPA. | --- | true |
Migração da navegação
Troque is-spa-link-behavior por navigation-mode="event" e trate brNavigate.
<!-- Antes -->
<br-header-link href="/orgaos" is-spa-link-behavior>Órgãos</br-header-link>
<!-- Agora -->
<br-header-link href="/orgaos" navigation-mode="event">Órgãos</br-header-link>
