Embedded iframes need to be preceded by a heading

Context

The iframe element contains a title attribute that is required. Not all assistive technology can access that title with ease. Often these iframes are within the flow of content and the context can be clarified by using a header element.

For hero-type video embeds where the page loads, the addition of a heading allows a user to see/hear/interpret an h1, and then they are presented with a play button for video embeds or data being announced. A heading will be helpful to all.

Decision

  • Headings should be presented prior to video embeds, possibly using visually-hidden styling.
  • The audio description link follows the header with either visually-hidden styling or shown.
  • iframe title should not be relied upon as not all AT can navigate into iframes.
  • Duplicate info is preferred over no information.

Status

Consequences

More work will be required when embedding an iframe resource.

Templates within Drupal and other CMS's may need development to do this for content editors.