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.