Description

A section of content structured as a series of questions and answers, such as an interview or list of frequently asked questions.

Examples

Example 1 — Author Question and Answer with a heading

The label is identified in the aria-labelledby attribute.

<section role="doc-qna" aria-labelledby="qna-hd">
   <h2 id="qna-hd">Interview with the Author</h2>
   <dl>
   	<dt>What … is your favourite colour?</dt>
   	<dd>Blue. I mean yel—auuuugh!</dd>
   </dl>
</section>

Relation to ARIA

doc-qna inherits its semantics from the section role (i.e., it represents a container of related content, but is not a landmark).

Usage

doc-qna is typically used on section and div elements. The role can also be used directly on a dl element as dt and dd elements are not considered list items by default.

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