Description

An image that sets the mood or tone for the work and typically includes the title and author.

Examples

Example 1 — Cover image
<img role="doc-cover" class="cover-img" src="cover.jpg" alt="…"/>

Relation to ARIA

doc-cover inherits its semantics from the a img role.

Usage

doc-cover is typically used on the img element, as it identifies an image. It is not appropriate to use it on container elements (e.g., section or div) to group all of the content of a cover page.

The cover for a publication is not normally needed in the document landmarks, but can be added, if necessary, using the ARIA region role.

<section role="region" aria-label="Cover">
   <img role="doc-cover" class="cover-img" src="cover.jpg" alt="…"/>
</section>
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
  • small
  • span
  • strong
  • sub
  • sup
  • table
  • tbody
  • td
  • tfoot
  • thead
  • th
  • tr
  • time
  • u
  • var
  • wbr

References