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.

List of all elements allowed on
  • a (without an href attribute)
  • abbr
  • address
  • b
  • bdi
  • bdo
  • blockquote
  • br
  • canvas
  • cite
  • code
  • del
  • dfn
  • div
  • em
  • i
  • img (with alt text)
  • ins
  • kbd
  • mark
  • output
  • p
  • pre
  • q
  • rp
  • rt
  • ruby
  • s
  • samp
  • section
  • small
  • span
  • strong
  • sub
  • sup
  • table
  • tbody
  • td
  • tfoot
  • thead
  • th
  • tr
  • time
  • u
  • var
  • wbr

References