Skip to content

Commit

Permalink
Дополняет текст доки про <figure> и <figcaption> (#4678)
Browse files Browse the repository at this point in the history
* Дополняет текст доки

* Дополняет про цитаты

* Добавляет уточнение

* Укорачивает строчки кода
  • Loading branch information
TatianaFokina authored Aug 21, 2023
1 parent 28736a0 commit 2008802
Showing 1 changed file with 24 additions and 5 deletions.
29 changes: 24 additions & 5 deletions html/figure-figcaption/index.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
---
title: "`<figure>`, `<figcaption>`"
description: "Оформляет изображения с подписью."
description: "Добавляем изображение с подписью."
authors:
- ezhkov
contributors:
- furtivite
- tatianafokina
keywords:
- фигура
related:
Expand All @@ -26,8 +27,9 @@ tags:

```html
<figure>
<img src="elephant-sunset.jpg"
alt="Слон на фоне заката">
<img src="elephant-sunset.jpg"
alt="Взрослый африканский слон стоит на фоне заката и задумчиво смотрит в
камеру.">
<figcaption>Слон на фоне заката</figcaption>
</figure>
```
Expand Down Expand Up @@ -67,11 +69,24 @@ tags:
</figure>
```

Несколько изображений с общей подписью:

```html
<figure>
<img src="/favicon144.png" alt="Лого в 1819">
<img src="/favicon145.png" alt="Лого в 1919">
<img src="/favicon146.png" alt="Лого в 2019">
<figcaption>Как изменялся логотип компании.</figcaption>
</figure>
```

Фрагменты кода:

```html
<figure>
<figcaption>Получаем данные о текущем URL из свойства <code>location</code>.</figcaption>
<figcaption>
Получаем данные о текущем URL из свойства <code>location</code>.
</figcaption>
<pre>
function LocationExample() {
console.log(`Protocol: ${location.protocol}`);
Expand All @@ -90,8 +105,12 @@ tags:
- картинка либо другое медиасодержимое с подписью;
- фрагменты кода с пояснением;
- цитата с указанием автора;
- отрывок стихотворения с указанием автора и т.п.
- отрывок стихотворения с указанием автора и т. п.

💡 Разрешено использовать только один тег `<figcaption>` внутри `<figure>`.

💡 Подпись к картинке из `<figcaption>` должна отличаться от описания из `alt`.

💡 Элемент `<figcaption>`, если он есть, обязательно должен быть первым или последним потомком элемента `<figure>`.

💡 Лучше не вкладывать внутрь `<figure>` тег для цитат [`<blockquote>`](/html/blockquote/), хотя спецификация это не запрещает. В этом случае [скринридеры](/a11y/screenreaders/) будут слишком назойливо озвучивать все роли и повторять несколько раз подпись к цитате, если она завёрнута в `<figcaption>`.

0 comments on commit 2008802

Please sign in to comment.