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

O componente br-cookiebar-link é o subcomponente de hiperlink do GovBR-DS destinado a apontar para Políticas de Privacidade, Termos de Uso e orientações legais.

Para que serve

• Acesso a termos legais: Encaminha a pessoa usuária para a documentação completa de proteção de dados.
• Estilo consistente: Garante conformidade visual e acessibilidade no contexto do aviso de cookies.

Papel na composição

Atua como item de navegação auxiliar no aviso de cookies.

Regra de uso e relacionamento

• Pode ser utilizado dentro do cabeçalho, notas ou corpo do componente br-cookiebar.

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'

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

CSS Shadow Parts

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

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.

Dependências

Componente pai

• br-cookiebar

Depende de

• br-icon

Gráfico