diff --git a/aria-practices.html b/aria-practices.html index 6f112e42f..f2d1c8658 100644 --- a/aria-practices.html +++ b/aria-practices.html @@ -1843,7 +1843,11 @@

WAI-ARIA Roles, States, and Properties

If activating a menuitem opens a submenu, the menuitem is known as a parent menuitem. A submenu's menu element is contained in or owned by it's parent menuitem. -
  • A parent menuitem has aria-haspopup set to true.
  • +
  • A parent menuitem has aria-haspopup set to true.
  • +
  • + A parent menuitem has aria-expanded set to false when its child menu is not visible and set to true when the child menu is visible. + (See note below regarding HTML validation.) +
  • One of the following approaches is used to enable scripts to move focus among items in a menu as described in : -

    If aria-owns is set on the menu container to include elements that are not DOM children of the container, those elements will appear in the reading order in the sequence they are referenced and after any items that are DOM children. Scripts that manage focus need to ensure the visual focus order matches this assistive technology reading order.

    +
      +
    1. + Currently, using aria-expanded on elements with role menuitem triggers HTML validation errors because the ARIA specification does not yet support doing so. + The ARIA working group plans to resolve this issue in the next version of the specification. + Until a version of ARIA that resolves + the issue + becomes a W3C recommendation, it is safe to ignore these validation errors. + Alternatively, since only a few browser and assistive technology combinations exploit this feature of the pattern, it can be omitted from implementations. +
    2. +
    3. + If aria-owns is set on the menu container to include elements that are not DOM children of the container, those elements will appear in the reading order in the sequence they are referenced and after any items that are DOM children. + Scripts that manage focus need to ensure the visual focus order matches this assistive technology reading order. +
    4. +