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

Cookiebar Link

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-cookiebar-link renderiza atalhos para Políticas de Privacidade e Termos de Uso. Deve ser utilizado nas notas, cabeçalho ou corpo do componente orquestrador <br-cookiebar>.

Visão Geral​

Link do br-cookiebar para a política de privacidade ou os termos de uso. Use no slot links do cookiebar.

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

Propriedades​

customId​

Atributocustom-id
DescriçãoID interno gerado automaticamente. Não é necessário informar.
Tipostring
Valor padrãogenerateUniqueId()

href​

Atributohref
DescriçãoURL de destino do link. (obrigatório)
Tipostring
Valor padrão---

name​

Atributoname
DescriçãoTexto visível do link (ex: Política de Privacidade). (obrigatório)
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'

target​

Atributotarget
DescriçãoDefine onde o link será aberto.
- _self (padrão): abre na mesma aba.
- _blank: abre em uma nova aba, com ícone de link externo e rel="noopener noreferrer" automáticos.
Tipostring
Valor padrão'_self'

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

CSS Shadow Parts​

NomeDescrição
"link"Elemento âncora (<a>) do link.

Migração da navegação​

Troque url por href. Em SPA, adicione navigation-mode="event" e trate brNavigate. Links com target="_blank" sempre abrem normalmente.

<!-- Antes -->
<br-cookiebar-link name="Política de privacidade" url="/privacidade"></br-cookiebar-link>

<!-- Agora -->
<br-cookiebar-link name="Política de privacidade" href="/privacidade"></br-cookiebar-link>

Dependências​

Componente pai​

Depende de​

Gráfico​

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