Alt-текст для изображений: как писать атрибут alt
Информация о статье

Автор: Дмитрий Дугарев
Хороший alt-текст для изображений заменяет картинку тем, кто её не видит. Это руководство для редакторов, владельцев сайтов и разработчиков. Вы узнаете, как заполнить атрибут alt, чтобы изображение было доступным, и какой альтернативный текст нужен каждому типу картинок. Для каждого типа есть пример HTML. Отдельно я покажу настройки в WordPress.
- У каждого изображения должен быть атрибут
alt. Что в нём писать, зависит от назначения картинки [1]. - Декоративные изображения получают пустой
alt="". Тогда скринридер их пропускает [2]. - Если картинка — единственное содержимое ссылки или кнопки, alt-текст называет цель ссылки или действие [3].
- В WordPress alt-текст в блоке «Изображение» действует только для этой записи. Изображение записи (миниатюра), наоборот, по умолчанию берёт alt-текст из медиатеки [4], [5].
Что такое alt-текст (альтернативный текст)?
Alt-текст — это значение атрибута alt у элемента <img>. Полное название — альтернативный текст. В этой статье я пишу коротко: alt-текст.
Alt-текст — это текстовая версия изображения. Стандарт HTML предлагает простой тест. Замените каждую картинку её alt-текстом. Смысл страницы при этом не должен измениться [6].
Alt-текстом пользуются люди и программы:
- Скринридер. Он зачитывает alt-текст вслух. Так незрячий пользователь узнаёт, что показывает картинка или что она делает [7].
- Брайлевский дисплей. Он выводит alt-текст шрифтом Брайля [7].
- Голосовое управление. Пользователь произносит alt-текст ссылки-картинки или кнопки. Так одной командой он ставит фокус на этот элемент [7].
- Медленный интернет. Если картинки отключены или сеть слабая, человек видит текст вместо изображения [6], [8].
- Поисковые системы. Google по alt-тексту понимает, что изображено на картинке [8].
Alt-текст — это не подпись к изображению. По стандарту HTML заголовок, легенда или подпись никогда не должны стоять в атрибуте alt [6]. Подпись стоит в элементе <figcaption> и видна всем. Alt-текст заменяет само изображение.
Что требуют WCAG и BFSG от alt-текста
Правило задаёт критерий успеха 1.1.1 «Нетекстовый контент» стандарта WCAG 2.2, уровень A. Любой нетекстовый контент, который страница показывает пользователю, должен иметь текстовую альтернативу, которая служит той же цели [1]. У критерия есть несколько исключений. Для изображений главное исключение — чисто декоративные картинки. Их нужно встраивать так, чтобы вспомогательные технологии могли их пропустить [1].
В Германии требования к доступности сайтов задаёт Закон об усилении доступности (Barrierefreiheitsstärkungsgesetz, BFSG). Это немецкая реализация Европейского акта о доступности (EAA). По § 4 BFSG действует презумпция соответствия для гармонизированных стандартов, ссылки на которые опубликованы в Официальном журнале ЕС [9]. Для BFSG такой стандарт в Официальном журнале пока не опубликован [10]. Для сайтов профессиональным ориентиром служит стандарт EN 301 549. Его новая версия V4.1.1 от сентября 2026 года — первая, разработанная для Европейского акта о доступности. Она опирается на WCAG 2.2 [11], [12].
Презумпцию соответствия эта версия даст только тогда, когда ЕС сошлётся на неё в Официальном журнале [11]. До этого, по данным AccessibleEU, общепринятым ориентиром остаётся версия V3.2.1 [12]. Обе версии включают критерий 1.1.1 для веб-страниц в раздел 9.1.1.1 [11], [13]. Подробнее о правовой стороне читайте в обзоре Закона об усилении доступности.
Второй критерий касается текста на изображениях. По WCAG 1.4.5 (уровень AA) используйте настоящий текст вместо картинок с текстом, если технология это позволяет [14]. Исключений два. Первое: пользователь может сам настроить такое изображение. Второе: конкретный вид текста принципиально важен. Для логотипов вид текста считается принципиально важным [14].
Alt-текст для изображений: пять типов картинок
W3C делит изображения по их назначению [7]. Красива ли картинка, значения не имеет. Вопрос один: чего не хватит пользователю, если картинки не будет?
Информативные изображения
Информативное изображение передаёт информацию, которой нет в тексте. Alt-текст пересказывает эту информацию одной короткой фразой [15]. Опишите то, что важно для этой страницы.
<!-- Фото товара в магазине: покупателю важны цвет и материал -->
<img src="stuhl-eiche.jpg" alt="Обеденный стул из светлого дуба с серой тканевой обивкой" />
Декоративные изображения и alt=""
Изображение декоративное, если оно только украшает страницу. Декоративной считается и картинка, если та же информация уже есть в тексте рядом [16]. Такие изображения получают пустой alt="" [2].
Никогда не удаляйте атрибут полностью. Без него некоторые скринридеры зачитывают имя файла [16]. Пробела между кавычками тоже быть не должно [17]. Кроме того, у декоративного изображения не должно быть атрибута title [2]. Картинки, которые относятся к дизайну сайта, лучше подключать через CSS [6], [18].
<!-- Декоративная графика рядом с заголовком -->
<img src="welle.svg" alt="" />
Не уверены, декоративная ли Ваша картинка? Дерево решений для alt-текста ниже приведёт Вас к ответу за четыре вопроса.
Функциональные изображения в ссылках и кнопках
Изображение функциональное, если оно — единственное содержимое ссылки или кнопки. Тогда alt-текст описывает действие или цель ссылки [3], [6]. У лупы на кнопке поиска alt-текст «Найти», а не «Лупа». Логотип в шапке сайта часто ведёт на главную страницу. Поэтому его alt-текст называет компанию и цель ссылки [3].
<!-- Логотип как ссылка на главную страницу -->
<a href="/"><img src="logo.svg" alt="Muster GmbH, главная страница" /></a>
<!-- Кнопка-иконка без видимого текста -->
<button type="submit"><img src="lupe.svg" alt="Найти" /></button>
Здесь alt-текст становится доступным именем ссылки. Если в ссылке рядом с картинкой уже есть текст, который описывает цель ссылки, у изображения может быть alt="" [19].
Изображения с текстом
Если на картинке только текст, alt-текст содержит ровно этот текст [6], [20]. Шрифт и тени описывать не нужно. Так Вы выполняете критерий 1.1.1.
Но рекламный баннер в виде картинки всё равно нарушает WCAG 1.4.5 (уровень AA). Причина в том, что тот же текст можно показать средствами CSS [14]. Поэтому делайте такие баннеры из настоящего текста. Он остаётся чётким при увеличении, и пользователи могут менять его цвета [20]. На логотипы это правило не распространяется [14].
Если текст всё же остаётся на картинке, ему нужен достаточный контраст с фоном. Критерий 1.4.3 действует и для изображений текста [21]. Проверить значения можно в нашем калькуляторе контрастности по WCAG 2.2.
<!-- Выполняет 1.1.1, но нарушает 1.4.5 -->
<img src="sale-banner.png" alt="Летняя распродажа: скидка 20 % на всю садовую мебель до 31 августа" />
<!-- Лучше: настоящий текст, оформленный через CSS -->
<p class="sale-banner">Летняя распродажа: скидка 20 % на всю садовую мебель до 31 августа</p>
Сложные изображения: диаграммы и графики
В диаграммах, организационных схемах и картах слишком много информации для одной фразы. Здесь нужны две части [22]. Alt-текст коротко называет, что это за изображение. Подробное описание передаёт данные [23].
Подробное описание можно разместить прямо под изображением или на отдельной странице [24], [25]. Его можно также связать с картинкой через aria-describedby [22].
<figure>
<img
src="umsatz-2026.png"
alt="Столбчатая диаграмма: выручка по кварталам 2026 года. Подробности в таблице ниже."
/>
<table>
<!-- Данные диаграммы в виде настоящей таблицы -->
</table>
<!-- figcaption стоит первым или последним дочерним элементом figure -->
<figcaption>Выручка по кварталам 2026 года, тыс. евро</figcaption>
</figure>
Если несколько картинок вместе передают одну мысль, alt-текст для всей группы пишут только у одной из них [26]. Пример — рейтинг из пяти звёзд. Первая звезда получает alt-текст, например «3,5 из 5 звёзд». У остальных картинок — alt="" [26].
Дерево решений для alt-текста
W3C предлагает дерево решений для атрибута alt [27]. Для повседневной работы я сократил его до четырёх вопросов.
Открыть текстовое описание схемы «Дерево решений: какой alt-текст нужен моему изображению?»
Дерево решений за четыре вопроса приводит к подходящему alt-тексту.
- Изображение — единственное содержимое ссылки или кнопки?
- Да: alt-текст называет цель ссылки или действие.
- Нет: переходите к вопросу 2.
- На изображении есть текст, которого нет рядом?
- Да: alt-текст повторяет ровно этот текст.
- Нет: переходите к вопросу 3.
- Без изображения пользователь теряет информацию?
- Нет: изображение получает пустой атрибут alt.
- Да: переходите к вопросу 4.
- Информация умещается в одну короткую фразу?
- Да: достаточно короткого alt-текста.
- Нет: изображение получает короткий alt-текст и подробное описание.
Как писать хороший alt-текст: шесть правил
Типы изображений подсказывают, нужен ли картинке alt-текст. Эти правила помогут его сформулировать.
- Всё решает контекст. Одной и той же фотографии на двух страницах могут понадобиться два разных alt-текста [7]. На странице команды важно имя человека. В статье об оформлении офиса важно само помещение.
- Как можно короче. Alt-текст — это самое краткое описание назначения картинки [17]. Федеральный центр компетенций по доступности Германии (Bundesfachstelle Barrierefreiheit) формулирует это так: «Настолько подробно, насколько нужно, и настолько кратко, насколько возможно» [28]. WCAG 1.1.1 не задаёт точного числа символов [1]. Если нужно больше одной фразы, добавьте подробное описание [17].
- Без слов «картинка» и «фото». Слова «картинка», «фото» или «иконка» обычно лишние [17]. В моих тестах скринридер сам объявляет роль «изображение» или «графика».
- Без имён файлов и заглушек.
alt="IMG_4711.jpg"илиalt="Картинка"— это не альтернатива. WCAG прямо называет это ошибкой [29]. - Без переспама ключевыми словами. Набор ключевых слов пользователю ничем не поможет. Google может расценить такую страницу как спам [8].
- Со знаками препинания. Точки и запятые помогают при чтении вслух [17]. Если картинка стоит вплотную к тексту, не забудьте пробел в alt-тексте [17].
Атрибут title не заменяет alt-текст. Многие устройства и браузеры вообще не показывают title [4].
Как задать alt-текст в WordPress
В WordPress alt-текст хранится в двух местах: в медиатеке и в блоке «Изображение» в редакторе. Согласно документации WordPress, alt-текст в блоке действует только для картинки в этой записи [4]. Alt-текст из медиатеки — это значение по умолчанию при каждой новой вставке изображения [4].
Причина — в коде. Блок «Изображение» сохраняет alt-текст прямо в теге <img> внутри записи [30]. Если позже изменить текст в медиатеке, alt-текст в блоке останется прежним. Особенно это касается старых записей. В аудитах я часто вижу такую картину: в медиатеке всё заполнено, а у картинки в записи всё равно пустой alt.
С изображением записи (миниатюрой) всё иначе. WordPress выводит его функцией wp_get_attachment_image() [31]. Эта функция при каждой загрузке страницы берёт alt-текст из медиатеки [5]. Темы и плагины тоже могут использовать эту функцию. Поэтому для таких изображений заполняйте alt-текст в медиатеке.
Как задать alt-текст в блочном редакторе:
Выберите блок «Изображение»
Нажмите на картинку в редакторе. Справа откройте настройки блока. Если боковой панели нет, нажмите вверху на значок настроек [4].
Введите альтернативный текст
На вкладке содержимого в настройках блока есть поле для альтернативного текста [4]. Напишите текст под эту конкретную запись. Ссылка у поля (в английском интерфейсе: «Describe the purpose of the image») ведёт к дереву решений W3C [4].
Отметьте декоративные изображения
Если картинка только украшает страницу, включите на вкладке содержимого опцию для декоративных изображений (в английском интерфейсе «Mark as decorative») [4]. По дорожной карте эта опция входит в WordPress 7.1 [32]. Она очищает поле alt-текста, скрывает подпись и добавляет изображению role="none" [33].
Осторожно: имеющийся alt-текст и подпись при этом удаляются без предупреждения. Если снять галочку, они не вернутся [34]. Если в Вашей версии этой опции нет, оставьте поле alt-текста пустым. У декоративных изображений оставьте пустым и атрибут title в дополнительных настройках [2], [4].
Проверьте результат на сайте
Откройте страницу и найдите атрибут alt в исходном коде. В аудитах я вижу, что некоторые темы и плагины меняют вывод. Значение имеет только результат в браузере.
Если Вы работаете с конструктором страниц, у каждого виджета изображения свои правила. Подробности — в руководствах по Elementor и Divi. Общий обзор даёт статья Доступность сайта на WordPress.
Alt-текст от ИИ: помощь с ограничениями
Современные модели ИИ описывают картинки в один клик [35]. Для большой медиатеки это экономит время. Но ИИ обычно видит только изображение, а не Вашу страницу.
Назначение картинки зависит от контекста [7]. Этот вопрос изучало исследование с научной конференции ASSETS 2024. В 2024 году типичные инструменты описывали изображения без учёта контекста страницы [35]. Участники исследования — 12 незрячих и слабовидящих людей — оценили описания с учётом контекста заметно выше [35].
Американский фонд слепых (American Foundation for the Blind) называет второй риск. Модели ИИ иногда придумывают детали, которых на картинке нет [36]. Незрячий пользователь не может это проверить.
Поэтому используйте ИИ только для черновика. Проверяйте каждый вариант по этим вопросам:
- Изображение декоративное? Тогда удалите вариант и поставьте
alt="". - Изображение — единственное содержимое ссылки или кнопки? Тогда alt-текст называет цель ссылки, а не то, что изображено.
- Все ли детали верны? Название товара, цвет и цифры проверьте сами.
- Подходит ли текст к этой записи? ИИ не знает Вашей страницы.
Alt-текст и SEO
Google называет alt-текст самым важным атрибутом метаданных изображения [8]. Google использует его вместе с распознаванием изображений и содержимым страницы [8]. Если картинка служит ссылкой, alt-текст работает как текст анкора [8].
Google советует писать полезные описания в контексте страницы и использовать ключевые слова умеренно [8]. Это то же правило, что и для доступности. Хороший alt-текст для скринридера — это и хороший alt-текст для Google.
Одно отличие касается имени файла. Google рекомендует короткие и описательные имена файлов [8]. Назовите файл, например, esszimmerstuhl-eiche.jpg («обеденный стул, дуб»), а не IMG00023.jpg. Но имя файла никогда не должно попадать в атрибут alt [29].
Как проверить alt-тексты на Вашем сайте
Изображения без alt-текста встречаются очень часто. Исследование WebAIM 2026 года охватило миллион главных страниц сайтов. На 53,1 % из них хотя бы у одного изображения не было alt-текста [37]. В целом alt-текста не было у 16,2 % всех изображений [37].
Ещё у 10,8 % изображений с alt-текстом он был сомнительным или дублировался [37]. Примеры — «image», имя файла или тот же текст, что стоит рядом [37].
Пропущенные атрибуты alt можно найти с помощью инструмента. Наша бесплатная проверка BFSG ищет их на одной странице Вашего сайта, например на главной. Подходит ли alt-текст к назначению картинки, можно проверить только вручную. Инструмент не знает контекста страницы и не видит, декоративная ли картинка.
Такую ручную проверку я делаю в аудите по WCAG 2.2. Если alt-текстов нет во многих записях, я возьму на себя и устранение барьеров на Вашем текущем сайте WordPress. Как выглядит такое замечание по критерию 1.1.1, показывает пример отчёта об аудите. Оверлей-плагины эту проблему не решают. Почему, я объясняю в статье об оверлеях и BFSG.
Часто задаваемые вопросы (FAQ)
Нужен ли alt-текст каждому изображению?
Каждому изображению нужен атрибут alt. Информативные и функциональные изображения получают текст [1]. Декоративные получают пустой alt="", чтобы скринридер их пропустил [2]. Если нет ни атрибута alt, ни aria-label, ни aria-labelledby, ни title, это ошибка по WCAG [38]. И всё же всегда ставьте alt. Это самое надёжное решение.
Какой длины должен быть alt-текст?
WCAG не задаёт точного ограничения [1]. W3C советует самое краткое описание назначения картинки [17]. Обычно хватает одной короткой фразы. Если нужно больше, остальное вынесите в подробное описание рядом с изображением [22].
Чем alt-текст отличается от подписи к изображению?
Подпись видят все пользователи под картинкой. Alt-текст заменяет картинку, когда её не видно. По стандарту HTML подпись никогда не должна стоять в атрибуте alt [6].
Как добавить alt-текст в WordPress?
В блочном редакторе выберите изображение и откройте настройки блока. На вкладке содержимого есть поле для альтернативного текста [4]. В блоке «Изображение» текст из медиатеки служит только начальным значением при вставке [4]. Изображение записи, наоборот, по умолчанию берёт alt-текст прямо из медиатеки [5], [31].
Можно ли писать alt-тексты с помощью ИИ?
Да, как черновик. Но ИИ не знает контекста Вашей страницы [35]. Он также может придумать детали [36]. Поэтому проверьте каждый вариант сами, прежде чем публиковать.
Отказ от ответственности
Материалы этой статьи подготовлены добросовестно и служат только для общего информирования. Они не являются юридической консультацией и не заменяют индивидуальную консультацию юриста с учётом Вашей ситуации.
Мы не гарантируем точность, полноту и актуальность информации. Любые действия на основе этих материалов Вы совершаете на свой страх и риск.