diff --git a/index.html b/index.html index 41952b9db..9602c376d 100644 --- a/index.html +++ b/index.html @@ -1177,18 +1177,40 @@

Prohibited States and Properties

Allowed Accessibility Child Roles

- A list of roles which are allowed on an accessibility child of the element with this role. If the list is not empty, authors MUST only add accessibility children with - allowed roles. For example, an element with the role list allows accessibility children with the role listitem, but does not allow - accessibility children with the role option. If the list is empty, then there are no restrictions on accessibility child roles. + Roles which are allowed on an accessibility child of the element with this role.

- Descendants which are not children of an element ancestor are not constrained by allowed accessibility child roles. For example, an image is not an - allowed accessibility child of a list, but it is a valid descendant if it is also a descendant of the list's - allowed accessibility child listitem. + If any allowed accessibility child roles are specified, authors MUST only add accessibility children with + such roles; in particular, text nodes are not allowed in this case. +

+

+ If no allowed accessibility child roles are specified, then there are no restrictions on accessibility children; in particular, text nodes are allowed in this case. +

+ +

+ Descendants which are not children of an element ancestor are not constrained by allowed accessibility child roles. For example, image is not an + allowed accessibility child of a list, but it is a valid descendant if it is also a descendant of the list's + allowed accessibility child listitem.

- A role that has 'allowed accessibility child roles' does not imply the reverse relationship. Elements with roles in this list do not always have to be found within elements of the given - role. See required accessibility parent roles for requirements about the context where elements of a given role will be contained. + A role that has 'allowed accessibility child roles' does not imply the reverse relationship. For example, row is an allowed accessibility child role for several parent roles. See required accessibility parent roles for requirements about the context where elements of a given role will be contained.

An element with a subclass role of the 'allowed accessibility child role' does not fulfill this requirement. For example, the listbox role allows