cookiebar-link

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.

Visão Geral

Link complementar exibido na área de rodapé do br-cookiebar. Use dentro do slot links do br-cookiebar para adicionar links externos estruturados, como "Política de Privacidade" ou "Termos de Uso".

Quando target="_blank", exibe automaticamente um ícone de link externo e adiciona rel="noopener noreferrer" por segurança.

Propriedades

customId

Atributo	custom-id
Descrição	ID interno gerado automaticamente. Não é necessário informar.
Tipo	string
Valor padrão	generateUniqueId()

href

Atributo	href
Descrição	URL de destino do link. (obrigatório)
Tipo	string
Valor padrão	---

name

Atributo	name
Descrição	Texto visível do link (ex: Política de Privacidade). (obrigatório)
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 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.
Tipo	string
Valor padrão	'_self'

CSS Shadow Parts

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

Dependências

Componente pai

• br-cookiebar

Depende de

• br-icon

Gráfico

Migração de Navegação

Antes, br-cookiebar-link usava url como destino.

Agora, use href. Para SPAs, adicione navigation-mode="event" e trate brNavigate.

<!-- Antes -->
<br-cookiebar-link name="Politica de Privacidade" url="/privacidade"></br-cookiebar-link>

<!-- Agora -->
<br-cookiebar-link name="Politica de Privacidade" href="/privacidade" navigation-mode="event"></br-cookiebar-link>

Links com target="_blank" continuam usando navegação nativa.