Skip to main content

landmark-complementary-is-top-level

Ensure that <aside> elements or elements with role=complementary are not an internal part of another ARIA landmark

Severity: Moderate

Description

To prevent confusion in document structures, avoid nesting ARIA landmarks with <aside> elements or elements using role="complementary" inside other landmarks.

Why is it important?

<aside> elements or elements with role="complementary" should be placed at the top level of the HTML document and should not be internal parts of another ARIA landmark. Placing these elements at the top level ensures that they are correctly interpreted by assistive technologies and included in the accessibility tree, facilitating efficient navigation and comprehension for screen reader users. Nesting <aside> elements or complementary sections within other landmarks can lead to confusion and navigation issues, disrupting the semantic structure of the webpage and hindering accessibility.

How to fix?

Avoid nesting <aside> elements or elements with role="complementary" within other content that is marked up as a landmark.

References

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked






Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked






Thank you for your valuable feedback!

Talk to an Expert
Download Copy