Description

A preliminary section that typically introduces the scope or nature of the work.

Examples

Example 1 — Introduction with a heading

The label is identified in the aria-labelledby attribute.

<section role="doc-introduction" aria-labelledby="intro-hd">
   <h2 id="intro-hd">Introduction</h2>
   …
</section>
Example 2 — Introduction without a heading

A label is provided in the aria-label attribute.

<section role="doc-introduction" aria-label="Introduction">
   <p>Recent theory about the nature of gravity …</p>
   …
</section>

Relation to ARIA

doc-introduction is a landmark role.

Usage

doc-introduction 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