Улучшить эту документацию 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:

Дополнительную информацию о каждой директиве можно найти, прочитав Руководство для разработчиков ngAria.

Использование ngDisabled с ngAria:

<md-checkbox ng-disabled="disabled">

Преобразуется в:

<md-checkbox ng-disabled="disabled" aria-disabled="true">

Отключение определённых атрибутов

Можно отключить отдельные атрибуты, добавленные ngAria, с помощью метода config. Подробности см. в Руководстве для разработчиков.

Отключение ngAria для определённых элементов

Можно заставить ngAria пропустить определённый элемент, добавив атрибут ng-aria-disable к нему. Обратите внимание, что будет пропущен только сам элемент (а не его дочерние элементы).