Skip to content

docs: clarify aside complementary role mapping#44629

Open
ishaanlabs-gg wants to merge 1 commit into
mdn:mainfrom
ishaanlabs-gg:docs-aside-conditional-role
Open

docs: clarify aside complementary role mapping#44629
ishaanlabs-gg wants to merge 1 commit into
mdn:mainfrom
ishaanlabs-gg:docs-aside-conditional-role

Conversation

@ishaanlabs-gg

Copy link
Copy Markdown

Description

Clarifies that <aside> maps to complementary only conditionally when nested in sectioning content.

Motivation

This matches the HTML-AAM mapping for <aside> and addresses reader confusion in the <aside> and complementary role pages.

Additional details

  • HTML-AAM maps <aside> scoped to body or main to complementary.
  • HTML-AAM maps <aside> scoped to sectioning content to complementary only when it has an accessible name; otherwise it maps to generic.

Validation:

  • git diff --check
  • source guard for the new conditional role wording

Related issues and pull requests

Fixes #40664

@ishaanlabs-gg ishaanlabs-gg requested review from a team as code owners July 2, 2026 20:17
@ishaanlabs-gg ishaanlabs-gg requested review from estelle and hamishwillee and removed request for a team July 2, 2026 20:17
@github-actions github-actions Bot added Content:HTML Hypertext Markup Language docs Content:Accessibility Accessibility docs size/s [PR only] 6-50 LoC changed labels Jul 2, 2026
@hamishwillee hamishwillee removed their request for review July 2, 2026 23:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:Accessibility Accessibility docs Content:HTML Hypertext Markup Language docs size/s [PR only] 6-50 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

<aside> implicit role="complementary" is conditional

2 participants