{"componentChunkName":"component---src-templates-docs-js","path":"/docs/accessibility.html","result":{"data":{"markdownRemark":{"html":"

Что такое доступность контента?

\n

Доступность контента — это специальные технические и архитектурные решения, которые помогают людям с ограниченными возможностями использовать сайты. Применение таких решений необходимо для интерпретации страниц техническими средствами реабилитации, встроенными в операционные системы и браузеры. Термин «доступность контента» также может обозначаться аббревиатурой a11y.

\n

React поддерживает создание сайтов c доступным контентом в том числе с помощью стандартных возможностей HTML.

\n

Стандарты и руководства

\n

Руководство по обеспечению доступности контента (WCAG)

\n

Руководство по обеспечению доступности контента (WCAG), разработанное консорциумом W3C, описывает рекомендации по созданию сайтов с доступным контентом.

\n

Также есть ресурсы с чек-листами требований WCAG, например:

\n\n

Доступность контента в веб-приложениях (WAI-ARIA)

\n

Свод правил по доступности контента в веб-приложениях (WAI-ARIA) — это документ, который посвящён реализации требований доступности контента при разработке JavaScript-программ и компонентов.

\n

Нужно отметить, что все HTML-атрибуты aria-* полностью поддерживаются в JSX. Несмотря на то, что большинство DOM-свойств и атрибутов в React пишутся в стиле camelCase, атрибуты aria-* должны быть написаны с разделением дефисами. Такой стиль ещё известен как шашлычная нотация (kebab-case) или в стиле языка Лисп (lisp-case). Вот как выглядит такое оформление в JSX:

\n
<input\n  type=\"text\"\n  aria-label={labelText}  aria-required=\"true\"  onChange={onchangeHandler}\n  value={inputValue}\n  name=\"name\"\n/>
\n

Семантическая вёрстка

\n

Семантическая вёрстка — это основа доступности контента в веб-приложениях. Используя различные HTML-элементы можно улучшить восприимчивость и понятность ваших сайтов. Это позволяет сделать контент доступным без особых усилий.

\n\n

Бывают случаи, когда семантическая вёрстка нарушается. Например, при добавлении элемента <div> в JSX для обеспечения работоспособности кода на React. Особенно часто это случается при работе со списками (<ol>, <ul>, <dl>) или таблицами (<table>). В такой ситуации рекомендуется использовать фрагменты, чтобы сгруппировать элементы, как это показано в примере:

\n
import React, { Fragment } from 'react';\nfunction ListItem({ item }) {\n  return (\n    <Fragment>      <dt>{item.term}</dt>\n      <dd>{item.description}</dd>\n    </Fragment>  );\n}\n\nfunction Glossary(props) {\n  return (\n    <dl>\n      {props.items.map(item => (\n        <ListItem item={item} key={item.id} />\n      ))}\n    </dl>\n  );\n}
\n

Коллекцию элементов можно преобразовать в массив фрагментов или любых других элементов:

\n
function Glossary(props) {\n  return (\n    <dl>\n      {props.items.map(item => (\n        // При отображении коллекций фрагменты обязательно должны иметь атрибут `key`\n        <Fragment key={item.id}>          <dt>{item.term}</dt>\n          <dd>{item.description}</dd>\n        </Fragment>      ))}\n    </dl>\n  );\n}
\n

Если нет необходимости использовать пропсы, то можно применять сокращённую запись фрагментов:

\n
function ListItem({ item }) {\n  return (\n    <>      <dt>{item.term}</dt>\n      <dd>{item.description}</dd>\n    </>  );\n}
\n

Обратите внимание, что не все инструменты поддерживают сокращённую запись. Подробности в документации фрагментов.

\n

Доступность контента в формах

\n

Подписи

\n

Каждый элемент управления, например, <input> или <textarea>, должен иметь подпись, обеспечивающую доступность контента. Подписи нужно выполнять так, чтобы их могли использовать экранные считывающие устройства и другие технические средства реабилитации.

\n

Вот рекомендации о том, как это делать:

\n\n

Эти стандартные для HTML способы могут использоваться в React напрямую, однако не забывайте, что атрибут for в JSX записывается как htmlFor:

\n
<label htmlFor=\"namedInput\">Имя:</label><input id=\"namedInput\" type=\"text\" name=\"name\"/>
\n

Сообщения об ошибках

\n

Необходимо, чтобы ошибки и их причины были понятны всем пользователям. Далее приведены ресурсы, которые демонстрируют, как правильно воспроизводить текст сообщений об ошибках с помощью экранных считывающих устройств:

\n\n

Управление фокусом

\n

Приложение с доступным контентом должно функционировать при использовании только клавиатуры. Убедитесь, соответствует ли ваше приложение этому требованию:

\n\n

Фокус клавиатуры и контур элемента

\n

Фокус клавиатуры указывает на тот элемент в структуре DOM, который в данный момент готов принимать ввод с клавиатуры. Обычно такой элемент выделяется контуром, как это показано на рисунке:

\n\n \n \n \n \n \"Синий\n \n \n \n \n \n

Если вы заменяете стандартную реализацию фокуса своей, удалить контуры элементов можно с помощью CSS, установив outline: 0.

\n

Механизмы быстрого перехода к нужному контенту

\n

Также на сайте нужно реализовать механизмы, которые помогают пользователям быстро переходить к нужному контенту с помощью клавиатуры.

\n

Ссылки для быстрого перехода — это скрытые навигационные ссылки, которые становятся видимыми, когда пользователи взаимодействуют со страницей с помощью клавиатуры. Такие ссылки очень легко сделать, используя внутренние якоря страницы и CSS:

\n\n

Элементы семантической вёрстки, например, <main> или <aside>, нужно использовать в качестве секционной разметки, предназначенной для быстрого перехода между логическими частями сайта.

\n

Узнать больше о применении секционной разметки для улучшения доступности контента можно здесь:

\n\n

Программное управление фокусом

\n

React-приложения во время своей работы постоянно изменяют структуру DOM. Иногда из-за этого фокус клавиатуры может быть потерян или может перейти на неправильный элемент. Чтобы исправить такую ситуацию, нужно запрограммировать перевод фокуса клавиатуры на нужный элемент. Например, после закрытия модального окна перевести фокус клавиатуры на кнопку, которая его открыла.

\n

В статье на MDN рассматриваются способы навигации с клавиатуры в JavaScript.

\n

Чтобы управлять фокусом в React, можно использовать рефы на DOM-элементы.

\n

При таком подходе мы сначала создаём в классе компонента реф на элемент в JSX:

\n
class CustomTextInput extends React.Component {\n  constructor(props) {\n    super(props);\n    // Создаём реф для сохранения textInput-элемента    this.textInput = React.createRef();  }\n  render() {\n  // Используем колбэк-реф для связи DOM-элемента  // с конкретным экземпляром поля.    return (\n      <input\n        type=\"text\"\n        ref={this.textInput}      />\n    );\n  }\n}
\n

Теперь при необходимости можно установить фокус на этот элемент из любого места компонента:

\n
focus() {\n  // Устанавливаем фокус на текстовое поле, используя вызов низкоуровневого API DOM\n  // Внимание: мы обращаемся к свойству «current», чтобы получить DOM-элемент\n  this.textInput.current.focus();\n}
\n

Иногда родительскому компоненту нужно установить фокус на элемент дочернего компонента. Мы можем сделать это с помощью рефа на родительский компонент, который присваивается специальному свойству дочернего компонента и используется для ссылки из родительского компонента на DOM-элемент дочернего.

\n
function CustomTextInput(props) {\n  return (\n    <div>\n      <input ref={props.inputRef} />    </div>\n  );\n}\n\nclass Parent extends React.Component {\n  constructor(props) {\n    super(props);\n    this.inputElement = React.createRef();  }\n  render() {\n    return (\n      <CustomTextInput inputRef={this.inputElement} />    );\n  }\n}\n\n// Теперь при необходимости можно устанавливать фокус на поле `<input>`.\nthis.inputElement.current.focus();
\n

Если для расширения функциональности компонент оборачивается компонентом высшего порядка, то рекомендуется перенаправлять рефы обёрнутого компонента с помощью React-функции forwardRef. В случае, когда сторонний HOC не поддерживает перенаправление рефов, описанный выше подход всё равно можно использовать в качестве запасного варианта.

\n

Отличный пример управления фокусом показан в проекте react-aria-modal. Этот достаточно редкий случай реализации модального окна с полностью доступным контентом. В нём, кроме установки фокуса на кнопку отмены и перемещения фокуса внутри модальной формы, сделан возврат на элемент, инициировавший вызов модального окна. Нужно отметить, что первоначальная установка фокуса на кнопку отмены в модальном окне предотвращает случайное нажатие на клавиатуре кнопки подтверждения запрашиваемого действия.

\n
\n

Примечание:

\n

Правильное управление фокусом — это важный момент в обеспечении доступности контента, однако стоит применять его с умом.\nИспользуйте управление фокусом для восстановления нарушенной последовательности действий при работе с клавиатурой.\nНе стоит предугадывать желания пользователя и подталкивать его к каким-либо действиям в приложении.

\n
\n

Работа с событиями мыши

\n

Позаботьтесь, чтобы вся функциональность, связанная с событиями мыши, была доступна при работе только с клавиатурой. Если приложение сильно зависит от действий мыши, многие пользователи, которые используют только клавиатуру, не смогут работать с ним.

\n

Чтобы продемонстрировать это, рассмотрим подробный пример, когда доступность контента нарушается из-за ориентации только на щелчок мыши. В примере показан паттерн закрытия всплывающего списка при щелчке мышью за пределами этого элемента.

\n\"Реализация\n

Обычно такая функциональность реализуется событием click объекта window, обработчик которого закрывает выпадающий список:

\n
class OuterClickExample extends React.Component {\n  constructor(props) {\n    super(props);\n\n    this.state = { isOpen: false };\n    this.toggleContainer = React.createRef();\n\n    this.onClickHandler = this.onClickHandler.bind(this);\n    this.onClickOutsideHandler = this.onClickOutsideHandler.bind(this);\n  }\n\n  componentDidMount() {    window.addEventListener('click', this.onClickOutsideHandler);  }\n  componentWillUnmount() {\n    window.removeEventListener('click', this.onClickOutsideHandler);\n  }\n\n  onClickHandler() {\n    this.setState(currentState => ({\n      isOpen: !currentState.isOpen\n    }));\n  }\n\n  onClickOutsideHandler(event) {    if (this.state.isOpen && !this.toggleContainer.current.contains(event.target)) {      this.setState({ isOpen: false });    }  }\n  render() {\n    return (\n      <div ref={this.toggleContainer}>\n        <button onClick={this.onClickHandler}>Select an option</button>\n        {this.state.isOpen && (\n          <ul>\n            <li>Option 1</li>\n            <li>Option 2</li>\n            <li>Option 3</li>\n          </ul>\n        )}\n      </div>\n    );\n  }\n}
\n

Такой подход хорош для тех, кто использует мыши, тачпады или другие координатные устройства, однако для пользователей, работающих только с клавиатурой, он может стать причиной нарушения работы программы при попытке перехода к следующему элементу с помощью клавиши Tab. Причиной этого является то, что в данной ситуации объект window никогда не получит событие click. В итоге мы имеем заблокированную функциональность и невозможность продолжения работы с приложением.

\n\"Реализация\n

Подобное поведение можно получить используя обработчики сопутствующих событий, например, onBlur или onFocus:

\n
class BlurExample extends React.Component {\n  constructor(props) {\n    super(props);\n\n    this.state = { isOpen: false };\n    this.timeOutId = null;\n\n    this.onClickHandler = this.onClickHandler.bind(this);\n    this.onBlurHandler = this.onBlurHandler.bind(this);\n    this.onFocusHandler = this.onFocusHandler.bind(this);\n  }\n\n  onClickHandler() {\n    this.setState(currentState => ({\n      isOpen: !currentState.isOpen\n    }));\n  }\n\n  // Мы закрываем выпадающий список по таймеру setTimeout.  // Это нужно чтобы для дочерних элементов событие выделения  // происходило перед событием получения фокуса.  onBlurHandler() {    this.timeOutId = setTimeout(() => {      this.setState({        isOpen: false      });    });  }  // Не закрывать выпадающий список при получении фокуса дочерним элементом.\n  onFocusHandler() {    clearTimeout(this.timeOutId);  }  render() {\n    // React assists us by bubbling the blur and\n    // focus events to the parent.    return (      <div onBlur={this.onBlurHandler}\n           onFocus={this.onFocusHandler}>        <button onClick={this.onClickHandler}                aria-haspopup=\"true\"\n                aria-expanded={this.state.isOpen}>\n          Select an option\n        </button>\n        {this.state.isOpen && (\n          <ul>\n            <li>Option 1</li>\n            <li>Option 2</li>\n            <li>Option 3</li>\n          </ul>\n        )}\n      </div>\n    );\n  }\n}
\n

С этой программой можно работать и с помощью клавиатуры, и с помощью координатного устройства. Также в неё добавлены атрибуты aria-* для людей, использующих экранные считывающие устройства. Для упрощения примера, в нём не реализовано перемещение по списку с помощью стрелок на клавиатуре.

\n\"Теперь\n

Это один из множества случаев, когда поведение программы зависит только от положения курсора и событий мыши, а для пользователей, работающих с клавиатурой, её функциональность недоступна. Тестирование пользовательского интерфейса с помощью клавиатуры позволяет быстро найти проблемные места, работу которых можно улучшить, используя обработчики событий клавиатуры.

\n

Сложные компоненты

\n

Усложнение пользовательского интерфейса не должно ухудшать доступность контента. Несмотря на то, что лучший результат достигается при максимальном использовании синтаксиса HTML, даже очень сложный компонент можно сделать доступным для всех.

\n

В руководстве по доступности контента в веб-приложениях собраны все необходимые сведения о ролях ARIA, а также о состояниях и свойствах ARIA.\nОписанные в руководствах HTML-атрибуты полностью поддерживаются в JSX. Используя их можно создавать функционально нагруженные и при этом полностью доступные React-компоненты.

\n

Каждый тип компонентов имеет специфическую архитектуру и предполагает определённую функциональность, как для пользователей, так и для браузеров:

\n\n

На что ещё нужно обратить внимание

\n

Определение языка

\n

Обязательно указывайте язык текста на странице. Это необходимо для корректной установки опций экранных считывающих устройств:

\n\n

Заголовок страницы

\n

Всегда устанавливайте заголовок <title> для правильного описания контента текущей страницы. Это позволит пользователю постоянно быть в курсе контекста страницы:

\n\n

Реализовать эти требования в React можно с помощью компонента DocumentTitle.

\n

Цветовая контрастность

\n

Убедитесь, что все тексты на вашем сайте имеют правильную цветовую контрастность, чтобы обеспечить максимальное удобство чтения для пользователей с плохим зрением:

\n\n

Ручной расчёт правильных цветовых комбинаций для всех вариантов сайта может быть очень утомительным. Вместо этого вы можете рассчитать все необходимые палитры с помощью Colorable.

\n

Оба инструмента, aXe и WAVE, о которых будет рассказано ниже, включают тесты контрастности. Они помогут выявить ошибки в подборе цветов.

\n

Если вы хотите провести более полное тестирование контрастности, то можете воспользоваться этими программами:

\n\n

Инструменты для разработки и тестирования

\n

Далее перечислены инструменты, которые могут быть полезны при разработке веб-приложений с доступным контентом.

\n

Тестирование клавиатуры

\n

Самый простой и одновременно наиболее важный вид проверки — это тестирование клавиатуры. Такая проверка позволяет определить доступность контента на вашем сайте при работе только с клавиатурой. Чтобы протестировать клавиатуру, выполните следующие действия:

\n
    \n
  1. Отключите мышь.
    2. \n
  2. Используйте Tab и Shift+Tab для перемещения по странице.
    3. \n
  3. Используйте Enter для активации элементов.
    4. \n
  4. Там, где необходимо, используйте клавиши со стрелками, например, для работы с меню или выпадающими списками.
    5. \n
\n

Инструменты разработчика

\n

Выполнение некоторых требований по доступности контента можно контролировать непосредственно в JSX. Обычно среда разработки обладает средствами автоматической подстановки, которые могут использоваться при написании JSX для выбора ролей, состояний и свойств ARIA. Кроме этого можно воспользоваться следующими инструментами:

\n

eslint-plugin-jsx-a11y

\n

Плагин eslint-plugin-jsx-a11y для ESLint выполняет проверку абстрактного синтаксического дерева JSX на предмет поиска проблем, связанных с доступностью контента. Многие среды разработки могут интегрироваться с этим инструментом и выводить сообщения линтера в окно анализа кода или прямо в окно исходного кода.

\n

В Create React App этот плагин используется с заранее установленным набором правил. Если необходимо задействовать дополнительные правила, вам нужно создать в корне проекта файл .eslintrc со следующим кодом:

\n
{\n  "extends": ["react-app", "plugin:jsx-a11y/recommended"],\n  "plugins": ["jsx-a11y"]\n}
\n

Тестирование доступности контента в браузере

\n

Существуют инструменты для аудита доступности контента веб-страниц в браузере. Используйте их совместно с теми инструментами для проверки HTML, которые были описаны выше.

\n

aXe, aXe-core и react-axe

\n

Компания Deque Systems предлагает модуль aXe-core для автоматизированного и сквозного тестирования веб-приложений. Этот модуль имеет интеграцию с Selenium.

\n

На основе aXe-core разработан продукт компании Deque Systems под названием The Accessibility Engine или aXe. Это расширение для браузеров, предназначенное для комплексного тестирования доступности контента сайтов.

\n

Также вы можете использовать модуль react-axe для вывода сообщений от aXe в консоль в процессе программирования или отладки.

\n

WebAIM WAVE

\n

Web Accessibility Evaluation Tool ещё одно расширение для браузера, которое используется для улучшения доступности контента веб-сайтов.

\n

Инспекторы доступности контента и дерево доступности

\n

Дерево доступности — это подмножество DOM-дерева. В нём содержатся объекты, которые нужны для работы технологий поддержки доступности контента, например, для экранных считывающих устройств.

\n

В некоторых браузерах можно легко получить информацию обо всех элементах в дереве доступности:

\n\n

Экранные считывающие устройства

\n

Проверка работы экранных считывающих устройств должна быть частью комплексного тестирования доступности контента.

\n

Учтите, что сочетание браузера и экранного считывающего устройства имеет большое значение. Рекомендуется протестировать ваше приложение в том браузере, который лучше всего подходит для избранного вами экранного считывателя.

\n

Общедоступные экранные считыватели

\n

NVDA в Firefox

\n

NonVisual Desktop Access или NVDA — это широко распространённый экранный считыватель с открытым исходным кодом для Windows.

\n

Вот несколько руководств по работе с NVDA:

\n\n

VoiceOver в Safari

\n

VoiceOver — это экранный считыватель, встроенный в продукты Apple.

\n

Здесь приведены руководства по активации и использованию VoiceOver:

\n\n

JAWS в Internet Explorer

\n

Job Access With Speech or JAWS — это экранный считыватель, который чаще всего используется в Windows.

\n

Руководства по JAWS:

\n\n

Прочие экранные считыватели

\n

ChromeVox в Google Chrome

\n

ChromeVox — это встроенный экранный считыватель для ноутбуков Chromebook. Он доступен для Google Chrome в виде расширения.

\n

Ссылки на руководства по ChromeVox:

\n","frontmatter":{"title":"Доступность контента","next":null,"prev":null},"fields":{"path":"content/docs/accessibility.md","slug":"docs/accessibility.html"}}},"pageContext":{"slug":"docs/accessibility.html"}},"staticQueryHashes":[]}