Description

One of a collection of notes that occur at the end of a work, or a section within it, that provides additional context to a referenced passage of text.

Examples

Example 1 — Explicit list of endnotes

This example uses an ol list element to express the list.

<section role="doc-endnotes" aria-labelledby="note-hd">
   <h2 id="note-hd">Notes</h2>
   
   <ol>
      <li id="n001">
         <p role="doc-endnote">1. In the far reaches of space …</p>
      </li>
      …
   </ol>
</section>
Example 2 — Implied list of endnotes

This example defines a list using the ARIA list and listitem roles.

<section role="doc-endnotes" aria-labelledby="note-hd">
   <h2 id="note-hd">Notes</h2>
   
   <div role="list">
      <div role="listitem" id="n001">
         <p role="doc-endnote">1. In the far reaches of space …</p>
      </div>
      …
   </div>
</section>

Relation to ARIA

doc-endnote inherits its semantics from the a listitem role.

Usage

Use of the doc-endnote role is not recommended on list item elements as defined in the DPUB-ARIA specification. The role is not compatible with changes to ARIA's inheritance model (i.e., list must only contain listitem roles) and has to be changed in a future version.

To use the role in a list, insert it on an element inside the list item, as displayed in Example 1 above.

If an endnotes section does not use a list to represent its entries, the core list and listitem roles should be used instead. (See Example 2).

Related Links