Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

figcaption — podpis zawartości figure

Element `figcaption` nadaje podpis zawartości `figure`. Musi być jego bezpośrednim dzieckiem, umieszczonym na początku albo na końcu.

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

Składnia

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

figcaption reprezentuje podpis lub objaśnienie pozostałej zawartości nadrzędnego elementu figure. Dotyczy nie tylko ilustracji: może też opisywać diagram lub listing kodu. Podpis może zawierać informacje o źródle.

W jednym figure można umieścić najwyżej jeden bezpośredni element figcaption, jako pierwsze albo ostatnie dziecko. Podpis jest opcjonalny. Nie umieszczaj go między fragmentami opisywanej zawartości ani wewnątrz dodatkowego kontenera zamiast bezpośrednio w figure.

figcaption dopuszcza zawartość typu flow content, na przykład tekst, odnośniki i akapity. Obsługuje atrybuty globalne i korzysta z interfejsu DOM HTMLElement. Oba znaczniki, otwierający i zamykający, są wymagane. W przykładzie podpis opisuje równanie zapisane jako listing; nie jest częścią samego kodu.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła