An introductory section that precedes the work, typically not written by the author of the work.


Example 1 — Foreword with a heading

The label is identified in the aria-labelledby attribute.

<section role="doc-foreword" aria-labelledby="hd01">
   <h2 id="hd01">Foreword by Francis Bacon</h2>

Relation to ARIA

doc-foreword is a landmark role.


doc-foreword 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.

Related Links