HTML-AAM: @abbr should be part of name calculation

[jasonkiss]

From @cyns on January 12, 2016 23:15

abbr should replace (or maybe add to?) the inner text of the element, and participate in name calculation.

Copied from original issue: w3c/aria#181

[jasonkiss]

Interestingly, HTML5.1 defines the abbr attribute as an "alternative label for the header cell" and that it is "typically an abbreviated form of the full header cell, but can also be an expansion, or merely a different phrasing." My experience is the opposite: it's typically an expansion. Either way, it's an interesting question.

In my view, adding the value of the abbr attribute to the header element's contents as accessible name will lead to unnecessary verbosity. And if the abbr can be either an expansion, or an abbreviation, or just some alternative phrasing, how do we decide when or how it should participate in the name calculation? (This is where Steve chimes in with his grep about how abbr is used in the wild ;)

Is it something to leave to ATs, or an AT user preference? What about accessible description? For instance, when browsing an actual header cell whose abbr is an expansion, it might be useful to get that expansion as an accessible description, but when navigating table cells, it might be nicer to just get the shorter header cell's contents.

[jasonkiss]

From @jnurthen on March 16, 2016 3:39

I can tell you how we use it.

When we have sort controls within a table header then we use abbr to provide a version of the table header without the extraneous sorting control information to be used as the table header when reading cells in the table.

For example

Last Name sort ascendingsort desceding

Regards,
James.

On Mar 15, 2016, at 20:30, Jason Kiss [email protected] wrote:

Interestingly, HTML5.1 defines the abbr attribute as an "alternative label for the header cell" and that it is "typically an abbreviated form of the full header cell, but can also be an expansion, or merely a different phrasing." My experience is the opposite: it's typically an expansion. Either way, it's an interesting question.

In my view, adding the value of the abbr attribute to the header element's contents as accessible name will lead to unnecessary verbosity. And if the abbr can be either an expansion, or an abbreviation, or just some alternative phrasing, how do we decide when or how it should participate in the name calculation? (This is where Steve chimes in with his grep about how abbr is used in the wild ;)

Is it something to leave to ATs, or an AT user preference? What about accessible description? For instance, when browsing an actual header cell whose abbr is an expansion, it might be useful to get that expansion as an accessible description, but when navigating table cells, it might be nicer to just get the shorter header cell's contents.

―
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub

[jasonkiss]

Thanks @jnurthen. Looks like VO is using the abbr value when navigating cells, although I can't see how that's mapped using Accessibility Inspector. FF exposes the abbr as object attributes on the header cell. NVDA doesn't seem to read the abbr in FF, but JAWS does in IE and FF when navigating table data cells, but not when reading the actual header cell itself. Seems that preference then is to have abbr replace the header cell contents when navigating cells, but not when calculating name of the header cell itself?

[jasonkiss]

@cookiecrook Accessibility Inspector with Safari Tech Preview shows value of attr on th exposed in "ExpandedTextValue". And VO seems to read this value to identify the relevant column or row header when navigating cells, but not when reading the name of the th itself. I'm unable to find any documentation about this property. AXExpandedTextValue? Can you help with a steer, or suggestion as to how best to represent this in the HTML-AAM mapping?

[cookiecrook]

For <abbr title> I think it's okay to include this in the language specific labeling attribute, like <img alt>. For <th abbr>, I'm not sure how best to represent in AAM other than to document what the engines currently expose.

[jasonkiss]

Thanks.

For <abbr title> I think it's okay to include this in the language specific labeling attribute, like <img alt>.

Ok. The AAM currently says, rightly or wrongly, to map title on abbr to AXHelp. Chrome maps title to AXDescription on the AXGroup object for abbr. Meanwhile Safari maps it to AXExpandedTextValue on the AXStaticText node.

From your comment, I'm assuming that mapping title on abbr to AXDescription, like alt on img, is preferred.

For <th abbr>, I'm not sure how best to represent in AAM other than to document what the engines currently expose.

Chrome not exposing abbr on th at all from what I can tell, and Safari using AXExpandedTextValue, so I'll propose that as the appropriate mapping.

[cookiecrook]

Ok. The AAM currently says, rightly or wrongly, to map title on abbr to AXHelp. Chrome maps title to AXDescription on the AXGroup object for abbr. Meanwhile Safari maps it to AXExpandedTextValue on the AXStaticText node.

Such is the challenge with normalizing ~ten accessibility APIs into one. 😀 I'd guess the Chrome mapping is just left over from when they forked WebKit into Blink. A lot of the smaller WebKit accessibility fixes since that time never made it to Blink.

Chrome not exposing abbr on th at all from what I can tell, and Safari using AXExpandedTextValue, so I'll propose that as the appropriate mapping. Please use AXExpandedTextValue as the mapping.

Ditto here. Yes, please use AXExpandedTextValue as the mapping.

[jasonkiss]

@cookiecrook Thanks, as always, for the feedback.

I will update mappings for title on abbr to AXDescription, and abbr on th to AXExpandedTextValue.

One last question: Any chance you have a link to publicly available documentation listing/describing AXExpandedTextValue?

[jasonkiss]

Addressed in ef2ad72. Closing.

[cookiecrook]

One last question: Any chance you have a link to publicly available documentation listing/describing AXExpandedTextValue?

I don't think so. @fleizach?

[fleizach]

On Jun 1, 2017, at 10:08 PM, James Craig ***@***.***> wrote: One last question: Any chance you have a link to publicly available documentation listing/describing AXExpandedTextValue?

No it's not an attribute in the public Accessibility API yet

…

I don't think so. @fleizach <https://github.com/fleizach>? — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#16 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/ALmBA8VjqE0iApOW0u0G3eUorh0lZS7Fks5r_5jagaJpZM4KUUlD>.