ISSUE: ARIA 5/14 Draft, Section 2.5, list item 4. Example wording is a little obtuse.

ISSUE: ARIA 5/14 Draft, Section 2.5, second list, item 4. Example  
wording is a little obtuse.

http://www.w3.org/WAI/PF/aria/#buildingaccessibleapplications

Section 2.5, first paragraph of list item 4, says, "Look for  
relationships between elements, and mark them using the most  
appropriate property or attribute. For example: If container A  
contains search results, and container B contains the search controls,  
then mark each container as a region and set the controls property in  
region B to reference region A. See relationships in WAI-ARIA."

I would suggest either rephrasing or removing the example. Possible  
rephrasing of the example:

"Look for relationships between elements, and mark them using the most  
appropriate property or attribute. For example, if an element contains  
search results and another element contains search controls, then mark  
each element as a 'region' and set the 'controls' property of the  
search results element to reference the id of the search controls  
element. See 'relationships' in WAI-ARIA."

Or take out the example altogether. Remember this is still pretty  
early in the document. I don't think it'll be a problem to just link  
to the later section, rather than give an example that references  
properties and roles that haven't even been defined yet.

"Look for relationships between elements, and mark them using the most  
appropriate property or attribute. See relationships in WAI-ARIA."

Note to editor: the link to "relationships in WAI-ARIA" appears  
hardcoded to a document version, rather than to an in-page anchor.  
There may be other links like this, too.

Received on Monday, 9 June 2008 05:00:58 UTC