Skip to content

Commit

Permalink
ACTION-2067: Modified aria-owns for order of owned and DOM children.
Browse files Browse the repository at this point in the history
* Taken from email to the public aria list:
  https://lists.w3.org/Archives/Public/public-aria/2016May/0159.html
* Modified to replace non-normative occurrences of "should".
  by Joseph Scheuhammer <clown@alum.mit.edu>
  • Loading branch information
jnurthen authored and joanmarie committed Jun 23, 2016
1 parent a87be5e commit 4001eee
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion aria/aria.html
Original file line number Diff line number Diff line change
Expand Up @@ -9881,7 +9881,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
<div class="property-description">
<p>Identifies an <a>element</a> (or elements) in order to define a visual, functional, or contextual parent/child <a>relationship</a> between <abbr title="Document Object Model">DOM</abbr> elements where the DOM hierarchy cannot be used to represent the relationship. See related <pref>aria-controls</pref>.</p>
<p>The value of the <pref>aria-owns</pref> <a>attribute</a> is a space-separated list of IDREFS that reference one or more elements in the document by ID. The reason for adding <pref>aria-owns</pref> is to expose a parent/child contextual relationship to <a>assistive technologies</a> that is otherwise impossible to infer from the <abbr title="Document Object Model">DOM</abbr>.</p>
<p>Authors SHOULD NOT use <pref>aria-owns</pref> as a replacement for the <abbr title="Document Object Model">DOM</abbr> hierarchy. If the relationship is represented in the DOM, do not use <pref>aria-owns</pref>. Authors MUST ensure that an element's ID is not specified in more than one other element's <pref>aria-owns</pref> attribute at any time. In other words, an element can have only one explicit owner.</p>
<p>If an element has both <pref>aria-owns</pref> and <abbr title="Document Object Model">DOM</abbr> children then the order of the child elements with respect to the parent/child relationship is the <abbr title="Document Object Model">DOM</abbr> children first, then the elements referenced in <pref>aria-owns</pref>. If the author intends that the <abbr title="Document Object Model">DOM</abbr> children are not first, then list the DOM children in <pref>aria-owns</pref> in the desired order. Authors SHOULD NOT use <pref>aria-owns</pref> as a replacement for the <abbr title="Document Object Model">DOM</abbr> hierarchy. If the relationship is represented in the DOM, do not use <pref>aria-owns</pref>. Authors MUST ensure that an element's ID is not specified in more than one other element's <pref>aria-owns</pref> attribute at any time. In other words, an element can have only one explicit owner.</p>
</div>
<table class="property-features">
<caption>Characteristics:</caption>
Expand Down

0 comments on commit 4001eee

Please sign in to comment.