This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 28624 - Mac "AX" property and value names in AAM specs
Summary: Mac "AX" property and value names in AAM specs
Status: RESOLVED NEEDSINFO
Alias: None
Product: ARIA
Classification: Unclassified
Component: Core AAM (show other bugs)
Version: 1.1
Hardware: PC All
: P2 normal
Target Milestone: ---
Assignee: James Craig
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-05-12 03:18 UTC by Jason Kiss
Modified: 2018-05-03 20:25 UTC (History)
2 users (show)

See Also:


Attachments

Description Jason Kiss 2015-05-12 03:18:20 UTC
Don't know if this has been discussed anywhere already, and I'm filing it under "Core" but it applies to all the API mapping guides.

With the updates to the Mac NSAccessibility protocol and related Apple developer documentation [1], do we need to reconsider how the mapping guides present the various properties and values for the Mac API? 

In the current version of the Mac Accessibility Inspector, the properties are now called "accessibilityRole", "accessibilitySubrole", and "accessibilityRoleDescription". Despite the fact that the Inspector shows their values using the "AX" names, e.g. AXGroup, there's no clear documentation anywhere that I can find that lists the "AX" values. The old HTML to Platform Accessibility APIs Implementation Guide used to link to a page [2] describing all the different "AX" values, etc., but that page doesn't exist anymore.

Should we be presenting these property names and values in a way that more closely aligns with how they are presented in the official NSAccessibility Protocol documentation? Do we leave things as they are but include a note regarding the way they are named, i.e. with the "AX" prefix?


[1] https://developer.apple.com/library/mac/documentation/Cocoa/Reference/ApplicationKit/Protocols/NSAccessibility_Protocol/index.html
[2] https://developer.apple.com/library/mac/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXIntro/OSXAXintro.html
Comment 1 Joseph Scheuhammer 2015-05-12 14:54:16 UTC
Assigning to James Craig for his input.