Updated aria-setsize and aria-posinset to clarify usage for authors #1332
Conversation
Good question. Looking through the spec, I see that the section on handling author errors in states and properties says:
So whatever we decide to ask User Agents to do regarding fallback for posinset without setsize (and vice-versa) probably needs to stay within the bounds of "MAY do some minor validation". I'm not sure that UA could do much here anyhow, although perhaps...
|
Co-authored-by: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com>
|
@jnurthen can we add this one to the next agenda, to get complete clarification on the comments so we can ship this? Thanks! |
Co-authored-by: Matt King <a11yThinker@Gmail.com>
There was a problem hiding this comment.
Thanks, @MelSumner !
Giving +1 assuming the 2 suggestions about adding a conditional phrase will be committed, plus the little one-word suggestion about changing 'exposing' to 'specifying' in setsize (was already changed in posinset).
Co-authored-by: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com>
Co-authored-by: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com>
Co-authored-by: Matt King <a11yThinker@Gmail.com>
There was a problem hiding this comment.
+1
Thanks @MelSumner - I think this adds clarity.
So, the only normative change is:
If authors specify
aria-posinset, authors MUST also specify a value foraria-setsize.
And (correct me if I'm wrong) we didn't require the opposite (i.e. if setsize then must posinset) because we're allowing the UA's to do the posinset calculation if they know the setsize.
I won't hold up the merge for the following, but just wondering if this paragraph needs to be reworded? (Showing the posinset paragraph, but it is similar in setsize except ending in "an explicit indication of set size.")
If all items in a set are present in the document structure, it is not necessary to set this attribute , as the user agent can automatically calculate the set size and position for each item. However, if only a portion of the set is present in the document structure at a given moment, this property is needed to provide an explicit indication of an element's position.
There was a problem hiding this comment.
Agree with @carmacleod
I think a small change is needed in the aria-posinset definition. Not totally happy with the wording so feel free to modify if something better comes to mind!
from
<p>If all items in a set are present in the document structure, it is not necessary to
set this <a>attribute</a>, as the <a>user agent</a> can automatically calculate the set size and position for each item.
However, if only a portion of the set is present in the document structure at a given moment,
this <a>property</a> is needed to provide an explicit indication of an element's position.</p>
to
<p>If all items up to the current item in a set are present in the document structure, it is not necessary to
set this <a>attribute</a>, as the <a>user agent</a> can automatically calculate the position for these items.
However, if all previous items in the set are not present in the document structure at a given moment,
the author MUST set this <a>attribute</a>to provide an explicit indication of an element's position.</p>
|
@MelSumner I think if we just put James' suggested change into the aria-posinset definition, then this PR is ready to merge! :) |
…1332) Co-authored-by: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com> Co-authored-by: Matt King <a11yThinker@Gmail.com>
Resolves #747 by updating prose for
aria-setsizeandaria-posinset.Still unresolved- what should UA do if one is defined and not the other?
Preview | Diff