You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: pdf-aam/index.html
+19-14Lines changed: 19 additions & 14 deletions
Original file line number
Diff line number
Diff line change
@@ -167,7 +167,9 @@ <h2>Introduction</h2>
167
167
</p>
168
168
169
169
<p>
170
-
This specification defines how PDF user agents (commonly referred to as “PDF processors” in ISO standards for PDF technology) respond to and expose <abbrtitle="PDF Logical Structure Items">PLSIs</abbr> (structure elements, structure attributes, or property lists associated with marked content, etc., as defined in ISO 32000-2 clauses 14.7–14.9).
170
+
This specification defines how PDF user agents (commonly referred to as “PDF processors” in ISO standards for PDF technology) respond to and expose
171
+
<abbrtitle="PDF Logical Structure Items">PLSIs</abbr> (structure elements, structure attributes, or property lists associated with marked content, etc., as defined in ISO 32000-2 clauses
172
+
14.7–14.9).
171
173
</p>
172
174
173
175
<p>
@@ -208,26 +210,29 @@ <h2>Mapping PDF Logical Structure Items to Accessibility APIs</h2>
208
210
209
211
<h3>General Rules for Exposing PDF Semantics via HTML or WAI-ARIA Semantics</h3>
210
212
<p>
211
-
Unless indicated otherwise, a <abbrtitle="PDF Logical Structure Items">PLSI</abbr> with default Accessible Rich Internet Applications (WAI-ARIA) 1.2 semantics MUST be exposed to the platform accessibility APIs according to
212
-
the relevant WAI-ARIA mappings defined in the
213
-
[[[Core-AAM-1.2]]] specification. Where a <abbrtitle="PDF Logical Structure Item">PLSI</abbr> has equivalent semantics to a WAI-ARIA role, user agents
214
-
MUST expose such semantic information to the platform for the WAI-ARIA accessibility APIs in a way that conforms to the WAI-ARIA semantics in the Core Accessibility API Mappings 1.2.
213
+
Unless indicated otherwise, a <abbrtitle="PDF Logical Structure Items">PLSI</abbr> with default Accessible Rich Internet Applications (WAI-ARIA) 1.2 semantics MUST be exposed to the platform
214
+
accessibility APIs according to the relevant WAI-ARIA mappings defined in the [[[Core-AAM-1.2]]] specification. Where a <abbrtitle="PDF Logical Structure Item">PLSI</abbr> has equivalent
215
+
semantics to a WAI-ARIA role, user agents MUST expose such semantic information to the platform for the WAI-ARIA accessibility APIs in a way that conforms to the WAI-ARIA semantics in the Core
216
+
Accessibility API Mappings 1.2.
215
217
</p>
216
218
<p>
217
-
In some cases, features present in a PDF may not map to a WAI-ARIA role specified in the
218
-
[[[Core-AAM-1.2]]]. In such cases a relevant HTML Accessibility API Mapping may exist. In those cases, a <abbrtitle="PDF Logical Structure Item">PLSI</abbr> is mapped to that
219
-
HTML Accessibility API. Where a PLSI has equivalent semantics to an HTML element, but not a WAI-ARIA role, user agents MUST expose such semantic information to the platform
220
-
for HTML accessibility APIs in a way that conforms to the <ahref="https://www.w3.org/TR/html-aam-1.0/">HTML Accessibility API Mappings 1.0</a>.
219
+
In some cases, features present in a PDF may not map to a WAI-ARIA role specified in the [[[Core-AAM-1.2]]]. In such cases a relevant HTML Accessibility API Mapping may exist. In those cases,
220
+
a <abbrtitle="PDF Logical Structure Item">PLSI</abbr> is mapped to that HTML Accessibility API. Where a PLSI has equivalent semantics to an HTML element, but not a WAI-ARIA role, user agents
221
+
MUST expose such semantic information to the platform for HTML accessibility APIs in a way that conforms to the
222
+
<ahref="https://www.w3.org/TR/html-aam-1.0/">HTML Accessibility API Mappings 1.0</a>.
221
223
</p>
222
224
223
225
<h3>Exposing <abbrtitle="PDF Logical Structure Items">PLSIs</abbr> That Do Not Directly Map to Accessibility APIs</h3>
224
-
<p>Where a <abbrtitle="PDF Logical Structure Items">PLSI</abbr> does not have any default HTML or WAI-ARIA semantics, the applicable mapping for each platform accessibility API is defined by this specification.</p>
226
+
<p>
227
+
Where a <abbrtitle="PDF Logical Structure Items">PLSI</abbr> does not have any default HTML or WAI-ARIA semantics, the applicable mapping for each platform accessibility API is defined by
228
+
this specification.
229
+
</p>
225
230
226
231
<h3>Exposing <abbrtitle="PDF Logical Structure Items">PLSIs</abbr> That Require a Minimum Role</h3>
227
232
228
233
<p>
229
-
A minimum role is the equivalent WAI-ARIA role a <abbrtitle="PDF Logical Structure Item">PLSI</abbr> will map to if the element does not have a more specific implicit role or platform role mappings, e.g., a non-generic
230
-
role. Minimum roles help ensure that users of assistive technologies get the best possible experience for valid PLSIs where otherwise a role would not be exposed.
234
+
A minimum role is the equivalent WAI-ARIA role a <abbrtitle="PDF Logical Structure Item">PLSI</abbr> will map to if the element does not have a more specific implicit role or platform role
235
+
mappings, e.g., a non-generic role. Minimum roles help ensure that users of assistive technologies get the best possible experience for valid PLSIs where otherwise a role would not be exposed.
231
236
</p>
232
237
233
238
<p>A minimum role is provided when all of the following conditions are true:</p>
<abbrtitle="PDF Logical Structure Items">PLSIs</abbr> with implicit WAI-ARIA role semantics MUST be mapped to platform accessibility APIs according to the identified WAI-ARIA role mapping as defined in the
<abbrtitle="PDF Logical Structure Items">PLSIs</abbr> with implicit WAI-ARIA role semantics MUST be mapped to platform accessibility APIs according to the identified WAI-ARIA role mapping as
260
+
defined in the <ahref="https://www.w3.org/TR/core-aam-1.2/">Core AAM 1.2</a> specification.
256
261
</p>
257
262
<p>
258
263
Where a <abbrtitle="PDF Logical Structure Item">PLSI</abbr> is indicated as having “No corresponding (WAI-ARIA) role”, or is mapped to the generic role, user agents MUST NOT expose the
0 commit comments