ACTION-1660: Propose the ATK/AT-SPI mappings for aria-roledescription.

Propose the ATK/AT-SPI mappings for aria-roledescription.

Joseph Scheuhammer
Due on:
August 25, 2015
Created on:
June 23, 2015
Associated Issue:
Mappings for aria-roledescription
Related emails:
No related emails

Related notes:

For now this should be mapped via object attribute. While there is an atk_role_get_localized_name() it is not object specific. Instead, it's a means to ask the toolkit or application implementing ATK for the localized role name for all instances of the specified AtkRole. For example, you pass it ATK_ROLE_PUSH_BUTTON and in hungarian you get "gomb". Why this method exists is beyond me, because ATK has these localized already.

Joanmarie Diggs, 14 Jul 2015, 19:17:14

Joanie wrote:
> For now this should be mapped via object attribute.

Which object attribute?

Joseph Scheuhammer, 14 Jul 2015, 19:18:21

See if IA2 has a preference. Otherwise, roledescription (i.e. a new object attribute) should work.

Joanmarie Diggs, 21 Jul 2015, 18:49:50

Joseph Scheuhammer, 28 Jul 2015, 19:37:56

Joanie: Please touch base with Alex and James Teh, and see if they have any preference vis-a-vis IA2, and if that impacts ATK/AT-SPI.

Joseph Scheuhammer, 28 Jul 2015, 19:53:18

Looks like I don't have to. Alex replied to the email Joseph sent. Text pasted below. So for ATK, it will need to be an object attribute for now. "roledescription" is fine with me.

Transferring to Joseph to make it so.


Hi, Joseph. We agreed to use localizedExtendedRole in IA2 [1]. If ATK doesn't have similar method then I agree that object attribute is a best choice.

On Tue, Jul 28, 2015 at 2:47 PM, Joseph Scheuhammer <> wrote:

Hi Alex,

Have you had time to consider the MSAA+IA2 mapping of aria-roledesription for the Core-AAM. The current spec text is here:

I figure the mappings will be similar to those for ATK/AT-SPI. Joanie has an action in that regard and has suggested using an object property. See the notes in ACTION-1660:

Could you give me an idea of time line for completing this action? Thanks.


'Array(16).join("wat" - 1) + " Batman!"'
- G. Bernhardt -

Joanmarie Diggs, 28 Jul 2015, 20:17:22


Expose description string in object property <code>roledescription:&lt;value&gt;</code>.

Joseph Scheuhammer, 17 Aug 2015, 18:33:38

Edits done:


Joseph Scheuhammer, 24 Aug 2015, 18:36:29

Display change log.

James Nurthen <>, Valerie Young <>, Chairs, Daniel Montalvo <>, Staff Contact
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <>.
$Id: 1660.html,v 1.1 2023/05/22 16:31:50 carcone Exp $