Footer Logo

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-logo renderiza a marca oficial do órgão ou do Governo Federal no rodapé. Deve ser posicionado na área designada de logotipo do componente orquestrador <br-footer>.

Visão Geral

O componente br-footer-logo é o subcomponente do GovBR-DS responsável por renderizar a marca oficial do órgão ou a marca unificada do Governo Federal no rodapé.

Para que serve

• Assinatura institucional: Reforça a autenticidade governamental no fechamento da página.
• Link oficial: Permite redirecionar a pessoa usuária para o portal principal do Governo Federal ou do órgão.

Papel na composição

Atua como elemento de identidade institucional no rodapé.

Regra de uso e relacionamento

• Deve ser inserido na área ou slot de logotipo do br-footer.
• Não deve ser utilizado fora do ecossistema de rodapé.

Propriedades

customId

Atributo	custom-id
Descrição	Identificador único do componente. Quando omitido, um valor é gerado automaticamente. > Padrão: valor único gerado por generateUniqueId().
Tipo	string
Valor padrão	generateUniqueId()

description

Atributo	description
Descrição	Descrição da logo.
Tipo	string
Valor padrão	'logo'

href

Atributo	href
Descrição	URL de destino quando a logo for clicada. Se fornecido, a logo será envolvida em um link.
Tipo	string
Valor padrão	---

isPartner Componente mantido por compatibilidade; prefira a alternativa indicada na documentação.

Atributo	is-partner
Depreciação	Use partner.
Descrição	Define se a logo é de um parceiro.
Tipo	boolean
Valor padrão	false

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'

partner

Atributo	partner
Descrição	Identifica logo de parceiro. Quando informada, tem precedência sobre isPartner.
Tipo	boolean
Valor padrão	---

position

Atributo	position
Descrição	Posição da logo.
Tipo	"center" | "left" | "right"
Valor padrão	'left'

src

Atributo	src
Descrição	Url da logo padrão.
Tipo	string
Valor padrão	''

target

Atributo	target
Descrição	Target do link quando href é fornecido.
Tipo	"_blank" | "_parent" | "_self" | "_top"
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
"container"	Wrapper principal do footer-logo.

Migração de Navegação

Antes, br-footer-logo podia receber comportamento SPA legado.

Agora, quando a logo tiver href, use navigation-mode="event" para integrar com o roteador da SPA.

<!-- Antes -->
<br-footer-logo src="/logo.png" href="/" is-spa-link-behavior></br-footer-logo>

<!-- Agora -->
<br-footer-logo src="/logo.png" href="/" navigation-mode="event"></br-footer-logo>

Se target for diferente de _self, o clique segue a navegação nativa do navegador.

Dependências

Componente pai

• br-footer