Skip to content

Commit f93f720

Browse files
Merge branch 'main' into kgf-audio-description-association-tweaks
2 parents 44814bb + a3245dd commit f93f720

File tree

6 files changed

+84
-57
lines changed

6 files changed

+84
-57
lines changed

guidelines/act-mapping.json

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2010,7 +2010,9 @@
20102010
"title": "Audio and visuals of video element have transcript",
20112011
"permalink": "/standards-guidelines/act/rules/1a02b0/proposed/",
20122012
"successCriteria": [
2013-
"media-alternative-prerecorded"
2013+
"media-alternative-prerecorded",
2014+
"info-and-relationships",
2015+
"audio-only-and-video-only-prerecorded"
20142016
],
20152017
"wcagTechniques": [
20162018
"G69"
@@ -2035,6 +2037,12 @@
20352037
"failed": "not satisfied",
20362038
"passed": "further testing needed",
20372039
"inapplicable": "further testing needed"
2040+
},
2041+
"wcag20:1.3.1": {
2042+
"secondary": "This success criterion is **related** to this rule. This is because this criterion applies to a visible transcript."
2043+
},
2044+
"wcag20:1.2.1": {
2045+
"secondary": "This success criterion is **less strict** than this rule. This is because this criterion does not require a transcript when the audio-only or video-only is a media alternative for text and is clearly labeled as such. Some of the failed examples may satisfy this success criterion."
20382046
}
20392047
},
20402048
"input_aspects": [
@@ -4275,7 +4283,10 @@
42754283
{
42764284
"title": "Video element visual-only content has transcript",
42774285
"permalink": "/standards-guidelines/act/rules/ee13b5/proposed/",
4278-
"successCriteria": [],
4286+
"successCriteria": [
4287+
"info-and-relationships",
4288+
"audio-only-and-video-only-prerecorded"
4289+
],
42794290
"wcagTechniques": [
42804291
"G159"
42814292
],
@@ -4293,6 +4304,12 @@
42934304
"failed": "not satisfied",
42944305
"passed": "further testing needed",
42954306
"inapplicable": "further testing needed"
4307+
},
4308+
"wcag20:1.3.1": {
4309+
"secondary": "This success criterion is **related** to this rule. This is because this criterion applies to a visible transcript."
4310+
},
4311+
"wcag20:1.2.1": {
4312+
"secondary": "This success criterion is **less strict** than this rule. This is because this criterion does not require a transcript when the audio-only or video-only is a media alternative for text and is clearly labeled as such. Some of the failed examples may satisfy this success criterion."
42964313
}
42974314
},
42984315
"input_aspects": [

techniques/aria/ARIA21.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ <h3>Using aria-invalid on required fields</h3>
5252
&lt;/div&gt;
5353
&lt;div&gt;
5454
&lt;label for="email"&gt;Email (required)&lt;/label&gt;
55-
&lt;input type="text" name="email" id="email"&gt;
55+
&lt;input type="email" name="email" id="email"&gt;
5656
&lt;/div&gt;
5757
&lt;div&gt;
5858
&lt;input type="submit" name="button" id="button" value="Submit"&gt;
@@ -69,7 +69,7 @@ <h3>Identifying errors in data format</h3>
6969
<pre xml:space="preserve"><code class="language-html">&lt;div class="control"&gt;
7070
&lt;div&gt;
7171
&lt;label for="email"&gt;Email address: [*]&lt;/label&gt;
72-
&lt;input type="text" name="email" id="email" class="error"
72+
&lt;input type="email" name="email" id="email" class="error"
7373
aria-invalid="true" aria-describedBy="err_1"&gt;
7474
&lt;/div&gt;
7575
&lt;span class="errtext" id="err_1"&gt;Error: Incorrect data&lt;/span&gt;
@@ -78,7 +78,7 @@ <h3>Identifying errors in data format</h3>
7878

7979
<pre xml:space="preserve"><code class="language-html">&lt;div class="control"&gt;
8080
&lt;div&gt;&lt;label for="email"&gt;Email address: [*]&lt;/label&gt;
81-
&lt;input type="text" name="email" id="email" class="error"
81+
&lt;input type="email" name="email" id="email" class="error"
8282
aria-invalid="true" aria-describedBy="err_2"&gt;
8383
&lt;/div&gt;
8484
&lt;span class="errtext" id="err_2"&gt;Error: Input data missing&lt;/span&gt;
@@ -139,4 +139,4 @@ <h3>Identifying errors in data format</h3>
139139
</ul>
140140

141141
</section>
142-
</body></html>
142+
</body></html>

techniques/failures/F1.html

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -117,19 +117,24 @@
117117
<section class="procedure"><h3>Procedure</h3>
118118
<p>For content which uses CSS for positioning: </p>
119119
<ol>
120-
<li>Remove the style information from the document or turn off use of
121-
style sheets in the user agent.</li>
122-
<li>Check that the reading order of the content is correct and the
123-
meaning of the content is preserved.</li>
120+
<li>Identify the content elements that use CSS for positioning.</li>
121+
<li>Check that the reading order of the content is correct and the meaning of the content is preserved in relation to the surrounding page or context, using one of the following methods:
122+
<ul>
123+
<li>Code inspection: review the HTML code to determine the logical reading sequence.</li>
124+
<li>Accessibility tree inspection: examine the accessibility tree to confirm the reading order.</li>
125+
<li>Assistive Technology test: use a screen reader to check how the content is read aloud.</li>
126+
<li>Visual test without CSS positioning: remove positioning styles and observe the visual reading sequence.</li>
127+
</ul>
128+
</li>
129+
124130
</ol>
125131
</section>
126132
<section class="results"><h3>Expected Results</h3>
127133
<ul>
128-
<li>If check #2 is false, then this failure condition applies and the
129-
content fails this Success Criterion.</li>
134+
<li>If any option in check #2 is false, then this failure condition applies and the content fails the Success Criterion.</li>
130135
</ul>
131136
</section>
132137
</section><section id="related"><h2>Related Techniques</h2><ul>
133138
<li><a href="../css/C6">C6</a></li>
134139
</ul></section><section id="resources"><h2>Resources</h2></section>
135-
</body></html>
140+
</body></html>

techniques/general/G161.html

Lines changed: 47 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,39 @@
1-
<!DOCTYPE html><html lang="en"><head><title>Providing a search function to help users find content</title><link rel="stylesheet" type="text/css" href="../../css/sources.css" class="remove"></head><body><h1>Providing a search function to help users find content</h1><section class="meta"><p class="id">ID: G161</p><p class="technology">Technology: general</p><p class="type">Type: Technique</p></section><section id="applicability"><h2>When to Use</h2>
1+
<!DOCTYPE html>
2+
<html lang="en">
3+
<head>
4+
<title>Providing a search function to help users find content</title>
5+
<link rel="stylesheet" type="text/css" href="../../css/sources.css" class="remove">
6+
</head>
7+
<body>
8+
<h1>Providing a search function to help users find content</h1>
9+
<section class="meta"><p class="id">ID: G161</p><p class="technology">Technology: general</p><p class="type">Type: Technique</p></section>
10+
<section id="applicability">
11+
<h2>When to Use</h2>
212
<p>All technologies that include forms.</p>
3-
</section><section id="description"><h2>Description</h2>
13+
</section>
14+
<section id="description">
15+
<h2>Description</h2>
416
<p>Providing a search function that searches your web pages is a design strategy that offers users a way to find content. Users can locate content by searching for specific words or phrases, without needing to understand or navigate through the structure of the website. This can be a quicker or easier way to find content, particularly on large sites.</p>
517
<p>Some search companies offer sites free access to their search applications. Search engines are available that can be installed on your own server. Some web hosting companies offer search scripts that customers can include on their web pages. Most services also offer paid versions of their tools with more advanced features.</p>
618
<p>Implementing a search function that will spell-check the terms, include different endings for the terms (stemming), and allow for the use of different terminology (synonyms) will further increase the accessibility of the search function.</p>
719
<p>The search functionality is added by either including a simple form on the web page, usually a text field for the search term and a button to trigger the search or by adding a link to a page that includes a search form. The search form itself must be accessible, of course.</p>
8-
<p>Techniques that are used to optimize search engine results for external searches also support internal search engines and make them more effective: use keywords,
9-
10-
META
11-
12-
tags, and an accessible navigation structure. Search sites provide guidance on how to create content that is optimized for search, for instance
13-
14-
<a href="https://support.google.com/webmasters/answer/35769">Google Webmaster Guidelines</a>, and
15-
<a href="https://help.yahoo.com/kb/search/SLN2245.html?impressions=true">Yahoo! Search Content Quality Guidelines</a>.</p>
16-
</section><section id="examples"><h2>Examples</h2>
20+
<p>Techniques that are used to optimize search engine results for external searches also support internal search engines and make them more effective: use keywords, META tags, and an accessible navigation structure. Search sites provide guidance on how to create content that is optimized for search, for instance <a href="https://support.google.com/webmasters/answer/35769">Google Webmaster Guidelines</a>, and <a href="https://help.yahoo.com/kb/search/SLN2245.html?impressions=true">Yahoo! Search Content Quality Guidelines</a>.</p>
21+
</section>
22+
<section id="examples">
23+
<h2>Examples</h2>
1724
<section class="example">
1825
<h3>A Shopping Site</h3>
19-
2026
<p>A shopping site organizes its products into different categories, such as women's clothes, men's clothes, and children's clothes. These have subcategories, such as tops, pants, shoes, and accessories. Each page also contains a search form. Users can type the product number or product description into the search field and go directly to that product, rather than needing to navigate the product categories to find it.</p>
21-
2227
</section>
2328
<section class="example">
2429
<h3>A Help Center</h3>
25-
2630
<p>A Help Center contains thousands of pages of Help information about a company's products. A search form allows users to search just the Help Center pages to find articles that contain the search terms.</p>
27-
2831
</section>
29-
</section><section id="tests"><h2>Tests</h2>
30-
<section class="procedure"><h3>Procedure</h3>
32+
</section>
33+
<section id="tests">
34+
<h2>Tests</h2>
35+
<section class="procedure">
36+
<h3>Procedure</h3>
3137
<ol>
3238
<li>Check that the web page contains a search form or a link to a search page</li>
3339
<li>Type text into the search form that occurs in the set of web pages</li>
@@ -36,32 +42,31 @@ <h3>A Help Center</h3>
3642
<li>Check that the user is taken to a page that contains a list of links to pages containing the search term</li>
3743
</ol>
3844
</section>
39-
<section class="results"><h3>Expected Results</h3>
45+
<section class="results">
46+
<h3>Expected Results</h3>
4047
<ul>
4148
<li>Check #1 is true, and either Check #4 or Check #5 is true.</li>
4249
</ul>
4350
</section>
44-
</section><section id="related"><h2>Related Techniques</h2><ul>
45-
<li><a href="../general/G63">G63</a></li>
46-
<li><a href="../general/G64">G64</a></li>
47-
<li><a href="../general/G125">G125</a></li>
48-
<li><a href="../general/G126">G126</a></li>
49-
</ul></section><section id="resources"><h2>Resources</h2>
50-
51-
<ul>
52-
<li>
53-
<a href="http://webdesign.about.com/od/administration/a/aa091399.htm">Searching Your Site</a>
54-
</li>
55-
<li>
56-
<a href="http://www.bravenet.com/webtools/search2/">Bravenet Site Search</a>
57-
</li>
58-
<li>
59-
<a href="http://www.freefind.com/">FreeFind</a>
60-
</li>
61-
<li>
62-
<a href="https://www.google.com/cse/">Google Custom Search Engine</a>
63-
</li>
64-
65-
</ul>
66-
67-
</section></body></html>
51+
</section>
52+
<section id="related">
53+
<h2>Related Techniques</h2>
54+
<ul>
55+
<li><a href="../general/G63">G63</a></li>
56+
<li><a href="../general/G64">G64</a></li>
57+
<li><a href="../general/G125">G125</a></li>
58+
<li><a href="../general/G126">G126</a></li>
59+
</ul>
60+
</section>
61+
<section id="resources"><h2>Resources</h2>
62+
<ul>
63+
<li>
64+
<a href="http://www.freefind.com/">FreeFind</a>
65+
</li>
66+
<li>
67+
<a href="https://www.google.com/cse/">Google Custom Search Engine</a>
68+
</li>
69+
</ul>
70+
</section>
71+
</body>
72+
</html>

techniques/general/G65.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ <h2>When to Use</h2>
1818
<section id="description">
1919
<h2>Description</h2>
2020
<p>A breadcrumb trail (or 'breadcrumb navigation') helps the user to visualize how content has been structured and how to navigate back to previous web pages. Many even identify the current location in the series of web pages, commonly as the last element in the trail and with a variation in its visual style. A breadcrumb trail either displays locations in the path the user took to reach the web page, or it displays the location of the current web page within the organization of the site.</p>
21-
<p>Breadcrumb trails are implemented using links to the web pages that have been accessed in the process of navigating to the current web page. They are placed in the same location within each web page in the set.</p>
21+
<p>Breadcrumb trails are implemented using links to the web pages that have been accessed in the process of navigating to the current web page. They are placed in the same location within each web page in the set. Placing the breadcrumb high on the page, typically after the header, is a best practice and helps users quickly understand their location within the site.</p>
2222
<p>It can be helpful to users to separate the items in the breadcrumb trailing with a visible separator. Examples of separators include "&gt;", "|", "/", and "→". Alternatively, one could use decorative iconography or create separators with CSS.</p>
2323
</section>
2424
<section id="examples">

techniques/html/H91.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ <h4>Textarea example A</h4>
154154
</section>
155155
<section>
156156
<h4>Textarea example B</h4>
157-
<p>Example B has the same role, the name is set using the <code>title</code> attribute, and the value is the empty string.</p>
157+
<p>Example B has the same role and value. The name is set using the <code>title</code> attribute.</p>
158158

159159
<pre xml:space="preserve"><code class="language-html">&lt;textarea title="Type your speech here"&gt;Four score and seven years ago&lt;/textarea&gt;</code></pre>
160160
</section>

0 commit comments

Comments
 (0)