Skip to content

Correction for HTML element role mapping #550

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: gh-pages
Choose a base branch
from

Conversation

scottaohara
Copy link
Member

@scottaohara scottaohara commented Apr 1, 2025

per w3c/aria#2504 - the html element doesn't actually map to the document role - rather a parent document node to the html element is what exposes the document role of a web page.

This update fixes the spec to match the updated HTML aam mapping / matches reality.

The generic role is being added as an "allowed" but not recommended role to the html element. The document role is being kept as an allowed role for the html element. The rational there being that this has been in the spec for a long time and even when specified on the html element, from what i can tell, there's no pro/con to its inclusion.


Preview | Diff

per w3c/aria#2504 - the html element doesn't actually map to the `document` role - rather a parent `document node` to the `html` element is what exposes the `document` role of a web page.

This update fixes the spec to match the updated HTML aam mapping / matches reality.  

The `generic` role is being added as an "allowed" but not recommended role to the `html` element.  The `document` role is being kept as an allowed role for the `html` element.  The rational there being that this has been in the spec for a long time and even when specified on the html element, from what i can tell, there's no pro/con to its inclusion.
@scottaohara scottaohara added HTML AAM Related Align with updates in HTML AAM needs changelog entry once 2 implementations land, we can merge and note it in our changelog. labels Apr 1, 2025
@scottaohara
Copy link
Member Author

this will merge after w3c/aria#2504 is accepted

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
HTML AAM Related Align with updates in HTML AAM needs changelog entry once 2 implementations land, we can merge and note it in our changelog.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants