Skip to content
This repository was archived by the owner on Apr 12, 2024. It is now read-only.

Commit 3bfeda3

Browse files
committed
docs(guide/migration): document a BC to ngAria (d06431e)
Closes #13949
1 parent 4fed66d commit 3bfeda3

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

docs/content/guide/migration.ngdoc

+21
Original file line numberDiff line numberDiff line change
@@ -114,6 +114,27 @@ Objects considered array-like include: arrays, array subclasses, strings, NodeLi
114114
jqLite/jQuery collections
115115

116116

117+
### ngAria
118+
119+
Due to [d06431e](https://github.com/angular/angular.js/commit/d06431e5309bb0125588877451dc79b935808134),
120+
the `ngAria`-enhanced directives (e.g. `ngModel`, `ngDisabled` etc) will not apply ARIA attributes
121+
to native inputs, unless necessary. Previously, ARIA attributes were always applied to native
122+
inputs, despite this being unnecessary in most cases.
123+
In the context of `ngAria`, elements considered "native inputs" include:
124+
`<a>`, `<button>`, `<details>`, `<input>`, `<select>`, `<summary>`, `<textarea>`
125+
126+
This change will not affect the accessibility of your applications (since native inputs are
127+
accessible by default), but if you relied on ARIA attributes being present on native inputs (for
128+
whatever reason), you'll have to add and update them manually.
129+
130+
Additionally, the `aria-multiline` attribute, which was previously added to elements with a `type`
131+
or `role` of `textbox`, will not be added anymore, since there is no way `ngAria` can tell if the
132+
textbox element is multiline or not.
133+
If you relied on `aria-multiline="true"` being automatically added by `ngAria`, you need to apply it
134+
yourself. E.g. change your code from `<div role="textbox" ng-model="..." ...>` to
135+
`<div role="textbox" ng-model="..." ... aria-multiline="true">`.
136+
137+
117138
### ngMessages (`ngMessage`)
118139

119140
Due to [4971ef12](https://github.com/angular/angular.js/commit/4971ef12d4c2c268cb8d26f90385dc96eba19db8),

0 commit comments

Comments
 (0)