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 bibliography list

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

<section role="doc-bibliography" aria-labelledby="bib-hd">
   <h2 id="bib-hd">Select Bibliography</h2>
   <ol>
      <li>
         <p role="biblioentry">Doe, John. Anonymous People through History. …</p>
      </li>
      …
   </ol>
</section>
Example 2 — Implied bibliography list

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

<section role="doc-bibliography" aria-labelledby="bib-hd">
   <h2 id="bib-hd">Select Bibliography</h2>
   <div role="list">
      <div role="listitem">
         <p role="biblioentry">Doe, John. Anonymous People through History. …</p>
      </div>
      …
   </div>
</section>

Relation to ARIA

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

Usage

Use of the doc-biblioentry 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 bibliography does not use a list to represent its entries, the core list and listitem roles should be used instead. (See Example 2).

Related Links