Tag HTML <figure>
A tag <figure> inclui imagens, diagramas, ilustrações etc. Descrição da tag, atributos e exemplos.
A tag <figure> marca conteúdo autossuficiente — uma unidade referenciada a partir do fluxo principal do documento, mas completa por si mesma. Ela geralmente contém uma imagem, mas pode igualmente envolver um diagrama, ilustração, listagem de código, citação ou tabela.
A tag <figure> é um dos elementos HTML5.
O que significa "conteúdo autossuficiente"
Um conteúdo é "autossuficiente" quando pode ser movido para outro lugar — uma barra lateral, um apêndice ou a próxima página — sem alterar o significado do texto ao redor. O corpo pode dizer "veja a figura abaixo", mas a figura em si não precisa estar nesse local exato para fazer sentido.
Esse é o principal motivo para escolher <figure> em vez de um simples <img>:
- Semântica, não apenas layout.
<figure>informa ao navegador e às tecnologias assistivas "este é uma ilustração referenciada e independente", enquanto um<img>simples é apenas uma imagem inline no texto. - Agrupa o conteúdo com sua legenda. Um
<figure>vincula uma imagem (ou código, ou citação) à sua descrição para que ambos se movam juntos como um bloco lógico único. - Tratamento por leitores de tela. Muitos leitores de tela anunciam um
<figure>como uma região de figura distinta e leem seu<figcaption>como o rótulo da figura, para que os usuários ouçam a explicação diretamente vinculada ao visual.
Se uma imagem é puramente decorativa ou flui inline como parte de uma frase, um <img> simples é suficiente — use <figure> quando o conteúdo for uma unidade referenciada e legendada.
Adicionando uma legenda com <figcaption>
Para rotular ou explicar a figura, aninhe um elemento <figcaption> dentro de <figure>. Ele deve ser o primeiro ou último filho do <figure> — primeiro para exibir a legenda acima do conteúdo, último para exibi-la abaixo.
Um <figure> pode conter no máximo um <figcaption>.
Sintaxe
A tag <figure> vem em pares. O conteúdo é escrito entre as tags de abertura (<figure>) e fechamento (</figure>).
Exemplo: <figure> com <figcaption>
Este é o uso mais comum — uma imagem associada a uma legenda:
<!DOCTYPE html>
<html>
<head>
<title>Title of the document</title>
</head>
<body>
<p>The Eiffel Tower at sunset (see Figure 1).</p>
<figure>
<img
src="/uploads/media/default/0001/01/25acddb3da54207bc6beb5838f65f022feaa81d7.jpeg"
alt="The Eiffel Tower silhouetted against an orange sky"
width="250"
height="200"
/>
<figcaption>Figure 1. The Eiffel Tower at sunset.</figcaption>
</figure>
</body>
</html>Exemplo: uma listagem de código
Um <figure> é um envoltório natural para um trecho de código referenciado. A legenda pode nomear a listagem:
<figure>
<figcaption>Listing 1. A minimal HTML page.</figcaption>
<pre><code><!DOCTYPE html>
<html>
<head><title>Hello</title></head>
<body>Hello, world!</body>
</html></code></pre>
</figure>Consulte <pre> e <code> para formatação de código.
Exemplo: uma citação
Uma citação destacada que é referenciada no texto pode ser uma figura, com a fonte na legenda:
<figure>
<blockquote>
<p>The only way to do great work is to love what you do.</p>
</blockquote>
<figcaption>— Steve Jobs</figcaption>
</figure>Consulte <blockquote> para marcação de citações.
Exemplo: uma tabela
Dados tabulares referenciados como figura também podem ser envolvidos:
<figure>
<figcaption>Table 1. Browser market share.</figcaption>
<table>
<tr><th>Browser</th><th>Share</th></tr>
<tr><td>Chrome</td><td>65%</td></tr>
<tr><td>Safari</td><td>19%</td></tr>
</table>
</figure>Consulte <table> para construção de tabelas.
A diferença entre <figure> e <aside>
Ambos os elementos agrupam conteúdo relacionado, mas respondem a perguntas diferentes.
<figure>contém conteúdo que faz parte do fluxo principal — o documento se refere a ele ("como mostrado na Figura 1"). Removê-lo deixaria uma referência pendente. Use-o para imagens, diagramas, listagens de código e citações que o texto aponta.<aside>contém conteúdo tangencial — barras laterais, links relacionados, citações destacadas ou unidades de anúncio. O texto principal é lido perfeitamente mesmo se o aside for removido, pois nada no corpo faz referência a ele.
Contraste concreto: um diagrama legendado como "Figura 2: ciclo de vida da requisição" discutido no artigo é um <figure>. Uma lista de "Artigos relacionados" ao lado do mesmo parágrafo é um <aside>.
Acessibilidade
<figure>tem um papel ARIA implícito defigure; não é necessário adicionarrole="figure"manualmente.- Quando presente, um
<figcaption>visível atua como o nome acessível (rótulo) da figura, para que usuários de leitores de tela obtenham a explicação vinculada ao conteúdo. Prefira um<figcaption>real ao invés dearia-labelpara que usuários videntes e não videntes vejam o mesmo texto. - Para imagens, o texto
altdo<img>e o<figcaption>servem a propósitos diferentes:altdescreve a imagem para usuários que não podem vê-la, enquanto a legenda adiciona contexto para todos. Evite repetir exatamente as mesmas palavras em ambos.
Atributos
A tag <figure> suporta os Atributos Globais e os Atributos de Evento.