diff --git a/index.html b/index.html index 9b29bedf8..01c8dec4f 100644 --- a/index.html +++ b/index.html @@ -605,12 +605,45 @@

Prohibited States and Properties

Allowed Accessibility Child Roles

-

A list of roles which may be allowed on an accessibility child (simplified as "child") of the element with this role. For example, an element with the role list may own child elements with the role listitem, but not elements with the role option.

-

To determine whether an element is the accessibility child of a role, user agents MUST ignore any intervening elements with the role generic or none.

+

A list of roles which may be allowed on an accessibility child (simplified as "child") of the element with this role. For example, an element with the role list MAY own child elements with the role listitem, but MUST NOT own elements with the role option.

+

To determine whether an element is the child of an element, user agents MUST ignore any intervening elements with the role generic or none.

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 child of a list, but it is a valid descendant if it is also a descendant of the list's allowed 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.

An element with a subclass role of the 'allowed accessibility child role' does not fulfill this requirement. For example, the listbox role allows a child element using the option or group role. Although the group role is the superclass of row, adding a child element with a role of row will not fulfill the requirement that listbox allows children with option or group roles.

An element with the appropriate implicit WAI-ARIA semantic fulfills this requirement.

+

+ Examples of valid ways to mark up allowed accessibility child roles include: +

    +
  1. Direct DOM child: + +
    <div role="listbox">
+	<div role="option">option text</div>
+</div>
    +
    2. +
  2. DOM child with generics intervening: + +
    <div role="listbox">
+	<div>
+		<div role="option">option text</div>
+	</div>
+</div>
    +
    3. +
  3. Direct aria-owns relationship: + +
    <div role="listbox" aria-owns="id1"></div>
+<div role="option" id="id1">option text</div>
    +
    4. +
  4. aria-owns relationship with generics intervening: + +
    <div role="listbox" aria-owns="id1"></div>
+<div id="id1">
+	<div>
+		<div role="option">option text</div>
+	</div>
+</div>
    +
    5. +
+

Required Accessibility Parent Role