Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

figcaption — uma legenda para o conteúdo de figure

O elemento `figcaption` associa uma legenda ao conteúdo de `figure`. Tem de ser um filho direto, colocado no início ou no fim.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<figure>
  <!-- Figure content -->
  <figcaption>Caption text</figcaption>
</figure>

figcaption representa uma legenda ou explicação para o restante conteúdo do elemento-pai figure. Não se limita a ilustrações: também pode descrever um diagrama ou uma listagem de código. A legenda pode incluir informações sobre a origem.

Um figure pode conter, no máximo, um elemento figcaption como filho direto, colocado em primeiro ou em último lugar. A legenda é opcional. Não a coloques entre partes do conteúdo descrito nem dentro de um contentor adicional em vez de diretamente em figure.

figcaption aceita conteúdo do tipo flow, como texto, ligações e parágrafos. Suporta atributos globais e utiliza a interface DOM HTMLElement. São necessárias tanto a etiqueta de abertura como a de fecho. No exemplo, a legenda descreve uma equação apresentada como listagem; não faz parte do próprio código.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Caption example</title>
</head>
<body>
  <figure>
    <pre><code>2 + 3 = 5</code></pre>
    <figcaption>Listing 1. An addition equation.</figcaption>
  </figure>
</body>
</html>

Resultado

2 + 3 = 5
Listing 1. An addition equation.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes