Skip to content

Commit

Permalink
Merge branch 'gh-pages' into ignore-aria-hidden
Browse files Browse the repository at this point in the history
  • Loading branch information
scottaohara authored Feb 7, 2024
2 parents a4b7195 + 41069bb commit 46ee6b3
Showing 1 changed file with 13 additions and 13 deletions.
26 changes: 13 additions & 13 deletions html-aam/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@
<body>
<section id="abstract">
<p>
HTML Accessibility API Mappings (HTML-AAM) defines how <a class="termref">user agents</a> map <abbr title="HyperText Markup Language">HTML</abbr> [[HTML]] elements and attributes to platform <a class="termref" data-lt="accessibility API">accessibility application programming interfaces (<abbr title="Application Programming Interfaces">APIs</abbr>)</a>. It leverages and extends the [[[core-aam-1.2]]] and the [[[accname-aam-1.1]]] for use with the HTML host language. Documenting these mappings promotes interoperable exposure of roles, states, properties, and events implemented by accessibility APIs and helps to ensure that this information appears in a manner consistent with author intent.
HTML Accessibility API Mappings (HTML-AAM) defines how <a class="termref">user agents</a> map <abbr title="HyperText Markup Language">HTML</abbr> [[HTML]] elements and attributes to platform <a class="termref" data-lt="accessibility API">accessibility application programming interfaces (<abbr title="Application Programming Interfaces">APIs</abbr>)</a>. It leverages and extends the [[[core-aam-1.2]]] and the [[[accname-1.2]]] for use with the HTML host language. Documenting these mappings promotes interoperable exposure of roles, states, properties, and events implemented by accessibility APIs and helps to ensure that this information appears in a manner consistent with author intent.
</p>
<p>
The HTML-AAM is part of the <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> suite described in the <a href="https://www.w3.org/WAI/intro/aria.php"><abbr title="Accessible Rich Internet Application">WAI-ARIA</abbr> Overview</a>.
Expand All @@ -105,7 +105,7 @@
<section id="intro" class="informative">
<h2>Introduction</h2>
<p>
This specification defines how HTML user agents respond to and expose [=role=], [=state=] and [=ARIA/property=] information provided for Web content. Unless indicated otherwise, an HTML element or attribute with default [[[WAI-ARIA]]] semantics must be exposed to the platform <a class="termref">accessibility APIs</a> according to the relevant WAI-ARIA mappings defined in the [[[core-aam-1.2]]] ([[core-aam-1.2]]) specification.
This specification defines how HTML user agents respond to and expose [=role=], [=state=] and [=ARIA/property=] information provided for Web content. Unless indicated otherwise, an HTML element or attribute with default [[[wai-aria-1.2]]] semantics must be exposed to the platform <a class="termref">accessibility APIs</a> according to the relevant WAI-ARIA mappings defined in the [[[core-aam-1.2]]] specification.
</p>
<p>
In some cases, often due to features of the HTML host language or the accessibility API in question, an element or attribute's mapping differs from the corresponding ARIA mappings specified in the [[core-aam-1.2]]. Where an HTML element or attribute does not have any default WAI-ARIA semantics, the applicable mapping for each platform <a class="termref">accessibility API</a> is defined by this specification.
Expand All @@ -120,23 +120,23 @@ <h2>Introduction</h2>
<li>[[[accname-1.2]]]</li>
<li>[[[core-aam-1.2]]]</li>
<li>HTML Accessibility API Mappings 1.0 (this specification)</li>
<li>[[[svg-aam-1.0]]]</li>
<!-- mathml aam link needs a shortcode, this doesn't appear to exit right now -->
<li><cite><a href="https://w3c.github.io/mathml-aam/">MathML AAM 1.0</a></cite></li>
<li><cite><a href="https://w3c.github.io/mathml-aam/">MathML Accessibility API Mappings 1.0</a></cite></li>
<li>[[[svg-aam-1.0]]]</li>
</ul>
<section id="intro_aapi">
<h3>Accessibility APIs</h3>
<p>
<a class="termref">Accessibility APIs</a> covered by this document are:
</p>
<ul>
<li><abbr title="Microsoft Active Accessibility">MSAA</abbr> with <cite><a href="https://wiki.linuxfoundation.org/accessibility/iaccessible2/start">IAccessible2 1.3</a></cite> [[IAccessible2]]</li>
<li><cite><a href="https://msdn.microsoft.com/en-us/library/ee684013%28VS.85%29.aspx">User Interface Automation</a></cite> [[UI-AUTOMATION]]</li>
<li><cite>Linux/GNOME <a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK - Accessibility Toolkit</a></cite> [[ATK]] and <cite><a href="https://gitlab.gnome.org/GNOME/at-spi2-core/">Assistive Technology Service Provider Interface</a></cite> [[AT-SPI]], referred to hereafter as "ATK/AT-SPI"</li>
<li><cite><a href="https://developer.apple.com/reference/appkit/nsaccessibility">Mac OS X Accessibility Protocol Mac OS 10.10</a></cite> [[AXAPI]]</li>
<li><abbr title="Microsoft Active Accessibility">MSAA</abbr> with <cite>IAccessible2 1.3</cite> [[IAccessible2]]</li>
<li><cite>User Interface Automation</cite> [[UI-AUTOMATION]]</li>
<li><cite>ATK - Accessibility Toolkit</cite> [[ATK]] and <cite>Assistive Technology Service Provider Interface</cite> [[AT-SPI]], referred to hereafter as "ATK/AT-SPI"</li>
<li><cite>macOS Accessibility Protocol</cite> [[AXAPI]]</li>
</ul>
<p>
If user agent developers need to expose information using other <a class="termref">accessibility APIs</a>, it is recommended that they work closely with the developer of the platform where the API runs, and assistive technology developers on that platform.
If user agent developers need to expose information using other <a class="termref">accessibility APIs</a>, it is recommended that they work closely with the developer of the platform where the <abbr title="application programming interface">API</abbr> runs, and assistive technology developers on that platform.
</p>
<p>
For more information regarding <a class="termref">accessibility APIs</a>, refer to <a data-cite="core-aam-1.2/#intro_aapi">section 1.1 Accessibility APIs</a> of the [[[core-aam-1.2]]].
Expand Down Expand Up @@ -16844,16 +16844,16 @@ <h4>Substantive changes since moving to the Web Application Working Group (forme
<section class="appendix informative" id="acknowledgements">
<h3>Acknowledgments</h3>
<p>The following people contributed to the development of this document.</p>
<section class="section" id="ack_group">
<h4>Participants active in the HTML Accessibility Task Force active at the time of publication</h4>
<div class="section" id="ack_group"> <!-- left in place to ensure deep links to ID remain functional -->
<ul id="gh-contributors"></ul>

<!-- list of contributors will appear here,
along with link to their GitHub profiles -->
<!--
TODO:
Add listing of individuals who have providing meaningful
contributions through commenting that have impacted the specification.
-->
</section>
</div>
<div data-include="https://rawgit.com/w3c/aria/master/common/acknowledgements/funders.html" data-include-replace="true"></div>
</section>
</section>
Expand Down

0 comments on commit 46ee6b3

Please sign in to comment.