Summary
Structure bibliographies using sections and lists to simplify access to the references.
Techniques
-
Use the
section
element to group related sets of references. [[WCAG-1.3.1]] -
Include a heading for each section [[WCAG-1.3.1]]
-
Use list elements to structure the references. [[WCAG-1.3.1]]
Examples
Explanation
Bibliographies should be marked up using list elements. Definition lists are commonly used, as the
term element (dt
) is useful for highlighting the label used in the text. Unordered lists are
also commonly used when bibliographies are converted from a print source. The alphabetization of entries
does not infer sequential order (e.g., the bibliography can be reverse sorted without losing meaning).
Use section
elements to group alphabetically- and numerically-related entries and/or if the
bibliography is split up topically (e.g., normative and informative references). The aria-label
attribute can be attached to the enclosing section to include a title if the sections do not have headings
(i.e., if space is used to separate the groups).
The use of lists is recommended as it simplifies navigation by users of assistive technologies. Not only does it speed up the movement through entries, but the position within the list can be announced, allowing the user to quickly return to the same spot again later, if needed.
Related Links
- DPUB-ARIA —
doc-bibliography
(role) - HTML — The
section
element - HTML — Headings and sections
- HTML — The
dl
element - HTML — The
ul
element