HTML-AAM: should address be treated as section/landmark in AAPIs? · Issue #33 · w3c/html-aam · GitHub
Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

HTML-AAM: should address be treated as section/landmark in AAPIs? #33

Closed
jasonkiss opened this issue Oct 12, 2016 · 11 comments
Closed

HTML-AAM: should address be treated as section/landmark in AAPIs? #33

jasonkiss opened this issue Oct 12, 2016 · 11 comments
Assignees

Comments

@jasonkiss
Copy link
Contributor

From @cyns on February 26, 2016 21:23

Apple maps address as an aria landmark role of content-info. IA2 and ATK map it like a div. I think it was at some point mapped to aria role=content-info, but I can't find when that was changed.

I can see how it is similar to contentinfo, though not a perfect match. I also don't think it's important enough (on most web pages) to be part of the landmark loop, which should cover major chunks of the page.

Copied from original issue: w3c/aria#273

@jasonkiss jasonkiss added the AAM label Oct 12, 2016
@jasonkiss jasonkiss assigned jasonkiss and unassigned joanmarie Oct 19, 2016
@jasonkiss jasonkiss changed the title HTML-AAM: should address be treated as seciton/landmark in AAPIs? HTML-AAM: should address be treated as section/landmark in AAPIs? Dec 21, 2016
@jasonkiss
Copy link
Contributor Author

Any other views on this, esp. now that definition of address has been updated, and has a default role of group?

I'd suggest that address not be mapped as a landmark, and that all APIs just use WAI-ARIA mapping for the group role, unless UIA and AX want their own localised strings, e.g. "address".

@stevefaulkner, @surkov, @joanmarie, @cookiecrook, @boggydigital?

@stevefaulkner
Copy link
Contributor

@jasonkiss my thinking is that due to historic misuse and recent change in definition (to better match usage and developer understanding) it should map to group, and be exposed as object attribute xml-roles: address in Ia2

@asurkov
Copy link
Contributor

asurkov commented Dec 22, 2016

sounds good with me to go with group role and xml-roles:address object attribute. I'm not sure I caught how we want to proceed with Apple landmark mapping, will it be changed? Otherwise I'd say it makes IA2/ATK out of sync with AX.

@stevefaulkner
Copy link
Contributor

stevefaulkner commented Dec 22, 2016 via email

@jasonkiss
Copy link
Contributor Author

Agreed. So, putting it all together, we're proposing something like the following, right?

  • WAI-ARIA: Group role
  • MSAA + IAccessible2
    Roles: ROLE_SYSTEM_GROUPING
    Object attributes: xml-roles:address
  • UIA
    Control Type: Group
    Localized Control Type: "address"
  • ATK
    Role: ATK_ROLE_PANEL
    Object attributes: xml-roles:address
  • AX
    AXRole: AXGroup
    AXSubrole: (nil)
    AXRoleDescription: "address"

@boggydigital, @joanmarie, @cookiecrook care to confirm/comment?

@boggydigital
Copy link
Contributor

(pardon my vacation delay)

Don't have strong objection and strongly support address not being a landmark. At least for UIA it sounds like more suitable control type would be Text, not Group. Unless this is about some structural address that contains separate elements, I would treat address as just a piece of text that has some semantic value.

@jasonkiss
Copy link
Contributor Author

Thanks @cookiecrook for the thumbs up.

@boggydigital, address can contain separate elements, including separate elements each with specific RDF metadata. Given that it also maps by default to the group role, it would at least be consistent were address to map similarly across all the APIs and inherit from that WAI-ARIA mapping.

@boggydigital
Copy link
Contributor

No objection from me - I can see how semantically Group does make sense here

@mcking65
Copy link

I wish I had paid attention to this thread sooner.

I HATE, HATE, HATE the overuse of group and the effect it has on screen reader experiences. 99% of the time it just adds clutter. It rarely adds value. It can even add confusion.

This is a perfect example. I think the default mapping should be like a div, just a text node.

Please let designers/authors decide if something needs to be done to make addresses standout for screen reader users. For instance, since group is allowed by html, the author can decide whether to add role group with aria-roledescription. Or, the author can decide to do nothing.

Automatically adding excess verbosity or interaction is not helpful to users.

If we think address is a semantically valuable tag, then we should consider giving it a role in a future version of ARIA. But, please, group is not a helpful stopgap.

jasonkiss added a commit that referenced this issue Jan 22, 2018
@jasonkiss
Copy link
Contributor Author

Since in each API we're specifying (as per my comment above) a relatively simple mapping to a generic grouping container (just as div and a number of elements already use), but with a localized string or object attribute to indicate the grouping is an "address", we probably don't want/need to specify group as the address element's corresponding ARIA role. See the updated mappings for address.

Closing, but if you still have concerns, @mcking65, feel free to reopen for discussion.

@joanmarie
Copy link
Contributor

I wish I had paid attention to this thread sooner.

I wish I had seen it.

I HATE, HATE, HATE the overuse of group and the effect it has on screen reader experiences. 99% of the time it just adds clutter. It rarely adds value. It can even add confusion.

Yeah, the current mapping for my platform would cause Orca to say "panel" for each address. Along with "leaving panel" upon exit, for those users who have enabled extra context messages. Yuck.

This is a perfect example. I think the default mapping should be like a div, just a text node.

I agree. I'm going to open a new issue fix the mappings at least for my platform.

On a happy note, Gecko already treats address like a div.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

6 participants