core-aam icon indicating copy to clipboard operation
core-aam copied to clipboard

Need mappings for aria-rowindextext and aria-colindextext

Open joanmarie opened this issue 6 years ago • 8 comments

Platform mappings are needed for https://w3c.github.io/aria/#aria-rowindextext and https://w3c.github.io/aria/#aria-colindextext.

  • For ATK/AT-SPI2 (my platform), it should be the usual object attribute
  • For IA2, I assume it should also be the usual object attribute (@jcsteh please confirm or correct)
  • For UIA we need @melanierichards to chime in
  • For AXAPI we need @cookiecrook to chime in

Thanks all!

joanmarie avatar Sep 10 '19 11:09 joanmarie

UIA: for each of these, “Not mapped. The value of the property is available in AriaProperties.”

We'll probably want to update the prose for other properties that likewise only "map" into AriaProperties, and maybe have a pointer to some longer spec text explaining the syntax of the string. Out of scope for this change, but if that makes sense, I can add an issue for that and assign MS folks?

melanierichards avatar Sep 12 '19 20:09 melanierichards

If the property is exposed via AriaProperties, then isn't it mapped? (Yeah, mapped to a catch-all place, like AtkObject attributes. But I'd argue still mapped.)

joanmarie avatar Sep 13 '19 11:09 joanmarie

@cookiecrook: ping

joanmarie avatar Oct 21 '19 21:10 joanmarie

@cookiecrook: What about: AXARIARowIndexText and AXARIAColumnIndexText?

joanmarie avatar Oct 21 '19 21:10 joanmarie

I'd like to request an example be added to the spec. Is this intended primarily to account for 0-based versus 1-based lists? E.g. screen reader speaks "1 of 10" and you want it to be "0 of 9"… Or is the intention something else? Thanks.

cookiecrook avatar Oct 22 '19 20:10 cookiecrook

@cookiecrook this issue is for the mappings. Can you log an issue against the spec if the examples given in the prose are not adequate. https://w3c.github.io/aria/#aria-colindextext - cites examples of spreadsheets or chess boards https://w3c.github.io/aria/#aria-rowindextext - cites an example of battleships

jnurthen avatar Oct 22 '19 21:10 jnurthen

@cookiecrook In case it's helpful, there's a whole section on Grid and Table Properties about to go into the APG that includes a subsection on "Communicating cell position with aria-colindextext and aria-rowindextext". (the plan is to add an example as well, but that is not yet written). Reviews of the new section welcome in PR https://github.com/w3c/aria-practices/pull/1204 !

carmacleod avatar Oct 22 '19 21:10 carmacleod

@cookiecrook : No. It's more like the screen reader is providing a numeric column or row number, but there's a different index. Like in a spreadsheet where the columns are A, B, C ... ZZX, ZZY, ZZZ. The screen reader should present the cell as, say, "C25" or say "Column C selected". But aria-colindex is 3.

joanmarie avatar Oct 22 '19 21:10 joanmarie