WAI-ARIA: Role=Directory

A list of references to members of a group, such as a static table of contents.

Description

A list of references to members of a group, such as a static table of contents.
Authors SHOULD use this role for a static table of contents, whether linked or unlinked. This includes tables of contents built with lists, including nested lists. Dynamic tables of contents, however, might use a tree role instead.

Role=Directory Example

HTML Example

<div role="directory">
  <ul>
    <li>Global Warming Causes
      <ul>
        <li>CO2 Buildup</li>
        <li>Auto emissions</li>
        <li>Factory emissions</li>
        <li>Destruction of rainforests</li>
      </ul>
    </li>
    <li>Tailoring CO2 buildup
      <ul>
        <li>Elimination of the incandescent light bulb</li>
        <li>Hydrogen fuel cells</li>
        <li>Solar energy</li>
        <li>Wind power</li>
      </ul>
    </li>
  </ul>
</div>

HTML Example 2

<ul role="directory">
  <li>
    <a href="/chapter-1">Chapter 1</a>
  </li>
  <li>
    <a href="/chapter-2">Chapter 2</a>
  </li>
  <li>
    <a href="/chapter-3">Chapter 3</a>
  </li>
</ul>

Characteristics

Superclass Role

• list

Inherited States and Properties

• aria-atomic
• aria-busy (state)
• aria-controls
• aria-current (state)
• aria-describedby
• aria-details
• aria-disabled (state)
• aria-dropeffect
• aria-errormessage
• aria-expanded (state)
• aria-flowto
• aria-grabbed (state)
• aria-haspopup
• aria-hidden (state)
• aria-invalid (state)
• aria-keyshortcuts
• aria-label
• aria-labelledby
• aria-live
• aria-owns
• aria-relevant
• aria-roledescription

Name From

• author

Semantic HTML

No HTML element equivalent.

Reference

• WAI-ARIA 1.2 Specification
  Refer to the notes from the WAI-ARIA 1.2 specification for more information on role=directory.