Description

A brief dictionary of new, uncommon or specialized terms used in the content.

Examples

Example 1 — Glossary with a heading

The label is identified in the aria-labelledby attribute.

<section role="doc-glossary" aria-labelledby="gloss-hd">
   <h2 id="gloss-hd">Terms and Definitions</h2>
   <dl>
      <dt><dfn>newfangled</dfn></dt>
      <dd>an improved version that does not …</dd>
      …
   </dl>
</section>

Relation to ARIA

doc-glossary is a landmark role.

Usage

doc-glossary is typically used on section elements.

A label must be provided for the role using one of the aria-labelledby, aria-label or title attributes.

Note: Due to contradictory definitions for the dt element, is not currently recommended to use the role on a definition list (dl). A future version of ARIA is expected to clarify the semantics.

For a simplified list of all the elements the role is allowed on, refer to the mapping table in the EPUB Type to ARIA Role Authoring Guide. For the official list of allowed elements, refer to ARIA in HTML.

Related Links