8000 clarify output element naming by scottaohara · Pull Request #402 · w3c/html-aam · GitHub
[go: up one dir, main page]

Skip to content
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
add relation info for output
Adds into to output element mapping to align with other elements, such as fieldset, to indicate a labeling relationship.
  • Loading branch information
scottaohara authored Dec 8, 2022
commit 500c86a3760dcdcd5af391f06e679c6ca267075d
19 changes: 16 additions & 3 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2406,10 +2406,23 @@ <h3>HTML Element Role Mappings</h3>
<tr tabindex="-1" id="el-output">
<th><a data-cite="HTML">`output`</a></th>
<td class="aria"><a class="core-mapping" href="#role-map-status">`status`</a> role</td>
<td class="ia2"><div class="general">Use WAI-ARIA mapping</div></td>
<td class="ia2">
<div class="general">Use WAI-ARIA mapping</div>
<div class="relations">
<span class="type">Relations:</span> `IA2_RELATION_LABELLED_BY` with associated `label` element
</div>
</td>
<td class="uia"><div class="general">Use WAI-ARIA mapping</div></td>
<td class="atk"><div class="general">Use WAI-ARIA mapping</div></td>
<td class="ax"><div class="general">Use WAI-ARIA mapping</div></td>
<td class="atk">
<div class="general">Use WAI-ARIA mapping</div>
<div class="relations">
<span class="type">Relations:</span> `ATK_RELATION_LABELLED_BY` with associated `label` element
</div>
</td>
<td class="ax">
<div class="general">Use WAI-ARIA mapping</div>
<td class="ax">`AXDescription: value from associated `label` element subtree.</td>
Copy link
Collaborator
@cookiecrook cookiecrook Dec 10, 2022

Choose a reason for hiding this comment

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

For future reference, pretty much all instances to AXTitle or AXDescription should be replaced with AXLabel. There was a legacy distinction in the original Mac OS X Accessibility Protocol that was later simplified.

Suggested change
<td class="ax">`AXDescription: value from associated `label` element subtree.</td>
<td class="ax">`AXLabel: value from associated `label` element subtree.</td>

Copy link
Collaborator

Choose a reason for hiding this comment

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

It also may be worth considering whether to list these using a more common developer reference, like accessibilityLabel. If @aleventhal or other non-Apple implementors have a preference, please advise. Thanks.
https://developer.apple.com/documentation/objectivec/nsobject/1615181-accessibilitylabel

Copy link
Member Author

Choose a reason for hiding this comment

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

Unless you object, @cookiecrook, I'm going to leave this as is since there's a larger find and replace issue I filed to fix this more broadly (#450).

That way, if this is instead changed to accessibilityLabel, then this instance doesn't need to be changed again.

Copy link
Contributor

Choose a reason for hiding this comment

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

sort of related, you should fix the missing backtick for AXDescription

</td>
<!-- <td class="naming"></td> -->
<td class="comments"></td>
</tr>
Expand Down
0