Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add that AXRoleDescription and AXCustomContent value are localizable strings #20

Merged
merged 7 commits into from
Jan 19, 2023
Merged

Add that AXRoleDescription and AXCustomContent value are localizable strings #20

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
f74ef29
Add note that AXRoleDescription and AXCustomContent value are localiz…
mattgarrish Jan 6, 2023
e688efc
add change log entry
mattgarrish Jan 6, 2023
a476a9d
Merge remote-tracking branch 'remotes/origin/main' into fix/issue-18
mattgarrish Jan 8, 2023
366cee7
Merge remote-tracking branch 'remotes/origin/main' into fix/issue-18
mattgarrish Jan 10, 2023
3d5079c
Change the note to a section on translatable values
mattgarrish Jan 10, 2023
b8a58f0
update change log entry
mattgarrish Jan 10, 2023
9d9be09
add list of translatable mapping values
mattgarrish Jan 13, 2023
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
24 changes: 21 additions & 3 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -262,9 +262,6 @@ <h3>Role Mapping Table</h3>
Elements having roles with a prefix value of <code>doc-</code>, that are not listed in this role
mapping table, have no normative mappings.</p>

<p class="note">There are a number of roles mappings that are localized. The group needs to look into
localizing for non-English languages.</p>

<div class="table-container">
<table class="map-table elements" id="role-mapping-table">
<caption>Table describing mapping of <abbr title="Accessible Rich Internet Applications"
Expand Down Expand Up @@ -1408,6 +1405,24 @@ <h3>Role Mapping Table</h3>
</div>
</section>
</section>
<section id="translatable-values">
<h2>Translatable Values</h2>

<p>The HTML specification states that other specifications can define <a
data-cite="html#translatable-attributes">translatable attributes</a> [[html]]. The language and
directionality of each attribute value is the same as the <a data-cite="html#language">language</a> and
<a data-cite="html#the-direction">directionality</a> of the element [[html]].</p>

<p>To be understandable by assistive technology users, the following <code>role</code> mapping values
intended for human consumption should be translated when a page is localized:</p>

<ul>
<li>AXRoleDescription</li>
<li>the <code>value</code> property of AXCustomContent</li>
<li>Localized Control Type</li>
<li>Localized Landmark Type</li>
</ul>
</section>
<section id="mapping_state-property">
<h2>State and Property Mapping</h2>

Expand Down Expand Up @@ -1488,6 +1503,9 @@ <h4>Substantive changes since <a href="https://www.w3.org/TR/2017/REC-dpub-aam-1
<!-- EdNote: After each WD publish, move contents of this list into the next one below. -->

<ul>
<li>10-Jan-2023: Added section on translatable values.</li>
<li>04-Jan-2023: Fixed incorrect doc-pagebreak role mentioned in ATK/AT-SPI mapping for
doc-preface.</li>
<li>04-Jan-2023: Fixed incorrect doc-pagebreak role mentioned in ATK/AT-SPI mapping for
doc-preface.</li>
<li>04-Jan-2023: Updated Mac AX API mappings to add AXCustomContent fields.</li>
Expand Down