Skip to content

Conversation

@scottaohara
Copy link
Member

@scottaohara scottaohara commented Oct 30, 2025

this PR attempts to close #2668

As mentioned in the referenced issue, authors naming a tooltip either doesn't consistently work with current AT, or it can introduce unintended author errors where if a tooltip is named - and associated with an element via aria-describedby, only the name is exposed and not the longer description that a user can see.

The reason this changed to name prohibited, is because by removing the 'name from author', only 'name from contents' remained.... and there is no other role in the ARIA spec that allows name from content by itself. All other similar roles are identified as name prohibited.

So, while this PR initially only changes the "name from" section from listing "author and contents" to "prohibited" - i assume a note will need to be added to further describe this change and the rational behind it.

it might be worth also resolving #2507 in this PR. but before I do that, I will wait for discussion on this initial PR.

Test, Documentation and Implementation tracking

Once this PR has been reviewed and has consensus from the working group, tests should be written and issues should be opened on browsers. Add N/A and check when not applicable.

  • "author MUST" tests:
  • "user agent MUST" tests:
  • Browser implementations (link to issue or commit):
    • WebKit:
    • Gecko:
    • Blink:
  • ACT review?
  • Does this need AT implementations?
  • Related APG Issue/PR:
  • MDN Issue/PR:

Preview | Diff

this PR attempts to close #2668

As mentioned in the referenced issue, authors naming a tooltip either doesn't consistently work with current AT, or it can introduce unintended author errors where if a tooltip is named - and associated with an element via `aria-describedby`, only the name is exposed and not the longer description that a user can see.

The reason this changed to name prohibited, is because by removing the 'name from author', only 'name from contents' remained.... and there is no other role in the ARIA spec that allows name from content by itself. All other similar roles are identified as name prohibited.


So, while this PR initially only changes the "name from" section from listing "author and contents" to "prohibited"  - i assume a note will need to be added to further describe this change and the rational behind it.

it might be worth also resolving #2507 in this PR.  but before I do that, I will wait for discussion on this initial PR.
@netlify
Copy link

netlify bot commented Oct 30, 2025

Deploy Preview for wai-aria ready!

Name Link
🔨 Latest commit 01d0127
🔍 Latest deploy log https://app.netlify.com/projects/wai-aria/deploys/6903a4cb3f60850008f3af0d
😎 Deploy Preview https://deploy-preview-2670--wai-aria.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

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.

Should tooltips allow name from author - or really, naming?

2 participants