iframeTitles

Reports <iframe> elements without a title prop.

✅ This rule is included in the jsx logical and logicalStrict presets.

The title attribute on <iframe> elements provides a label that describes the iframe’s content to screen reader users. Without it, users may have difficulty understanding the purpose of the iframe.

This is required for WCAG 2.4.1 and 4.1.2 compliance.

Examples

❌ Incorrect

<iframe />

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

<iframe title="" />

<iframe title={undefined} />

✅ Correct

<iframe title="This is a unique title" />

<iframe title={uniqueTitle} />;

<iframe title="Video player" src="video.mp4" />

When Not To Use It

If you’re not using iframes in your application, or your iframes are implicitly handled by a framework, you can disable this rule.

Further Reading

• WCAG 2.4.1: Bypass Blocks
• WCAG 4.1.2: Name, Role, Value
• axe-core: frame-title

Equivalents in Other Linters

• ESLint: jsx-a11y/iframe-has-title
• Oxlint: jsx_a11y/iframe-has-title