Улучшить эту документацию ngAria
Установка
Сначала загрузите файл:
- Google CDN например,
"//ajax.googleapis.com/ajax/libs/angularjs/X.Y.Z/angular-aria.js"
- NPM например,
npm install --save angular-aria@X.Y.Z
илиyarn add angular-aria@X.Y.Z
- Bower например,
bower install angular-aria#X.Y.Z
- code.angularjs.org (не рекомендуется для использования в продакшене) например,
"//code.angularjs.org/X.Y.Z/angular-aria.js"
где X.Y.Z — версия AngularJS, которую вы используете.
Затем добавьте angular-aria.js в свой HTML:
<script src="path/to/angular.js"></script> <script src="path/to/angular-aria.js"></script>
Наконец, загрузите модуль в ваше приложение, добавив его как зависимый модуль:
angular.module('app', ['ngAria']); После этого вы готовы приступить к работе!
Модуль ngAria обеспечивает поддержку общих атрибутов ARIA, которые передают состояние или семантическую информацию о приложении для пользователей вспомогательных технологий, таких как программы-экранные читатели.
Использование
Для того, чтобы ngAria начал работать, просто включите модуль ngAria в качестве зависимости. Поддерживаются следующие директивы: ngModel, ngChecked, ngReadonly, ngRequired, ngValue, ngDisabled, ngShow, ngHide, ngClick, ngDblClick, и ngMessages.
Ниже приведён более подробный обзор атрибутов, обрабатываемых ngAria:
| Директива | Поддерживаемые атрибуты |
|---|---|
| ngModel | aria-checked, aria-valuemin, aria-valuemax, aria-valuenow, aria-invalid, aria-required, input roles |
| ngDisabled | aria-disabled |
| ngRequired | aria-required |
| ngChecked | aria-checked |
| ngReadonly | aria-readonly |
| ngValue | aria-checked |
| ngShow | aria-hidden |
| ngHide | aria-hidden |
| ngDblclick | tabindex |
| ngMessages | aria-live |
| ngClick | tabindex, событие keydown, роль button |
Дополнительную информацию о каждой директиве можно найти в Руководстве разработчика ngAria.
Использование ngDisabled с ngAria:
<md-checkbox ng-disabled="disabled">
Преобразуется в:
<md-checkbox ng-disabled="disabled" aria-disabled="true">
Отключение атрибутов
Можно отключить отдельные атрибуты, добавленные ngAria, с помощью метода config. Более подробная информация представлена в Руководстве разработчика.
Компоненты модуля
Провайдер
| Имя | Описание |
|---|---|
| $ariaProvider |
Используется для настройки атрибутов ARIA, которые вводятся и управляются ngAria. |
Сервис
| Имя | Описание |
|---|---|
| $aria |
© 2010–2018 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.6.9/docs/api/ngAria