joaooliveira
Crownpeak (Retired)

If using frames (or iframes) make sure they are titled

Why is this important?

An iframe would normally intended to load the content of a separate page or html element. Since users would effectively be entering another page within the webpage it is important to set a title for the iframe in order to inform users of accessibility tools what to expect within the iframe. 

Screen readers may interact with iframes in different ways, adding the title for iframes that are visible does provide the option to provide additional information for those that do use this functionality. Should the iframe not be intended to be viewed by end users, it is recommended to set specific attributes to indicate that it is not meant to be viewed.

How can I resolve this issue?

If the iframe is intended to be visible to the user then add a title attribute and the value should describe the iframed content. If the iframe is not intended to be visible then indicate that the iframe is not intended to be viewed by either:

  • Adding the attribute aria-hidden="true"
  • Setting display to none
  • Setting visibility to hidden

What topics do this checkpoint affect?

  • Accessibility (WCAG 2.1 Level AA, 2.4.1)

Can you explain how this checkpoint works?

The checkpoint examines the entire HTML source code of a page and reports <iframe> elements, that do not contain one or more of the below attributes:

  • title
  • aria-hidden="true"
  • display set to none
  • visibility set to hidden

References

Labels (1)

Can't find what you are looking for?

Find Answers

Search our DQM Forum to find answers to questions asked by other DQM users.

Ask a Question

No luck? Ask a question. Our Product and Support teams are monitoring the Forum and typically respond within 48 hours.

Ask a Question