aria-labelledby does not work to provide accessible name for tables (in Firefox), aria-describedby does

[nvaccessAuto]

Reported by Wildebrew on 2015-06-25 16:50
NVDA does not read an accessible name for a table when provided using aria-labelledby.

July, 2015

.. If user either tabs into table, or uses "t" to go to it in virtual buffer, the accessible name is not announced. If the aria-labelledby attribute is replaced with aria-describedby in the above code, NVDA will read that text as the tables accessible name (though technically this is accessible description). Suggested fix: Make sure that when aria-labelledby is used to provide accessible name for a table, that NVDA picks it up.

[nvaccessAuto]

Comment 1 by jteh on 2015-06-25 23:17
The problem here is that the caption element maps to accessible name and we don't want the name to be rendered separately in this case, as this would result in it being rendered twice. We'll need to somehow detect aria-label* and special case it for tables.

[nvaccessAuto]

Comment 2 by paulbohman on 2015-09-25 03:12
I believe that aria-labelledby and aria-label should override the caption element if present. At least that how the aria labels work with links, buttons, and other elements. I tested aria-labelledby on a table with JAWS and with VoiceOver and both of them read the aria-labelledby text. NVDA does read the caption if present, and the aria-label text if present, but not aria-labelledby. Currently, the way NVDA handles things right now, if a table has both a caption and an aria-label, NVDA reads the caption only. By way of contrast, JAWS reads the aria-label only. VoiceOver reads both the caption and the aria-label. From my understanding of the way aria-label and aria-labelledby are supposed to work, I think JAWS is doing it right by allowing the aria-label to override the caption.

So really there are separate issues here:

• support aria-labelledby on tables
• support the accessible name calculation for tables, which I think is that aria-labelledby overrides aria-label which overrides caption. Double check the order, but that's what I remember.

[nvaccessAuto]

Comment 3 by paulbohman on 2015-09-25 03:16
I should mention that the above comments are for when I tested NVDA with Firefox. I noticed that on IE 10, NVDA didn't support either aria-label or aria-labelledby on tables, but I know that IE is a secondary priority compared to Firefox.

[nvaccessAuto]

Comment 4 by jteh on 2015-09-25 04:58
Well, aria-labelledby and aria-label override the entire content for links and buttons. We certainly don't want that for tables. As I've said many times over the years, the spec doesn't actually provide any guidance whatsoever with regard to content; i.e. what should actually be reported. It only talks about name calculation, but there is far more than just name to consider here; i.e. the content of the table.

One concern I have is that if we render the name (as calculated by the browser) in all cases and ignore the caption element, we'll lose any formatting in the caption. Even if we manage to work around that, there's another problem: if the element(s) referenced by aria-labelledby are visible, rendering them in the table may cause duplication.

[LeonarddeR]

@bramd: I'd be good to know your thoughts about this

[ZoeBijl]

@bramd TL;DR: aria-labelledby, then aria-label, and finally caption.

Sources:

As required by the text alternative computation, user agents give precedence to aria-labelledby over aria-label when computing the accessible name property.

ARIA spec: aria-label (property)

That confirms that aria-labelledby indeed takes precedence over aria-label.

2. Compute the text alternative for the current node

B. Otherwise: if computing a name, and the current node has a non-empty aria-labelledby attribute, and the current node is not already part of an aria-labelledby traversal, process its IDREFs in the order they occur:

C. Otherwise, if computing a name, and if the current node has a non-empty aria-label attribute:

• If traversal of the current node is due to recursion and the current node is an embedded control as defined in step 2E, ignore aria-label and skip to rule 2E.
• Otherwise, return the value of aria-label.

D. Otherwise, if the current node's native markup provides an attribute or element that defines a text alternative, return that alternative as a flat string, unless the element is marked as presentational (role="presentation" or role="none").

AccName AAM: Text Alternative Computation

Basically, if there’s no aria-labelledby look for an aria-label and if neither is present use the caption element.

I suggest you read through the “Compute the text alternative for the current node” section yourself as that might make more sense than my blatantly plagiarised version above.

[Adriani90]

cc: @MarcoZehe, @jcsteh

[LaurenceRLewis]

I have found aria-labelledby on table cells to not work as expected on NVDA Chrome and Firefox. I used the following Codepen for testing

- Table with Select all checkbox in table header cell

NVDA output copied from Speech Viewer.

• column 1 check box not checked Select all rows
• row 2 check box not checked
• row 3 check box not checked

JAWS output

• Select all rows, check box not checked, Row 1
• Name John Doe Employee ID 001, check box not checked, Row 2
• Name Jane Doe Employee ID 002, check box not checked, Row 3

CHROME: Version 114.0.5735.199
NVDA: 2023.1
FireFox: 114.0.2

Expectation:
NVDA announces the aria-labelledby relationships
Preferable that NVDA does not announce the TH cell text hidden using aria-hidden.

[SaschaCowley]

@LaurenceRLewis, your comment does not seem to be related to the issue at hand. Please create a new issue.

[SaschaCowley]

I can't reproduce this issue; labelling a table with a caption, with aria-label or with aria-labelledby all work as expected in Chrome and Firefox.