Re: FW: DPUB AAM

Hi Tzviya,

Do you want to have a table of contents appear like the navigation section
of a web page to an assistive technology. If you will have only one
navigation section in a book that is fine. However, if have more than one
and need to distinguish them then you need to either provide a label (that
requires translating), or you have to define a different role mapping in
which case you would subclass navigation and create a new role to be
mapped. In this scenario you could expose a role of "navigation" with an
ARIA but also provide a string role. ... something along the lines of the
following:

                                                                                                                 
                MSAA + UIA Express Role                 Expose as text string in AriaRole                        
                                                                                                                 
 MSAA + IAccessible2 Role + Other IAccessible2 Features IAccessible2: Object attribute xml-roles:toc             
                                                                                                                 
           UIA Control Type + Other Features            Expose as text string in AriaRole                        
                                                                                                                 
                    ATK/AT-SPI Role                     ROLE_LANDMARK and object attribute xml-roles:toc         
                                                                                                                 
                     AXAPI[Note 1]                      AXRole: AXGroup                                          
                                                        AXSubrole: AXLandmarkNavigation                          
                                                        AXRoleDescription: 'TableofContents'                     
                                                                                                                 


Regarding subclassing abstract roles, you have the role "chapter" subclass
landmark in the aria-dpub spec. but you expose the the role as "chapter"
similar to above. I would also recommend that you require aria-posinset and
aria-setsize as properties of "chapter".

Does that make sense?

Rich


Rich Schwerdtfeger



From: "Siegman, Tzviya - Hoboken" <tsiegman@wiley.com>
To: "DPUB-ARIA (public-dpub-aria@w3.org)" <public-dpub-aria@w3.org>
Date: 08/06/2015 02:46 PM
Subject: FW: DPUB AAM



A question for the brainy lot of you:

I am looking at the DPUB AAM [1, 2] work that Joseph did and hoping to get
to some myself before our DPUB ARIA call this week. This is rather
unfamiliar ground for me, so please be patient.

My method is looking at the work Joseph has done against the DPUB roles [3,
4]. I then looked at the superclasses for the roles and their definitions
in the HTML AAM. These two roles are very different. Chapter is a subclass
of landmark, an abstract role. I see that the HTML AAM says not to make to
abstract roles, but I’m not sure how to handle the roles that subclass
abstract roles. I know Joseph mentioned reading documentation for each API,
but I was kind of hoping to avoid that. Any other way?

TOC is a subclass of navigation, and it just points to HTML AAM navigation
definition [5]. Is this the right method for all non-abstract roles?

I’d appreciate any tips.

Thanks,
Tzviya

[1]
http://rawgit.com/w3c/aria/master/dpub-aam/dpub-aam.html#role-map-chapter

[2] http://rawgit.com/w3c/aria/master/dpub-aam/dpub-aam.html#role-map-toc

[3] http://www.w3.org/TR/2015/WD-dpub-aria-1.0-20150707/#dpub-chapter

[4] http://www.w3.org/TR/2015/WD-dpub-aria-1.0-20150707/#dpub-toc

[5] http://w3c.github.io/aria/core-aam/core-aam.html#role-map-navigation



Tzviya Siegman
Digital Book Standards & Capabilities Lead
Wiley
201-748-6884
tsiegman@wiley.com