<abbr>: O elemento Abbreviation

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

O elemento HTML <abbr> representa uma abreviação ou acrônimo.

Ao incluir uma abreviação ou acrônimo, forneça uma expansão completa do termo em texto simples no primeiro uso, junto com o <abbr> para marcar a abreviação. Isso informa à pessoa usuária o que a abreviação ou acrônimo significa.

O atributo opcional title pode fornecer uma expansão para a abreviação ou acrônimo quando uma expansão completa não estiver presente. Isso fornece uma dica para os agentes da pessoa usuária sobre como anunciar/exibir o conteúdo enquanto informa a todas as pessoas usuárias o que a abreviação significa. Se presente, title deve conter esta descrição completa e nada mais.

Experimente

Atributos

Este elemento suporta apenas os atributos globais. O atributo title tem um significado semântico específico quando usado com o elemento <abbr>; ele deve conter uma descrição completa legível para pessoas ou uma expansão da abreviação. Este texto é frequentemente apresentado pelos navegadores como uma dica de ferramenta quando o cursor do mouse é passado sobre o elemento.

Cada elemento <abbr> que você usa é independente de todos os outros; fornecer um title para um não anexa automaticamente o mesmo texto de expansão a outros com o mesmo texto de conteúdo.

Notas de uso

Casos de uso típicos

Certamente não é necessário que todas as abreviações sejam marcadas usando <abbr>. Existem, no entanto, alguns casos em que é útil fazer isso:

  • Quando uma abreviação é usada e você deseja fornecer uma expansão ou definição fora do fluxo do conteúdo do documento, use <abbr> com um title apropriado.
  • Para definir uma abreviação que pode ser desconhecida para a pessoa leitora, apresente o termo usando <abbr> e um texto em linha fornecendo a definição. Inclua um atributo title somente quando a expansão ou definição em linha não estiver disponível.
  • Quando a presença de uma abreviação no texto precisa ser semanticamente notada, o elemento <abbr> é útil. Isso pode ser usado, por sua vez, para fins de estilo ou script.
  • Você pode usar <abbr> em conjunto com <dfn> para estabelecer definições para termos que são abreviações ou acrônimos. Veja o exemplo Definindo uma abreviação abaixo.

Considerações gramaticais

Em idiomas com número gramatical (ou seja, idiomas em que o número de itens afeta a gramática de uma sentença), use o mesmo número gramatical no seu atributo title assim como no seu elemento <abbr>. Isso é especialmente importante em idiomas com mais de dois números, como o árabe, mas também é relevante em inglês.

Estilo padrão

O propósito deste elemento é puramente para a conveniência da pessoa autora e todos os navegadores o exibem em linha (display: inline) por padrão, embora seu estilo padrão varie de um navegador para outro:

Alguns navegadores adicionam um sublinhado pontilhado ao conteúdo do elemento. Outros adicionam um sublinhado pontilhado ao converter o conteúdo para versaletes. Outros podem não estilizá-lo de forma diferente de um elemento <span>. Para controlar esse estilo, use text-decoration e font-variant.

Acessibilidade

Soletrar a sigla ou abreviação por completo na primeira vez que for usada em uma página é benéfico para ajudar as pessoas a entendê-la, especialmente se o conteúdo for um jargão técnico ou do setor.

Inclua um title somente se não for possível expandir a abreviação ou acrônimo no texto. Ter uma diferença entre a palavra ou frase anunciada e o que é exibido na tela, especialmente se for um jargão técnico com o qual a pessoa leitora pode não estar familiarizada, pode ser chocante.

html
<p>
  JavaScript Object Notation (<abbr>JSON</abbr>) is a lightweight
  data-interchange format.
</p>

Isso é especialmente útil para pessoas que não estão familiarizadas com a terminologia ou os conceitos discutidos no conteúdo, pessoas que são novas no idioma e pessoas com problemas cognitivos.

Exemplos

Marcando uma abreviação semanticamente

Para marcar uma abreviação sem fornecer uma expansão ou descrição, use <abbr> sem nenhum atributo, como visto neste exemplo.

HTML

html
<p>Using <abbr>HTML</abbr> is fun and easy!</p>

Resultado

Estilizando abreviações

Você pode usar CSS para definir um estilo personalizado a ser usado para abreviações, como visto neste exemplo básico.

HTML

html
<p>Using <abbr>CSS</abbr>, you can style your abbreviations!</p>

CSS

css
abbr {
  font-variant: all-small-caps;
}

Resultado

Fornecendo uma expansão

Adicionar um atributo title permite que você forneça uma expansão ou definição para a abreviação ou acrônimo.

HTML

html
<p>Ashok's joke made me <abbr title="Laugh Out Loud">LOL</abbr> big time.</p>

Resultado

Definindo uma abreviação

Você pode usar <abbr> em conjunto com <dfn> para definir uma abreviação mais formalmente, como mostrado aqui.

HTML

html
<p>
  <dfn id="html"><abbr title="HyperText Markup Language">HTML</abbr> </dfn> is a
  markup language used to create the semantics and structure of a web page.
</p>

<p>
  A <dfn id="spec">Specification</dfn> (<abbr>spec</abbr>) is a document that
  outlines in detail how a technology or API is intended to function and how it
  is accessed.
</p>

Resultado

Resumo técnico

Categorias de conteúdo Conteúdo de fluxo, conteúdo fraseado, conteúdo palpável
Conteúdo permitido Conteúdo fraseado
Omissão de tag Nenhuma, tanto a tag inicial quanto a final são obrigatórias.
Pais permitidos Qualquer elemento que aceite conteúdo fraseado
Função ARIA implícita Nenhuma função correspondente
Funções ARIA permitidas Qualquer uma
Interface DOM HTMLElement

Especificações

Specification
HTML
# the-abbr-element

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também