Ir para o conteúdo principal
WBC - GovBR-DS
Copiar página como Markdown para IA

Footer Item

Componente estável e recomendada para novos projetos.
Anatomia, uso, comportamento visual e recomendações conceituais são mantidos pelo Padrão Digital de Governo. Esta página documenta a implementação Web Components e sua API executável.
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​

Um link do mapa do site, dentro de um br-footer-category. Informe o destino em href e o texto no conteúdo.

Em SPA, use navigation-mode="event" e trate o evento brNavigate.

Propriedades​

customId​

Atributocustom-id
DescriçãoIdentificador único do componente.
Quando omitido, um valor é gerado automaticamente.

> Padrão: valor único gerado por generateUniqueId().
Tipostring
Valor padrãogenerateUniqueId()

href​

Atributohref
DescriçãoURL ou caminho para o qual o usuário será direcionado ao clicar no item.
Quando definido, o item será renderizado como um link.
Tipostring
Valor padrão---
Atributonavigation-mode
DescriçãoControla 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​

NomeDescrição
"default"Slot para o conteúdo do item no rodapé, incluindo texto ou componentes de roteamento para SPAs.

Eventos​

EventoDescriçãoDepreciaçãoPropagação
brNavigateEvento 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. Sem isso, o link navega normalmente.

<!-- 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>

Dependências​

Componente pai​

Depende de​

Gráfico​

Comece aquiComponentesQuickstartsSobre o projetoRepositório GitLabVersõesDiscordGovBR-DSFAQWikiRedefinir cookies