Skip to content
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

[html-aam PR 484] contextual role concept proposal #2218

Open
wants to merge 20 commits into
base: main
Choose a base branch
from

Conversation

pkra
Copy link
Member

@pkra pkra commented May 24, 2024

Moved from w3c/html-aam#484

scottaohara and others added 19 commits May 11, 2023 12:39
closes #375

The purpose of this proposal is both to resolve the issue that "scoped" was an undefined term that was used to indicate when certain elements would expose particular ARIA roles or not.  However, in the year of noodling on this, other activities to revise what "owned" means in ARIA, the idea of a minimum role, as well as the fact there were other elements in HTML that have "scoped" or "contextual roles" that are based on heuristics, rather than defined standards, became relevant.

A change to hopefully help simplify the implementations of contextual roles is that this proposal is aiming to tie the role of an element based on its a11y tree ancestry, rather than based on specific HTML elements in the DOM.

This PR represents the initial draft of the proposal.  Other work to explicitly call out the elements that have contextual roles, what roles they need to adjust to, and other wording revisions to replace "scoped" with the new term would still need to be made.
still working on the exact wording.  also changing some placeholder short code so as to hopefully not get more build errors for presently undefined terms
Co-authored-by: James Craig <cookiecrook@users.noreply.github.com>
Co-authored-by: James Craig <cookiecrook@users.noreply.github.com>
use computed role in both sentences, rather than switching between terms
Co-authored-by: James Craig <cookiecrook@users.noreply.github.com>
@pkra
Copy link
Member Author

pkra commented May 24, 2024

Strangely enough, this merged without conflict -- which makes me doubt the result.

This position seems to match the original diff
@pkra
Copy link
Member Author

pkra commented May 24, 2024

@scottaohara I hope I moved the section to the correct position.

@pkra pkra changed the base branch from monorepo_history--html-aam to main June 12, 2024 19:24
@pkra pkra changed the title [Monorepo] [html-aam PR 484] contextual role concept proposal [html-aam PR 484] contextual role concept proposal Jun 12, 2024
@rahimabdi
Copy link
Contributor

Re-adding reviewers @cookiecrook @spectranaut @aleventhal and myself.

@rahimabdi rahimabdi requested a review from cookiecrook August 11, 2024 23:02
list item (`li` element) within an unordered list (`ul` element). However, the same element might be used within a different markup pattern and could therefore expose different
contextually-dependent computed roles, such as a `section` element with an author-provided accessible name (role `region`) versus an unnamed `section` element (role `generic`).
</p>
<p>When the conditions for an element's contextual role are not met, it will commonly expose a computed role of `generic` or with a <strong>minimum role</strong>, if applicable.</p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<p>When the conditions for an element's contextual role are not met, it will commonly expose a computed role of `generic` or with a <strong>minimum role</strong>, if applicable.</p>
<p>When the conditions for an element's contextual role are not met, it will commonly be exposed with a computed role of `generic` or with a <strong>minimum role</strong>, if applicable.</p>

Grammar ^

&lt;article>
...
&lt;li>...&lt;/li> &lt;!-- computed role `generic`, not `listitem` -->
...</code></pre>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we should use a different example than listitem, here and above, given the push back on the orphan roles tests which is partially being discussed here: #2166

But started with the roll back of orphan <li> tests in WPT.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants