Edit ACTION-1695: Propose UIA mapping for aria-kbdshortcuts




Due Date:

(accepts formats such as "2005-05-17", "+1 week", "14 August 2005" and "next Thursday")

Associated Issue:

Or Associated Product:

Add notes (no markup allowed, URIs get automatically hyperlinked):

No related emails.

Related notes:

Spec text:

Joseph Scheuhammer, 28 Jul 2015, 19:25:07

There isn't an obvious mapping. I'm looking into how this works for native keyboard shortcuts.

Cynthia Shelly, 26 Jan 2016, 18:18:08

no obvious mapping. looking into what we do with native keyboard hints.

Cynthia Shelly, 26 Jan 2016, 20:03:25

These are the two options in UIA. Neither one seems like a clear equivalent to the keyboard behavior currently being discussed on the list.


A string containing the accelerator key (also called shortcut key) combinations for the automation element.

Shortcut key combinations invoke an action. For example, CTRL+O is often used to invoke the Open file common dialog box. An automation element that has the AcceleratorKey property can implement the Invoke control pattern for the action that is equivalent to the shortcut command.

AccessKey property
A string containing the access key character for the automation element.

An access key (sometimes called a mnemonic) is a character in the text of a menu, menu item, or label of a control such as a button, that activates the associated menu function. For example, to open the File menu, for which the access key is typically F, the user would press ALT+F.

[from https://msdn.microsoft.com/en-us/library/windows/desktop/ee684017(v=vs.85).aspx#UIA_AcceleratorKeyPropertyId]

Cynthia Shelly, 8 Mar 2016, 18:51:17

Accelerator key combinations invoke an action. For example, CTRL+O is often used to invoke the Open file common dialog box. An AutomationElement that has the accelerator key property set always implements the InvokePattern class.

[From https://msdn.microsoft.com/en-us/library/system.windows.automation.automationelement.acceleratorkeyproperty(v=vs.110).aspx]

Cynthia Shelly, 8 Mar 2016, 20:05:45

I'm investigating whether this mapping will cause an invoke or just describe one.

Cynthia Shelly, 9 Mar 2016, 16:58:58

It is only a description. There is no Windows magic created by this mapping.

I think AcceleratorKey is a closer mapping, but I like the idea of creating a mnemonic when the key is visible. Maybe we could add that as a separate feature?

Cynthia Shelly, 16 Mar 2016, 02:16:01

AcceleratorKey = the contents of aria-kbdshortcuts.

Joseph Scheuhammer, 3 May 2016, 20:00:45

Note that the name is no longer aria-kbdshortcuts -- see the latest ARIA spec draft for the correct name.

Joseph Scheuhammer, 3 May 2016, 20:02:28

Changes made, marking "pending review":


Joseph Scheuhammer, 30 May 2016, 18:20:57

Closed at AAPI meeting 31-May-2016.

Joseph Scheuhammer, 31 May 2016, 19:38:24

James Nurthen <nurthen@adobe.com>, Chair, Michael Cooper <cooper@w3.org>, Ruoxi Ran <ran@w3.org>, Staff Contacts
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <w3t-sys@w3.org>.
$Id: index.php,v 1.326 2018/10/13 17:29:51 vivien Exp $