Улучшить эту документацию 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. Обратите внимание, что игнорируется только сам элемент (а не его дочерние элементы).