Skip to content

html-iframe-has-title.md

Latest commit

 

History

History
43 lines (27 loc) · 1.53 KB

html-iframe-has-title.md

File metadata and controls

43 lines (27 loc) · 1.53 KB

Linter Rule: iframe elements must have a title attribute

Rule: html-iframe-has-title

Description

Ensure that all iframe elements have a meaningful title attribute that describes the content of the frame. The title should not be empty or contain only whitespace.

Rationale

The title attribute on iframe elements provides essential context for screen reader users about what content the frame contains. Without this information, users of assistive technology cannot understand the purpose or content of the embedded frame, creating significant accessibility barriers.

::: tip Note <iframe>'s with aria-hidden="true" are exempt from this requirement as they are hidden from assistive technologies. :::

Examples

✅ Good

<iframe src="https://youtube.com/embed/123" title="Product demonstration video"></iframe>
<iframe src="https://example.com" title="Example website content"></iframe>

<!-- Hidden from screen readers -->
<iframe aria-hidden="true"></iframe>

🚫 Bad

<iframe src="https://example.com"></iframe>

<iframe src="https://example.com" title=""></iframe>

<iframe src="https://example.com" title="   "></iframe>

References