Skip to content

Commit 0322e0c

Browse files
committed
remove terms, update respec
1 parent 92b6d2c commit 0322e0c

File tree

1 file changed

+16
-31
lines changed

1 file changed

+16
-31
lines changed

graphics-aria/index.html

Lines changed: 16 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<head>
55
<meta charset="UTF-8" />
66
<title>WAI-ARIA Graphics Module</title>
7-
<script src="https://www.w3.org/Tools/respec/respec-w3c-common" class="remove" defer="defer"></script>
7+
<script src="https://www.w3.org/Tools/respec/respec-w3c" class="remove" defer="defer"></script>
88
<script src="common/script/resolveReferences.js" class="remove"></script>
99
<script src="common/biblio.js" class="remove" defer="defer"></script>
1010
<link href="common/css/common.css" rel="stylesheet" type="text/css"/>
@@ -133,20 +133,7 @@
133133

134134
//processVersion: 2015,
135135
// name of the WG
136-
wg: ["Accessible Rich Internet Applications Working Group"],
137-
138-
// URI of the public WG page
139-
wgURI: ["https://www.w3.org/WAI/ARIA/"],
140-
141-
// name (with the @w3c.org) of the public mailing to which comments are due
142-
wgPublicList: "public-aria",
143-
144-
// URI of the patent status for this WG, for Rec-track documents
145-
// !!!! IMPORTANT !!!!
146-
// This is important for Rec-track documents, do not copy a patent URI from a random
147-
// document unless you know what you're doing. If in doubt ask your friendly neighbourhood
148-
// Team Contact.
149-
wgPatentURI: ["https://www.w3.org/2004/01/pp-impl/83726/status"],
136+
group: "aria",
150137
maxTocLevel: 4,
151138
// Spec URLs
152139
ariaSpecURLs: {
@@ -158,8 +145,10 @@
158145
"REC": "https://www.w3.org/TR/wai-aria-1.1/"
159146
},
160147

161-
preProcess: [ linkCrossReferences ]
162-
148+
preProcess:[linkCrossReferences],
149+
postProcess:[ariaAttributeReferences],
150+
definitionMap:[],
151+
xref: ["core-aam", "accname", "wai-aria"]
163152
};
164153
</script>
165154
<style>
@@ -180,7 +169,7 @@
180169
</head>
181170
<body>
182171
<section id="abstract">
183-
<p>Assistive technologies need semantic information about the structures and expected behaviors of a document in order to convey appropriate information to persons with disabilities. This specification defines a <a href="" class="specref">WAI-ARIA 1.1</a> [[!WAI-ARIA-1.1]] module of core <a data-lt="role">roles</a><!-- , <a data-lt="state">states</a> and <a data-lt="property">properties</a> Note, if we do include any states & properties in this module, edit this sentence! --> specific to web graphics. These semantics allow an author to express the logical structure of the graphic to assistive technologies in order improve accessibility of graphics. Assistive technologies could then enable semantic navigation and adapt styling and interactive features, to provide an optimal experience for the audience. These features complement the graphics and document structure elements defined by HTML [[HTML52]] and SVG [[SVG2]].</p>
172+
<p>Assistive technologies need semantic information about the structures and expected behaviors of a document in order to convey appropriate information to persons with disabilities. This specification defines a <a href="" class="specref">WAI-ARIA 1.1</a> [[WAI-ARIA-1.1]] module of core <a data-lt="role">roles</a><!-- , <a data-lt="state">states</a> and <a data-lt="property">properties</a> Note, if we do include any states & properties in this module, edit this sentence! --> specific to web graphics. These semantics allow an author to express the logical structure of the graphic to assistive technologies in order improve accessibility of graphics. Assistive technologies could then enable semantic navigation and adapt styling and interactive features, to provide an optimal experience for the audience. These features complement the graphics and document structure elements defined by HTML [[HTML52]] and SVG [[SVG2]].</p>
184173
<p>This document 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 Applications">WAI-ARIA</abbr> Overview</a>.</p>
185174
</section>
186175
<section id="sotd">
@@ -197,7 +186,7 @@
197186
<section class="informative" id="introduction">
198187
<h1>Introduction</h1>
199188
<p><abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> is a technical specification that provides a framework to improve the accessibility and interoperability of web content and applications. It enables web browsers to map the accessibility semantics in web content to platform-specific accessibility APIs. This enables web content to be interoperable with platform assistive technologies, similar to native platform applications, without requiring authors to include platform dependencies.</p>
200-
<p>This specification is a modular extension of <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> [[!WAI-ARIA-1.1]] designed to support graphics. The goals of this specification include:</p>
189+
<p>This specification is a modular extension of <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> [[WAI-ARIA-1.1]] designed to support graphics. The goals of this specification include:</p>
201190
<ul>
202191
<li>Expanding WAI-ARIA to produce semantic extensions to support structured graphics such as charts, graphs, maps, technical drawings and scientific diagrams. It has applicability to both Scalable Vector Graphics as well as HTML 5 Canvas and graphics produced with CSS styling of HTML and other markup languages.</li>
203192
<li>Align with a new governance model for modularization and extensions to <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr>.</li>
@@ -226,15 +215,15 @@ <h2>Target Audience</h2>
226215

227216
<section id="ua-support">
228217
<h2>User Agent Support</h2>
229-
<p>This module follows the general <a href="https://www.w3.org/TR/wai-aria-1.1/#ua-support">User Agent support principles</a> defined in WAI-ARIA [[!WAI-ARIA-1.1]].
218+
<p>This module follows the general <a href="https://www.w3.org/TR/wai-aria-1.1/#ua-support">User Agent support principles</a> defined in WAI-ARIA [[WAI-ARIA-1.1]].
230219
The roles defined here do not require any change in behavior by user agents other than in the information exposed to the <a>accessibility API</a>.
231220
However, the semantics defined here provide the ability for user agents to enhance the general user interface presented to readers.
232221
For example, a user agent may provide alternative keyboard navigation suitable to a graphical environment, or may allow users to extract a copy of a graphic from a larger document.</p>
233222
</section>
234223

235224
<section id="co-evolution">
236225
<h2>Co-Evolution of <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> and Host Languages</h2>
237-
<p>The <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> Graphics module follows the model for <a href="https://www.w3.org/TR/wai-aria-1.1/#co-evolution">co-evolution of <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> and host languages</a> defined in WAI-ARIA [[!WAI-ARIA-1.1]]. It is intended to augment semantics in supporting languages like HTML [[HTML52]], SVG [[SVG2]] and EPUB, or to be used as an accessibility enhancement technology in other markup-based languages that do not explicitly include support for ARIA.
226+
<p>The <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> Graphics module follows the model for <a href="https://www.w3.org/TR/wai-aria-1.1/#co-evolution">co-evolution of <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> and host languages</a> defined in WAI-ARIA [[WAI-ARIA-1.1]]. It is intended to augment semantics in supporting languages like HTML [[HTML52]], SVG [[SVG2]] and EPUB, or to be used as an accessibility enhancement technology in other markup-based languages that do not explicitly include support for ARIA.
238227
WAI-ARIA <a>roles</a> clarify semantics to assistive technologies when authors create new types of objects, via style and script, or use markup languages which describe the visual appearance of a document rather than its meaning.</p>
239228
<p>Although markup languages may provide some of these semantics natively, it is expected that there will be a persistent need for the semantics provided by the <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> Graphics module.
240229
Some host languages exist to create semantics for features other than the user interface. For example, SVG expresses the semantics behind production of graphical objects, not of user interface components that those objects may represent. Host languages such as these might, by design, not provide native semantics that map to all of this specification's features. In these host languages, the <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> Graphics module could be adopted as a long-term approach to add semantic information.</p>
@@ -255,7 +244,7 @@ <h3>Testing Practices and Tools</h3>
255244

256245
<section id="at_support">
257246
<h2>Assistive Technologies</h2>
258-
<p>Programmatic access to accessibility semantics is essential for assistive technologies. For more information, refer to the <a href="https://www.w3.org/TR/wai-aria-1.1/#at_support">Assistive Technologies</a> section in WAI-ARIA [[!WAI-ARIA-1.1]].</p>
247+
<p>Programmatic access to accessibility semantics is essential for assistive technologies. For more information, refer to the <a href="https://www.w3.org/TR/wai-aria-1.1/#at_support">Assistive Technologies</a> section in WAI-ARIA [[WAI-ARIA-1.1]].</p>
259248
<p>For the graphics roles in particular, two categories of assistive technology are particularly relevant, but have different needs:</p>
260249
<ul>
261250
<li>Text-based presentations, such as screen readers, braille displays, and text-only displays or printers. These technologies need to replace a complex graphic with semantic text descriptions, preserving any meaningful structure and relationships between components.
@@ -265,24 +254,20 @@ <h2>Assistive Technologies</h2>
265254
<p>The role descriptions suggest which features of an element with that role are considered semantically important and should be conveyed to the reader whenever possible.</p>
266255
</section>
267256
</section>
268-
<section class="normative">
257+
<section class="normative" id="conformance">
269258
<h2>Conformance</h2>
270-
<p>The main content of this specification is <a>normative</a> and defines requirements that impact conformance claims. Introductory material, appendices, sections marked as "non-normative" and their subsections, diagrams, examples, and notes are <a>informative</a> (non-normative). Non-normative material provides advisory information to help interpret the guidelines but does not create requirements that impact a conformance claim.</p>
259+
<p>The main content of this specification is <a class="termref">normative</a> and defines requirements that impact conformance claims. Introductory material, appendices, sections marked as "non-normative" and their subsections, diagrams, examples, and notes are <a class="termref">informative</a> (non-normative). Non-normative material provides advisory information to help interpret the guidelines but does not create requirements that impact a conformance claim.</p>
271260
<p>Normative sections provide requirements that <a class="termref">user agents</a> must follow for an implementation to conform to this specification. The keywords <em class="rfc2119">MUST</em>, <em class="rfc2119">MUST NOT</em>, <em class="rfc2119">REQUIRED</em>, <em class="rfc2119">SHALL</em>, <em class="rfc2119">SHALL NOT</em>, <em class="rfc2119">SHOULD</em>, <em class="rfc2119">RECOMMENDED</em>, <em class="rfc2119">MAY</em>, and <em class="rfc2119">OPTIONAL</em> in this document are to be interpreted as described in <cite><a href="http://www.rfc-editor.org/rfc/rfc2119.txt">Keywords for use in RFCs to indicate requirement levels</a></cite> [[!RFC2119]]. RFC-2119 keywords are formatted in uppercase and contained in an element with <code>class="rfc2119"</code>. When the keywords shown above are used, but do not share this format, they do not convey formal information in the RFC 2119 sense, and are merely explanatory, i.e., informative. As much as possible, such usages are avoided in this specification.</p>
272261
<p>Normative sections provide requirements that authors, user agents and assistive technologies MUST follow for an implementation to conform to this specification.</p>
273262
<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>
274263
</section>
275-
<section class="informative" id="terms">
276-
<h1>Important Terms</h1>
277-
<div data-include="common/terms.html" data-oninclude="restrictReferences"></div>
278-
</section>
279264
<section class="normative" id="roles">
280265
<h1>Graphics Roles</h1>
281266
<p>
282267
This section defines additions to the
283268
<abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr>
284-
<a>role</a> <a>taxonomy</a>
285-
and describes the characteristics and properties of all <a data-lt="role">roles</a>.
269+
<a class="termref">role</a> <a class="termref">taxonomy</a>
270+
and describes the characteristics and properties of all <a data-lt="role" class="termref">roles</a>.
286271
See <a href="#roles" class="specref">ARIA Roles</a> for descriptions
287272
of the fields provided by this module.
288273
</p>
@@ -323,7 +308,7 @@ <h2>Definition of Roles</h2>
323308
<p>
324309
Below is an alphabetical list of the
325310
<abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr>
326-
<a data-lt="role">roles</a> defined in this specification.
311+
<a data-lt="role" class="termref">roles</a> defined in this specification.
327312
They would normally be used in combination with other roles
328313
defined in WAI-ARIA
329314
to annotate graphics within documents and rich internet applications [[WAI-ARIA-1.1]].

0 commit comments

Comments
 (0)