Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

figcaption — una didascalia per il contenuto di figure

L’elemento `figcaption` aggiunge una didascalia al contenuto di `figure`. Deve esserne un figlio diretto, collocato all’inizio o alla fine.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

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

figcaption rappresenta una didascalia o una legenda per il resto del contenuto del suo elemento genitore figure. Non è limitato alle illustrazioni: può descrivere anche un diagramma o un listato di codice. La didascalia può includere informazioni sulla fonte.

Un figure può contenere al massimo un elemento figcaption figlio diretto, come primo o ultimo figlio. La didascalia è facoltativa. Non inserirla tra le parti del contenuto che descrive né dentro un contenitore aggiuntivo invece che direttamente in figure.

figcaption accetta contenuti di tipo flow, per esempio testo, link e paragrafi. Supporta gli attributi globali e usa l’interfaccia DOM HTMLElement. Sono necessari sia il tag di apertura sia quello di chiusura. Nell’esempio, la didascalia descrive un’equazione presentata come listato; non fa parte del codice stesso.

Esempi

<!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>

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti