Description
An introductory section that precedes the work, typically written by the author of the work.
Examples
Example 1 — Preface with a heading
The label is identified in the aria-labelledby attribute.
<section role="doc-preface" aria-labelledby="pref-hd">
<h2 id="pref-hd">Prefatory Note from the Author</h2>s
<p>When I first put pen to paper …</p>
…
</section>Relation to ARIA
doc-preface is a landmark role.
Usage
doc-preface 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.
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.