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
Modified to replace non-normative occurrences of "should".
  • Loading branch information
klown committed Jun 16, 2016
1 parent 6d3bf39 commit eb8fc81
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 @@ -9849,7 +9849,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>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 <abbr title="Document Object Model">DOM</abbr> children should not be first then they should also be listed in <pref>aria-owns</pref> in the correct 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>
<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

1 comment on commit eb8fc81

@joanmarie
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@klown: This branch was merged into master in commit 4001eee. If you're happy with the result, feel free to delete this branch if you have no other use for it. Thanks!

Please sign in to comment.