-
Notifications
You must be signed in to change notification settings - Fork 148
Expand file tree
/
Copy pathindex.html
More file actions
174 lines (168 loc) · 9.85 KB
/
index.html
File metadata and controls
174 lines (168 loc) · 9.85 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
<!doctype html>
<html lang="en-US">
<head>
<meta charset="utf-8" />
<title>CSS Accessibility API Mappings 1.0</title>
<script src="https://www.w3.org/Tools/respec/respec-w3c" class="remove" defer="defer"></script>
<script src="../common/script/resolveReferences.js" class="remove"></script>
<script src="../common/script/utility.js" class="remove"></script>
<script src="../common/script/participants.js" class="remove"></script>
<script class="remove">
var respecConfig = {
group: "aria",
github: "w3c/aria/css-aam/",
doJsonLd: true,
// Document info
specStatus: "ED",
shortName: "css-aam-1.0",
//publishDate: "2009-08-06",
//previousMaturity: "WD",
//previousPublishDate: "2012-10-25",
//previousURI: "http://www.w3.org/TR/",
copyrightStart: "2025",
edDraftURI: "https://w3c.github.io/css-aam/",
// lcEnd: "2010-08-06",
tocIntroductory: true,
maxTocLevel: 2,
// Editors
editors: [
{ name: "Zoë Bijl", company: "Invited Expert", mailto: "editor@moiety.me", w3cid: 74040 },
{ name: "James Teh", company: "Mozilla Foundation", companyURL: "https://mozilla.org/", mailto: "jteh@mozilla.com", w3cid: 134488 },
],
// authors, add as many as you like.
// This is optional, uncomment if you have authors as well as editors.
// only "name" is required. Same format as editors.
//authors: [
// { name: "Your Name", url: "http://example.org/",
// company: "Your Company", companyURL: "http://example.com/" },
//],
// Spec URLs
ariaSpecURLs: {
ED: "https://w3c.github.io/aria/",
FPWD: "https://www.w3.org/TR/wai-aria-1.3/",
WD: "https://www.w3.org/TR/wai-aria-1.3/",
CR: "https://www.w3.org/TR/wai-aria-1.3/",
REC: "https://www.w3.org/TR/wai-aria-1.3/",
},
accNameURLs: {
ED: "https://w3c.github.io/accname/",
WD: "https://www.w3.org/TR/accname-1.2/",
FPWD: "https://www.w3.org/TR/accname-1.2/",
CR: "https://www.w3.org/TR/accname-1.2/",
REC: "https://www.w3.org/TR/accname-1.2/",
},
coreMappingURLs: {
ED: "https://w3c.github.io/core-aam/",
WD: "https://www.w3.org/TR/core-aam-1.2/",
FPWD: "https://www.w3.org/TR/core-aam-1.2/",
CR: "https://www.w3.org/TR/core-aam-1.2/",
REC: "https://www.w3.org/TR/core-aam-1.2/",
},
dpubModURLs: {
ED: "https://w3c.github.io/dpub-aria/",
FPWD: "https://www.w3.org/TR/dpub-aria-1.1/",
WD: "https://www.w3.org/TR/dpub-aria-1.1/",
REC: "https://www.w3.org/TR/dpub-aria-1.1/",
},
graphicsMappingModURLs: {
ED: "https://w3c.github.io/graphics-aam/",
FPWD: "https://www.w3.org/TR/graphics-aam-1.0/",
WD: "https://www.w3.org/TR/graphics-aam-1.0/",
CR: "https://www.w3.org/TR/graphics-aam-1.0/",
PR: "https://www.w3.org/TR/graphics-aam-1.0/",
REC: "https://www.w3.org/TR/graphics-aam-1.0/",
},
graphicsModURLs: {
ED: "https://w3c.github.io/graphics-aria/",
FPWD: "https://www.w3.org/TR/graphics-aria/",
WD: "https://www.w3.org/TR/graphics-aria/",
REC: "https://www.w3.org/TR/graphics-aria/",
},
htmlMappingURLs: {
ED: "https://w3c.github.io/html-aam/",
FPWD: "https://www.w3.org/TR/html-aam-1.0/",
WD: "https://www.w3.org/TR/html-aam/",
REC: "https://www.w3.org/TR/html-aam/",
},
xref: ["HTML", "core-aam", "accname", "wai-aria", "dom", "infra"],
preProcess: [linkCrossReferences],
postProcess: [fixContributors],
a11y: false,
};
</script>
</head>
<body>
<section id="abstract">
<p>
CSS Accessibility API Mappings (CSS-AAM) defines how <a class="termref">user agents</a> map <abbr title="Cascading Style Sheets">CSS</abbr> [[CSS]] pseudo-elements and properties 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 CSS 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>
</section>
<section id="sotd">
<p class="note">
<strong>This document is subject to change without notice.</strong>
</p>
</section>
<section id="intro" class="informative">
<h2>Introduction</h2>
<p>This specification defines how CSS user agents respond to and expose [=role=], [=state=] and [=ARIA/property=] information provided for Web content.</p>
<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>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 <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]]].
</p>
</section>
</section>
<section id="conformance">
<p>Normative sections provide requirements that user agents and assistive technologies MUST follow for an implementation to conform to this specification.</p>
<p>
Non-normative (informative) sections provide information useful to understanding the specification. Such sections may contain examples of recommended practice, but it is not required
to follow such recommendations in order to conform to this specification.
</p>
<section id="deprecated">
<h3>Deprecated</h3>
<p>There are currently no deprecated requirements.</p>
</section>
</section>
<section>
<h2>Mapping CSS to Accessibility APIs</h2>
<section id="mapping_general">
<h3>General Rules for Exposing WAI-ARIA Semantics</h3>
<p>
Most CSS accessibility API mappings cannot be expressed in terms of WAI-ARIA semantics. However, there are some exceptions such as a pseudo-element which has generated content and
alternative text. Where a CSS property or pseudo-element specifies default WAI-ARIA semantics, it MUST be exposed to the platform <a class="termref">accessibility APIs</a> in a way
that conforms to <a class="core-mapping" href="#mapping_general">General rules for exposing WAI-ARIA semantics</a> in the [[[core-aam-1.2]]].
</p>
</section>
<section id="css-property-mappings">
<h3>CSS Property Mappings</h3>
</section>
<section id="css-pseudo-element-mappings">
<h3>CSS Pseudo-element Mappings</h3>
</section>
<section id="css-pseudo-class-mappings">
<h3>Mapping CSS Pseudo-class Selectors</h3>
<p>
CSS pseudo-class selectors are not directly exposed to accessibility APIs and have no direct impact on the <a class="termref">accessibility tree</a>. However, when a pseudo-class
selector matches, this may cause additional CSS properties to apply to elements or pseudo-elements. These must be exposed to accessibility APIs as described in other sections of
this specification. In addition, many pseudo-class selectors match based on element states; e.g. the enabled, disabled, required and focused states. These should be mapped as
described in the Accessibility API Mappings specification for the host language such as [[HTML-AAM]].
</p>
</section>
</section>
</body>
</html>