Link

Visão Geral

Design System

Para a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o Design System do GovBR.

Exemplos

Carregando exemplo

Código fonte editável

Formatar código

Copiar código

Resetar exemplo

Abrir no StackBlitz

Alternar fundo do preview

Propriedades

disabled

Atributo	disabled
Descrição	Desativa o link, tornando-o não interativo. Quando true: remove o href (um <a> sem href sai da ordem de tabulação e não recebe foco, nem por clique), marca aria-disabled="true" e bloqueia o clique (sem navegação nem emissão de brSpaNavigate). Se o link estiver focado no momento da desativação, o foco é removido. Útil para componentes como br-pagination e br-wizard.
Tipo	boolean
Valor padrão	false

href

Atributo	href
Descrição	URL de destino do link.
Tipo	string
Valor padrão	'#'

isSpaLinkBehavior

Atributo	is-spa-link-behavior
Descrição	Define se o link deve se comportar como uma navegação SPA (Single Page Application). - true: Previne o comportamento padrão de recarregamento e emite brSpaNavigate. Se o evento não for prevenido pelo consumidor, realiza history.pushState. - false (padrão): Segue o comportamento 100% nativo do link, sem emitir brSpaNavigate.
Tipo	boolean
Valor padrão	false

linkAriaCurrent

Atributo	link-aria-current
Descrição	Encaminhamento de aria-current para o elemento âncora interno. Indica o item ativo em um conjunto de navegação (breadcrumb, menu, paginação). Valores comuns: "page" (link da página atual), "step" (etapa ativa), "true". Referência: WCAG 1.3.1 e ARIA aria-current.
Tipo	string
Valor padrão	---

linkAriaDescribedby

Atributo	link-aria-describedby
Descrição	Encaminhamento de aria-describedby para o elemento âncora interno. Referencia o id de um elemento externo que descreve o link.
Tipo	string
Valor padrão	---

linkAriaExpanded

Atributo	link-aria-expanded
Descrição	Encaminhamento de aria-expanded para o elemento âncora interno.
Tipo	string
Valor padrão	---

linkAriaHaspopup

Atributo	link-aria-haspopup
Descrição	Encaminhamento de aria-haspopup para o elemento âncora interno.
Tipo	string
Valor padrão	---

linkAriaLabel

Atributo	link-aria-label
Descrição	Encaminhamento de aria-label para o elemento âncora interno. Fornece nome acessível ao link quando o conteúdo do slot não é descritivo por si só (ex.: link com ícone sem texto visível).
Tipo	string
Valor padrão	---

linkAriaSelected

Atributo	link-aria-selected
Descrição	Encaminhamento de aria-selected para o elemento âncora interno.
Tipo	string
Valor padrão	---

linkRole

Atributo	link-role
Descrição	Encaminhamento de role para o elemento âncora interno.
Tipo	string
Valor padrão	---

rel

Atributo	rel
Descrição	Relação entre o documento atual e o destino (rel). Quando target="_blank", noopener e noreferrer são sempre incluídos (mesmo que rel seja definido) para mitigar tabnabbing e vazamento de window.opener.
Tipo	string
Valor padrão	---

target

Atributo	target
Descrição	Define como o link será aberto. - _self: abre no mesmo contexto de navegação - _blank: abre em nova aba ou janela - _parent: abre no contexto pai - _top: abre no contexto de nível superior
Tipo	"_blank" | "_parent" | "_self" | "_top"
Valor padrão	---

Eventos

Evento	Descrição	Propagação
brSpaNavigate	Evento emitido quando o link é clicado em modo de navegação SPA (isSpaLinkBehavior = true). O evento é cancelável (cancelable: true) e propaga pelo shadow DOM (composed: true). Cancele o evento para impedir o pushState e assumir o controle da navegação (ex.: router de framework). Em modo nativo (isSpaLinkBehavior = false) o evento não é emitido.	true

Dependências

Usado por

• br-menu-item

Gráfico

Migração: Vue 1.x → Stencil 2.x

Propriedades

🟦 Propriedades renomeadas

Propriedade Vue	Propriedade Stencil	Descrição	Tipo	Padrão

🟥 Propriedades removidas

Propriedade	Descrição	Tipo	Padrão

🟩 Novas propriedades

Propriedade	Descrição	Tipo	Padrão
href	URL de destino do link.	string	'#'
is-spa-link-behavior	Ativa modo SPA: previne reload e emite brSpaNavigate.	boolean	false
link-aria-expanded	Forwarding de aria-expanded para o elemento âncora interno.	string	---
link-aria-haspopup	Forwarding de aria-haspopup para o elemento âncora interno.	string	---
link-aria-selected	Forwarding de aria-selected para o elemento âncora interno.	string	---
link-role	Forwarding de role para o elemento âncora interno.	string	---
target	Define como o link será aberto.	'_self' | '_blank' | '_parent' | '_top'	---

Eventos

🟦 Eventos renomeados

Evento Vue	Evento Stencil	Descrição

🟥 Eventos removidos

Propriedade	Descrição	Tipo	Padrão

🟩 Novos eventos

Evento	Descrição
brSpaNavigate	Emitido em todo clique (botão esquerdo, sem modificadores). Cancelável — chame ev.preventDefault() para assumir o controle da navegação.

Slots

🟦 Slots renomeados

Slot Vue	Slot Stencil	Descrição

🟥 Slots removidos

Propriedade	Descrição	Tipo	Padrão

🟩 Slots criados

Slot	Descrição
default	Conteúdo do link (texto, ícones ou outros elementos).