Add additional accessibility-related authoring advice regarding <details> #9989
Conversation
…ils>. This adds two pieces of advice discussed in w3c/html-aam#509 and whatwg#9899 .
| element (such as a <code>section</code> element).</p> | ||
| element (such as a <code>section</code> element). When it makes sense for the group to be | ||
| introduced with a heading, authors should put that heading in a <span | ||
| data-x="concept-heading">heading</span> element at the start of the containing element.</p> | ||
|
|
||
| <p class="note">Keeping related elements together can be important for accessibility.</p> |
There was a problem hiding this comment.
let's improve this note while we're at it.
| <p class="note">Keeping related elements together can be important for accessibility.</p> | |
| <p class="note">Visually and programmatically grouping related elements together can be important for accessible user experiences. Doing so will help ensure users are more likely to understand the relationship between such elements. When related elements are not grouped, e.g., the associated elements are located in disparate sections of a web page, it can decrease the discoverability and/or the understandability of the elements' relationship to one another.</p> |
There was a problem hiding this comment.
Somehow github's "commit suggestion" UI wouldn't commit the suggestion... but I've incorporated it into the edit that I'll push shortly. I've edited the wording a bit but I don't think I've changed the substance.
One note is that I'm not a fan of "programatically" here (though I've left it for now) because that feels like it's referring to code in a programming language rather than tree structure of markup, but I'm not sure what alternative might be better. Maybe "structurally" or "logically"?
There was a problem hiding this comment.
yeh. the HTML spec is far too big for the comitting of suggestions.
you could use 'structurally' rather than 'programmatically' i suppose.
This adds two pieces of advice discussed in
w3c/html-aam#509 and
#9899 .
/interactive-elements.html ( diff )