Доступная форма Contact Form 7: шаблон, ошибки, капча
Информация о статье

Автор: Дмитрий Дугарев
Вы собираете формы в Contact Form 7 и хотите понять, доступны ли они. Сделать доступную форму Contact Form 7 можно, но само собой это не произойдёт. Подписи полей, группы и подсказки Вы прописываете в шаблоне формы сами. Я изучил исходный код версии 6.1.7 и покажу, что именно нужно добавить.
- Contact Form 7 ставит текстовым полям и спискам атрибуты
aria-requiredиaria-invalid. Для скринридеров есть область со статусом отправки [1], [2]. - Подписей (
label),fieldsetи видимых пометок обязательных полей нет, пока Вы не впишете их в шаблон. - Плагин не переводит фокус на первую ошибку и блокирует кнопку до согласия. Оба пункта легко исправить.
- Для защиты от спама без головоломок подойдут Honeypot, Akismet или Turnstile. От капчи с картинкой откажитесь.
Что Contact Form 7 делает правильно из коробки
По данным WordPress.org, у Contact Form 7 более 10 миллионов активных установок [3]. Плагин превращает теги формы вроде [text* your-name] в HTML-поля. Часть этого кода уже помогает скринридерам.
- Обязательные поля: текстовые поля, поля e-mail,
textarea, выпадающие списки и поля даты со звёздочкой получаютaria-required="true"[1], [4], [5], [6]. - Состояние ошибки: у этих полей и у чекбокса согласия есть
aria-invalid. При ошибке значение меняется наtrue[1], [7], [8]. - Текст ошибки у поля: через
aria-describedbyполе ссылается на свою запись в невидимом списке ошибок [8]. - Статус отправки: над формой есть невидимая область с
role="status"иaria-live="polite"[2]. После отправки туда попадает сообщение [9]. - Название формы: элемент
formполучаетaria-label. Вы задаёте его атрибутом шорткодаhtml_title[2], [10]. Без атрибута там стоит переведённый стандартный текст, в немецкой версии «Kontaktformular» («Контактная форма») [2], [11].
Видимый текст ошибки помечен aria-hidden="true" [8]. Скринридер всё равно прочитает ошибку. aria-describedby указывает на тот же текст в невидимом списке ошибок [8]. Так пользователь слышит его только один раз.
Область статуса соответствует WCAG 4.1.3 [12].
Где у Contact Form 7 пробелы
На аудитах я раз за разом встречаю одни и те же пробелы. Большинство из них возникает в шаблоне, а не в самом плагине.
Поля без подписи
Тег формы создаёт только поле ввода, без label. Стандартный шаблон оборачивает каждое поле в label [13]. Но во многих шаблонах я вижу вместо подписи только плейсхолдер.
Но плейсхолдер не заменяет подпись. Скринридеры не воспринимают его как название поля [14]. WCAG 3.3.2 требует подписи или инструкции, если пользователь должен что-то ввести [15].
Радиокнопки без группы
Плагин выводит радиокнопки и чекбоксы в span, а не в fieldset [16]. Скринридер тогда не озвучивает вопрос группы. Отдельные варианты попадают в label, только если задать опцию use_label_element [16].
W3C советует всегда объединять радиокнопки в fieldset [17]. Без группы легко нарушить WCAG 1.3.1 [18].
Кроме того, группы чекбоксов и радиокнопок не получают ни aria-required, ни aria-invalid [16]. aria-describedby с текстом ошибки привязан к внешнему span, а не на вариантах [8], [16]. Когда фокус стоит на варианте, текста ошибки в его описании нет.
Фокус не переходит к первой ошибке
После неудачной отправки фокус остаётся на кнопке. В исходном коде версии 6.1.7 я не нашёл кода, который переводит фокус к первой ошибке [8], [9]. Скринридер озвучивает только общее сообщение. Поле с ошибкой пользователю приходится искать самому.
Невидимые ссылки в списке ошибок
Невидимый список ошибок содержит ссылки на поля, если у полей есть ID [8]. Плагин скрывает этот список только визуально [19]. Поэтому пользователи клавиатуры попадают на эти ссылки клавишей Tab, но не видят фокуса. Проверьте это в своей форме после ошибки: WCAG 2.4.7 требует видимого фокуса [20].
Неверный язык формы
При создании формы Contact Form 7 сохраняет язык и пишет его в атрибут lang внешнего контейнера [2]. Если форму создали в админке на английском, над немецкими подписями может стоять lang="en-US". Скринридер выбирает произношение по этому атрибуту, и немецкие тексты звучат неправильно [21]. Это касается WCAG 3.1.2 [22].
Доступная контактная форма WordPress: шаблон для Contact Form 7
Вот как собрать доступную контактную форму в WordPress на Contact Form 7.
Свяжите подпись с полем через for и id
Задайте каждому полю постоянный ID опцией id:. Атрибут for у label указывает ровно на этот ID [23]. К тому же невидимый список ошибок ссылается на поле, только если у поля есть ID [2], [8].
Учтите два исключения. ID, которые начинаются с «wpcf7», плагин не выводит [24]. ID, который уже есть на странице, он тоже не выводит [24]. Если Вы вставили одну и ту же форму на страницу дважды, например в контент и в футер, поля второй копии теряют подписи.
Покажите, какие поля обязательны
aria-required помогает только пользователям скринридеров. Остальным нужна видимая пометка в подписи. Объясните звёздочку один раз в начале формы [25]. Техника H90 также показывает, как сделать звёздочку крупнее: людям со слабым зрением её трудно разглядеть [25].
autocomplete для личных данных
Полям для имени, e-mail или телефона нужен подходящий autocomplete [26]. В Contact Form 7 для этого добавьте в тег опцию, например autocomplete:name [13]. Тогда браузер заполнит поля сам [27].
Шаблон доступной формы обратной связи
Скопируйте этот шаблон во вкладку «Форма» (Form) и поменяйте тексты и ссылки под себя. Тексты здесь на русском для наглядности. На сайте для немецкоязычных клиентов пишите их на языке сайта.
<p>Поля со звёздочкой * обязательны.</p>
<p><label for="cf7-name">Имя *</label>
[text* your-name id:cf7-name autocomplete:name]</p>
<p><label for="cf7-email">E-mail *</label>
[email* your-email id:cf7-email autocomplete:email]</p>
<p><label for="cf7-phone">Телефон (необязательно)</label>
[tel your-phone id:cf7-phone autocomplete:tel]</p>
<p><label for="cf7-company">Компания (необязательно)</label>
[text your-company id:cf7-company autocomplete:organization]</p>
<fieldset>
<legend>Как с Вами связаться?</legend>
[radio contact-method use_label_element default:1 "По e-mail" "По телефону"]
</fieldset>
<p><label for="cf7-message">Ваше сообщение *</label>
[textarea* your-message id:cf7-message]</p>
[acceptance consent id:cf7-consent] Я прочитал(а) <a href="/datenschutz">политику конфиденциальности</a>. * [/acceptance]
[turnstile]
[submit "Отправить сообщение"]
Текст согласия внутри тега [acceptance] плагин сам оборачивает в label [7]. Подробнее о структуре и тестах читайте в паттерне доступной формы.
При вставке задайте форме собственное название. Атрибут html_title становится aria-label формы [2], [10].
[contact-form-7 id="…" html_title="Контактная форма"]
Не блокируйте кнопку отправки
Contact Form 7 блокирует кнопку отправки, пока посетитель не отметит согласие [28]. Почему отправить нельзя, пользователь не узнаёт. Заблокированная кнопка без объяснения — это барьер.
Поэтому добавьте во вкладку «Дополнительные настройки» (Additional Settings) эту строку [7], [11]:
acceptance_as_validation: on
Теперь кнопка остаётся активной [28]. Если согласия нет, у поля появляется обычная ошибка [7].
Переведите фокус на первую ошибку
После неудачной отправки Contact Form 7 вызывает на форме событие wpcf7invalid [9]. Но событие срабатывает раньше, чем плагин выводит ошибки у полей [9]. Поэтому код откладывает поиск на один такт через setTimeout. Затем он ищет первый элемент с классом wpcf7-not-valid [8].
document.addEventListener('wpcf7invalid', (event) => {
const form = event.target;
setTimeout(() => {
const first = form.querySelector('.wpcf7-not-valid');
if (!first) return;
const control = first.matches('input, textarea, select')
? first
: first.querySelector('input, textarea, select');
control?.focus();
}, 0);
});
В группах чекбоксов и радиокнопок этот класс получает внешний span [8], [16]. Тогда код ставит фокус на первый вариант группы. Скринридер называет подпись, а у текстовых полей ещё и состояние ошибки. Все шаги подробно описаны в инструкции по доступной контактной форме.
Понятные сообщения об ошибках
Тексты сообщений Вы меняете во вкладке «Сообщения» (Messages) [11]. Contact Form 7 использует одно сообщение на тип ошибки, а не на поле [13]. В английском оригинале сообщение о пустом обязательном поле звучит так: «Please fill out this field.» [13]. В немецком переводе: «Bitte fülle dieses Feld aus.» («Пожалуйста, заполни это поле») [11].
Значит, сообщение не называет поле. Если не заполнены три поля, в невидимом списке ошибок трижды стоит одна и та же фраза [8]. Поэтому и нужен код для фокуса из раздела выше. Он ставит фокус на поле, и скринридер называет его подпись.
И всё же пишите сообщения ясно и дружелюбно. Например: «Это обязательное поле пустое. Пожалуйста, заполните его». По WCAG 3.3.1 ошибка должна быть описана текстом [29].
Показывайте ошибку не только цветом
Contact Form 7 выводит текст ошибки под полем цветом #dc3232 [19]. По моим расчётам, на белом фоне это даёт контрастность 4,6 : 1. WCAG 1.4.3 требует для обычного текста не меньше 4,5 : 1 [30]. Поэтому на светло-сером фоне контрастности быстро перестаёт хватать.
Красную рамку вокруг поля плагин не ставит [19]. Если Ваша тема при ошибке меняет только цвет рамки, по WCAG 1.4.1 этого недостаточно [31]. Контрастность текстов ошибок в Вашей теме проверьте калькулятором контрастности.
Капча и защита от спама: что остаётся доступным
Классическая капча отсекает многих людей с инвалидностью. W3C описывает проблемы для незрячих, глухих людей и людей с когнитивными нарушениями [32]. В первую очередь W3C советует способы без участия пользователя, например honeypot и спам-фильтры [32]. WCAG 1.1.1 требует, чтобы у капчи были альтернативы для разных органов чувств [33].
| Способ | Что делает пользователь | Моя оценка |
|---|---|---|
| Honeypot | ничего | хороший первый выбор |
| Akismet | ничего | хорошо, никаких заданий |
| reCAPTCHA v3 | ничего | можно, если изменить сообщение о спаме |
| Turnstile | обычно ничего, иногда один клик | можно, проверьте чекбокс |
| Контрольный вопрос | отвечает на вопрос | только как крайняя мера |
| Капча с картинкой | вводит символы с картинки | избегать |
Honeypot и Akismet
Honeypot — это скрытое поле, которое заполняют только боты. W3C называет его альтернативой, которую предлагают несколько плагинов WordPress [32]. С Akismet Contact Form 7 интегрируется напрямую [3].
Для Contact Form 7 есть отдельный плагин Honeypot. В версии 1.11 в нём добавили недостающую подпись к скрытому полю и отключили для него autocomplete [34].
reCAPTCHA v3 и Turnstile
reCAPTCHA v3 не показывает никаких заданий. Для каждого запроса она выдаёт оценку от 0,0 до 1,0 [35]. Как реагировать на низкую оценку, Google оставляет решать сайту [35].
В Contact Form 7 оценка 0,5 и ниже считается спамом [36], [37]. Посетитель тогда видит только общее сообщение «There was an error trying to send your message» («При отправке сообщения произошла ошибка») [13]. В немецком переводе: «Beim Versuch, deine Nachricht zu senden, ist ein Fehler aufgetreten» [11]. Живой человек с низкой оценкой так и не сможет отправить сообщение.
Перепишите это сообщение во вкладке «Сообщения». Укажите в нём e-mail или телефон как запасной способ связи. Порог оценки меняется фильтром wpcf7_recaptcha_threshold [37].
Cloudflare заявляет, что Turnstile соответствует WCAG 2.2 AA [38]. В режиме «Managed» посетителю иногда нужно отметить чекбокс [39]. Проверьте этот случай с клавиатурой и скринридером.
Поставьте тег [turnstile] прямо перед кнопкой отправки. Без тега Contact Form 7 выводит виджет в начале формы [40]. Тогда проверка оказывается перед первым полем. Пользователь клавиатуры попадает на неё ещё до заполнения формы. Прямо перед кнопкой проверка логичнее вписывается в порядок действий.
Оба сервиса могут передавать поставщику сервиса персональные данные, например IP-адрес [3].
Контрольный вопрос и капча с картинкой
Тег [quiz] задаёт контрольный вопрос, на который пользователь должен ответить [41]. W3C предупреждает: такие вопросы создают серьёзные препятствия для людей с нарушениями речи, трудностями в обучении или когнитивными нарушениями [32]. Даже простые арифметические задачи трудны для людей с дискалькулией [32].
Поэтому используйте контрольный вопрос только как крайнюю меру, если Honeypot и Akismet не справляются. Задайте тогда очень простой вопрос без вычислений. Капчу с искажёнными символами я не ставлю ни в одну форму.
Когда лучше подойдёт другой плагин форм
Собрать доступную контактную форму в WordPress на Contact Form 7 получится, если в команде кто-то пишет HTML. Если много форм собирают редакторы без знания HTML, часто лучше подойдёт плагин с готовой структурой.
Gravity Forms называет своей целью WCAG 2.1 AA [42]. С версии 2.5 поля с несколькими полями ввода выводятся в fieldset с legend [42]. Но производитель также подчёркивает: ответственность за доступность всегда остаётся на владельце сайта [42]. Обзор решений Вы найдёте в статье Плагины доступности для WordPress.
Дополнительный плагин «Contact Form 7: Accessible Defaults» даёт готовые шаблоны для новых форм. Существующие формы он не меняет [43]. К тому же WordPress.org предупреждает: автор не тестировал его с тремя последними основными версиями WordPress [43].
Как проверить свою форму
- Заполните форму только с клавиатуры. Каждое поле и чекбокс капчи должны быть доступны с клавиатуры.
- Отправьте пустую форму. Проверьте, куда переходит фокус и что говорит скринридер.
- Затем нажимайте Tab с начала страницы. Проверьте, не попадает ли фокус на невидимые ссылки.
- Проверьте в исходном коде атрибут
langу контейнераdiv.wpcf7. - Прослушайте группы радиокнопок в NVDA или VoiceOver. Скринридер должен озвучить вопрос группы.
Все пункты проверки собраны в чек-листе доступных форм. Как взаимодействуют форма, тема и конструктор страниц, показывает руководство Доступный сайт на WordPress.
Бесплатная проверка BFSG автоматически, хотя бы частично, проверяет 20 из 55 критериев. Остальные 35 можно проверить только вручную: инструмент не может оценить смысл и удобство управления. Поэтому фокус после ошибки я проверяю руками в базовом аудите (Basis-Audit). По запросу я беру на себя и устранение барьеров в Вашей теме, без перезапуска сайта.
Contact Form 7 и BFSG
Закон об усилении доступности (Barrierefreiheitsstärkungsgesetz, BFSG) — немецкая реализация Европейского акта о доступности (EAA). Он действует с 28 июня 2025 года [44]. Под него подпадают «услуги в сфере электронной коммерции» по § 1 абз. 3 п. 5 BFSG [44]. Имеются в виду цифровые услуги на сайтах и в приложениях, которые ведут к заключению договора с потребителем (§ 2 п. 26 BFSG) [44].
Подпадает ли под закон Ваш сайт, покажет проверка применимости BFSG. Подробнее — в статье о том, кому нужен доступный сайт. Если сайт подпадает под закон, на аудите я проверяю контактную форму, как и любую другую функцию, по WCAG 2.2 уровня AA [45].
Часто задаваемые вопросы (FAQ)
Доступен ли Contact Form 7 для людей с инвалидностью?
Частично. Плагин ставит текстовым полям и спискам aria-required и aria-invalid и сообщает статус отправки скринридерам [1], [2]. Подписи, группы и фокус на ошибке Вы добавляете сами.
Как сделать доступную форму в WordPress?
Дайте каждому полю видимую подпись. Объедините радиокнопки в fieldset с legend [17]. Видимо пометьте обязательные поля и описывайте ошибки текстом [29]. Проверьте результат с клавиатурой и скринридером.
Должна ли форма Contact Form 7 быть доступной по BFSG?
Это зависит от Вашего сайта, а не от плагина. BFSG распространяется на услуги в сфере электронной коммерции (§ 1 абз. 3 п. 5 BFSG) [44]. Если Ваша форма ведёт к договору с потребителем, например через запрос или заказ, она может подпадать под закон (§ 2 п. 26 BFSG) [44].
Микропредприятия (Kleinstunternehmen), которые оказывают услуги, освобождены от требований (§ 3 абз. 3 BFSG) [44]. Подробности — на странице Исключение для микропредприятий. Насколько далеко обязанность распространяется в Вашем случае, покажет проверка применимости BFSG. В спорных случаях уточните у юриста.
Доступна ли reCAPTCHA для людей с инвалидностью?
reCAPTCHA v3 не показывает заданий [35]. Но в Contact Form 7 низкая оценка блокирует сообщение, и посетитель видит только общее сообщение об ошибке [13], [36]. Укажите в этом сообщении другой способ связи. W3C в первую очередь советует способы без участия пользователя, например honeypot [32].
Отказ от ответственности
Эта статья носит информационный характер и не является юридической консультацией. Сведения о Contact Form 7 относятся к исходному коду версии 6.1.7. Сведения о других сервисах актуальны на сентябрь 2026 года. Я не несу ответственности за точность и полноту информации.