Copiar página como Markdown para IA
Footer Item
Subcomponente de Composição
O br-footer-item representa um link individual de navegação no rodapé. Deve ser utilizado dentro de um <br-footer-category> no <br-footer>.
Visão Geral
O componente br-footer-item é o subcomponente folha do GovBR-DS que renderiza um link de navegação individual dentro de uma categoria do rodapé.
Para que serve
- Acesso direto a links: Conduz a pessoa usuária a páginas de serviços, transparência ou seções institucionais.
- Estilo padronizado: Garante tipografia, espaçamento e estados acessíveis no rodapé.
Papel na composição
Atua como item de link final na hierarquia de rodapé.
Regra de uso e relacionamento
- Deve ser utilizado exclusivamente dentro de um componente
br-footer-category. - Não deve ser declarado de forma isolada fora de uma categoria de rodapé.
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 ou caminho para o qual o usuário será direcionado ao clicar no item. Quando definido, o item será renderizado como um 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' |
Slots
| Nome | Descrição |
|---|---|
"default" | Slot para o conteúdo do item no rodapé, incluindo texto ou componentes de roteamento para SPAs. |
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 de Navegação
Antes, br-footer-item encaminhava is-spa-link-behavior para o br-item interno.
Agora, use navigation-mode="event" quando o item possuir href e precisar ser controlado por uma SPA.
<!-- Antes -->
<br-footer-item href="/acessibilidade" is-spa-link-behavior>Acessibilidade</br-footer-item>
<!-- Agora -->
<br-footer-item href="/acessibilidade" navigation-mode="event">Acessibilidade</br-footer-item>
Sem navigation-mode="event", a navegação segue nativa.
