Design decision draft - Avoid to use heading in summary element

• Edit this page
• Revision history
• Questions or comments?

Need independant testing

Summary

• Number: -
• Expert: @pjackson
• Status: Drafting
• Type: Limited AT support
• Date: 2018-02-12

Scope

In web content, when using expand/collapse content. (<detail> / <summary>)

Issue

Some AT do not recognize the heading declared inside a <summary> element.

Recommendation

Even if the HTML5 specification allow it, it is recommended to not use heading inside expand/collapse content.

Avoid

<details>
	<summary>
		<h4>heading element</h4>
	</summary>
	[... content ...]
</details>