Improve this Doc ngAria

Installation

First include angular-aria.js in your HTML:

<script src="angular.js">
<script src="angular-aria.js">

You can download this file from the following places:

• Google CDN
  e.g. //ajax.googleapis.com/ajax/libs/angularjs/X.Y.Z/angular-aria.js
• Bower
  e.g.

  bower install [email protected]

• code.angularjs.org
  e.g.

  "//code.angularjs.org/X.Y.Z/angular-aria.js"

where X.Y.Z is the AngularJS version you are running.

Then load the module in your application by adding it as a dependent module:

angular.module('app', ['ngAria']);

With that you're ready to get started!

The ngAria module provides support for common ARIA attributes that convey state or semantic information about the application for users of assistive technologies, such as screen readers.

Usage

For ngAria to do its magic, simply include the module ngAria as a dependency. The following directives are supported: ngModel, ngDisabled, ngShow, ngHide, ngClick, ngDblClick, and ngMessages.

Below is a more detailed breakdown of the attributes handled by ngAria:

Directive	Supported Attributes
ngDisabled	aria-disabled
ngShow	aria-hidden
ngHide	aria-hidden
ngDblclick	tabindex
ngMessages	aria-live
ngModel	aria-checked, aria-valuemin, aria-valuemax, aria-valuenow, aria-invalid, aria-required, input roles
ngClick	tabindex, keypress event, button role

Find out more information about each directive by reading the ngAria Developer Guide.

Using ngDisabled with ngAria:

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

Becomes:

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

Disabling Attributes

It's possible to disable individual attributes added by ngAria with the config method. For more details, see the Developer Guide.