Skip to content

Commit 16f4a1a

Browse files
committed
chore: Update branch with latest update/skipto changes and submodule updates
1 parent 090ed88 commit 16f4a1a

File tree

15 files changed

+2118
-2117
lines changed

15 files changed

+2118
-2117
lines changed

ARIA/apg/patterns/combobox/examples/combobox-autocomplete-list.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/combobox/examples/combobox-autocomplete-list/
1212

1313
sidebar: true
1414

15-
footer: " <div class='example-page-footer'> <p><a href='https://github.com/orgs/w3c/projects/118'>View issues related to this example</a></p> <p>Page last updated: 29 April 2025</p> </div> "
15+
footer: " <div class='example-page-footer'> <p><a href='https://github.com/orgs/w3c/projects/118'>View issues related to this example</a></p> <p>Page last updated: 22 October 2024</p> </div> "
1616

1717
# Context here: https://github.com/w3c/wai-aria-practices/issues/31
1818
type_of_guidance: APG
@@ -210,7 +210,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
210210
Note: Because transparent borders are visible on some systems with operating system high contrast settings enabled, transparency cannot be used to create a visual difference between the element that is focused and other elements.
211211
Instead of using transparency, the focused element has a thicker border and less padding.
212212
When an element receives focus, its border changes from zero to two pixels and padding is reduced by two pixels.
213-
When an element loses focus, its border changes from two pixels to zero and padding is increased by two pixels.
213+
When an element loses focus, its border changes from two pixels to two and padding is increased by two pixels.
214214
</li>
215215
</ul>
216216
</li>

ARIA/apg/patterns/disclosure/examples/disclosure-faq.md

Lines changed: 23 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/disclosure/examples/disclosure-faq/
1212

1313
sidebar: true
1414

15-
footer: " <div class='example-page-footer'> <p><a href='https://github.com/orgs/w3c/projects/132'>View issues related to this example</a></p> <p>Page last updated: 10 June 2025</p> </div> "
15+
footer: " <div class='example-page-footer'> <p><a href='https://github.com/orgs/w3c/projects/132'>View issues related to this example</a></p> <p>Page last updated: 22 October 2024</p> </div> "
1616

1717
# Context here: https://github.com/w3c/wai-aria-practices/issues/31
1818
type_of_guidance: APG
@@ -117,38 +117,46 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
117117
<div role="separator" id="ex_start_sep" aria-labelledby="ex_start_sep ex_label" aria-label="Start of"></div>
118118
<div id="ex1">
119119
<h3>Parking <abbr title="Frequently Asked Questions">FAQ</abbr>s</h3>
120-
<ul class="faq">
121-
<li>
120+
<dl class="faq">
121+
<dt>
122122
<button type="button" aria-expanded="false" aria-controls="faq1_desc">What do I do if I have a permit for an assigned lot, but can't find a space there?</button>
123+
</dt>
124+
<dd>
123125
<div id="faq1_desc" class="desc">
124126
Park at the nearest available parking meter without paying the meter and call 999-999-9999 to report the problem.
125127
We will note and approve your alternate location and will investigate the cause of the shortage in your assigned facility.
126128
</div>
127-
</li>
128-
<li>
129+
</dd>
130+
<dt>
129131
<button type="button" aria-expanded="false" aria-controls="faq2_desc">What do I do if I lose my permit or if my permit is stolen?</button>
132+
</dt>
133+
<dd>
130134
<div id="faq2_desc" class="desc">
131135
You should come to the Parking office and report the loss.
132136
There is a fee to replace your lost permit.
133137
However, if your permit was stolen, a copy of a police report needs to be submitted along with a stolen parking permit form for a fee replacement exemption.
134138
</div>
135-
</li>
136-
<li>
139+
</dd>
140+
<dt>
137141
<button type="button" aria-expanded="false" aria-controls="faq3_desc">Is there free parking on holidays?</button>
142+
</dt>
143+
<dd>
138144
<div id="faq3_desc" class="desc">
139145
All facilities are restricted from 2:00 am - 6:00 am on all days.
140146
No exceptions are made for any holiday or recess except those officially listed as a <q>Holidays</q> in the calendar.
141147
Please note: 24-hour rental spaces, 24-hour rental lots, and disabled parking is enforced at all times.
142148
</div>
143-
</li>
144-
<li>
149+
</dd>
150+
<dt>
145151
<button type="button" aria-expanded="false" aria-controls="faq4_desc">Do all parking facilities have the same enforcement rules?</button>
152+
</dt>
153+
<dd>
146154
<div id="faq4_desc" class="desc">
147155
Some parking facility restrictions differ from others.
148156
Be sure to take note of the signs at each lot entrance.
149157
</div>
150-
</li>
151-
</ul>
158+
</dd>
159+
</dl>
152160
</div>
153161
<div role="separator" id="ex_end_sep" aria-labelledby="ex_end_sep ex_label" aria-label="End of"></div>
154162
</section>
@@ -157,8 +165,10 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
157165
<h2>Accessibility Features</h2>
158166
<ul>
159167
<li>
160-
The semantic structure of the FAQ list is conveyed with native <code>ul</code> and <code> li</code> elements.
161-
To ensure the list structure is communicated to assistive technologies, a <code>button</code> element containing the question and a <code>div</code> element containing answer are children of an <code>li</code> element. NOTE: The <code>button</code> actions are used to hide and show the <code>div</code> element with the answer.
168+
The semantic structure of the FAQ is conveyed with native <code>dl</code>, <code>dt</code> and <code>dd</code> elements.
169+
To ensure the list structure is communicated to assistive technologies, instead of applying a button role to the <code>dt</code> element, a <code>button</code> element is contained within the <code>dt</code> element.
170+
Similarly, each <code>div</code> element containing answer content that can be shown or hidden by the button is a child of a <code>dd</code> element.
171+
Since all the <code>dd</code> elements are present in the DOM even if some answers are hidden, the <code>dl</code> structure is always complete.
162172
</li>
163173
<li>To help people with visual impairments identify the disclosure as interactive and make it easier to perceive that clicking either the disclosure button or its label changes the expanded state, when a pointer hovers over the button or its label, the background color changes, a border appears, and the cursor changes to a pointer.</li>
164174
<li>

ARIA/apg/patterns/disclosure/examples/disclosure-image-description.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/disclosure/examples/disclosure-image-description/
1212

1313
sidebar: true
1414

15-
footer: " <div class='example-page-footer'> <p><a href='https://github.com/orgs/w3c/projects/132'>View issues related to this example</a></p> <p>Page last updated: 10 June 2025</p> </div> "
15+
footer: " <div class='example-page-footer'> <p><a href='https://github.com/orgs/w3c/projects/132'>View issues related to this example</a></p> <p>Page last updated: 22 October 2024</p> </div> "
1616

1717
# Context here: https://github.com/w3c/wai-aria-practices/issues/31
1818
type_of_guidance: APG

ARIA/apg/patterns/landmarks/examples/search.html

Lines changed: 3 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -65,30 +65,11 @@ <h2>Design Patterns</h2>
6565
</ul>
6666
<div class="tab-content">
6767
<div id="tabpanel2" aria-labelledby="tab2" role="tabpanel" class="tab-pane active">
68-
<p>Use the HTML <code>search</code> element to define a <code>search</code> landmark.</p>
69-
<h3>HTML Example</h3>
70-
<br>
71-
<search>
72-
<input type="search" size="20" aria-label="search text"><input type="submit" value="Search">
73-
</search>
74-
<br>
75-
<div class="code">
76-
<strong>&lt;search&gt;</strong>
77-
<br>
78-
<br>
79-
&nbsp;&nbsp;&lt;input type="search" aria-label="search text" size="20"&gt;
80-
<br>
81-
<br>
82-
&nbsp;&nbsp;&lt;input type="submit" value="Search"&gt;
83-
<br>
84-
<br>
85-
<strong>&lt;/search&gt;</strong>
86-
<br>
87-
</div>
68+
<p>There is no HTML element that defines a <code>search</code> landmark, see the ARIA techniques for defining a <code>search</code> landmark.</p>
8869
</div>
8970
<div id="tabpanel1" aria-labelledby="tab1" role="tabpanel" class="tab-pane">
9071
<p>A <code>role="search"</code> attribute is used to define a <code>search</code> landmark.</p>
91-
<h3>ARIA Example</h3>
72+
<h3>ARIA Example</h3>
9273

9374
<form role="search">
9475

@@ -109,7 +90,7 @@ <h3>ARIA Example</h3>
10990
&lt;/form&gt;
11091
<br>
11192
</div>
112-
</div>
93+
</div>
11394
</div>
11495
</section>
11596
</main>

ARIA/apg/patterns/slider-multithumb/examples/slider-multithumb.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/slider-multithumb/examples/slider-multithumb/
1212

1313
sidebar: true
1414

15-
footer: " <div class='example-page-footer'> <p><a href='https://github.com/orgs/w3c/projects/124'>View issues related to this example</a></p> <p>Page last updated: 12 February 2025</p> </div> "
15+
footer: " <div class='example-page-footer'> <p><a href='https://github.com/orgs/w3c/projects/124'>View issues related to this example</a></p> <p>Page last updated: 12 December 2024</p> </div> "
1616

1717
# Context here: https://github.com/w3c/wai-aria-practices/issues/31
1818
type_of_guidance: APG

ARIA/apg/patterns/slider/examples/slider-temperature.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/slider/examples/slider-temperature/
1212

1313
sidebar: true
1414

15-
footer: " <div class='example-page-footer'> <p><a href='https://github.com/orgs/w3c/projects/124'>View issues related to this example</a></p> <p>Page last updated: 3 June 2025</p> </div> "
15+
footer: " <div class='example-page-footer'> <p><a href='https://github.com/orgs/w3c/projects/124'>View issues related to this example</a></p> <p>Page last updated: 22 October 2024</p> </div> "
1616

1717
# Context here: https://github.com/w3c/wai-aria-practices/issues/31
1818
type_of_guidance: APG
@@ -125,9 +125,9 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
125125
<div id="id-temp-label" class="label">Temperature</div>
126126

127127
<svg role="none" class="slider-group" width="145" height="360">
128+
<text class="temp-value" x="28" y="35">25°C</text>
129+
<rect class="rail" x="60" y="47" width="8" height="300" rx="5" aria-hidden="true" ></rect>
128130
<g role="slider" id="id-temp-slider" aria-orientation="vertical" tabindex="0" aria-valuemin="10.0" aria-valuenow="25.0" aria-valuetext="25.0 degrees Celsius" aria-valuemax="38.0" aria-labelledby="id-temp-label">
129-
<text class="temp-value" x="28" y="35">25°C</text>
130-
<rect class="rail" x="60" y="47" width="8" height="300" rx="5" aria-hidden="true" ></rect>
131131
<text class="value" x="94" y="150">25°C</text>
132132
<rect class="focus-ring" x="35" y="170" width="105" height="24" rx="12" ></rect>
133133
<rect class="thumb" x="35" y="145" width="48" height="14" rx="5" ></rect>

ARIA/apg/patterns/treegrid/examples/treegrid-1.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/treegrid/examples/treegrid-1/
1212

1313
sidebar: true
1414

15-
footer: " <div class='example-page-footer'> <p><a href='https://github.com/orgs/w3c/projects/117'>View issues related to this example</a></p> <p>Page last updated: 18 March 2025</p> </div> "
15+
footer: " <div class='example-page-footer'> <p><a href='https://github.com/orgs/w3c/projects/117'>View issues related to this example</a></p> <p>Page last updated: 22 October 2024</p> </div> "
1616

1717
# Context here: https://github.com/w3c/wai-aria-practices/issues/31
1818
type_of_guidance: APG

ARIA/apg/practices/grid-and-table-properties/grid-and-table-properties-practice.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -158,7 +158,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
158158
aria-rowcount tells assistive technologies the actual size of the grid
159159
is 463 rows even though only 4 rows are present in the markup.
160160
--&gt;
161-
&lt;table role=&quot;grid&quot; aria-rowcount=&quot;463&quot; aria-label=&quot;Student roster for history 101&quot;&gt;
161+
&lt;table role=&quot;grid&quot; aria-rowcount=&quot;463&quot;&gt;
162+
aria-label=&quot;Student roster for history 101&quot;
162163
&lt;thead&gt;
163164
&lt;tr aria-rowindex=&quot;1&quot;&gt;
164165
&lt;th&gt;Last Name&lt;/th&gt;
@@ -279,8 +280,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
279280
In this example, the first two columns with the student name are shown, but the score columns have been scrolled to show columns 10 through 13.
280281
Columns 3 through 9 are not visible so are not in the DOM.
281282
</p>
282-
<pre><code>&lt;table role=&quot;grid&quot; aria-rowcount=&quot;463&quot; aria-colcount=&quot;13&quot;
283-
aria-label=&quot;Student grades for history 101&quot;&gt;
283+
<pre><code>&lt;table role=&quot;grid&quot; aria-rowcount=&quot;463&quot; aria-colcount=&quot;13&quot;&gt;
284+
aria-label=&quot;Student grades for history 101&quot;
284285
&lt;!--
285286
aria-rowcount and aria-colcount tell assistive technologies
286287
the actual size of the grid is 463 rows by 13 columns,

ARIA/apg/practices/landmark-regions/landmark-regions-practice.md

Lines changed: 29 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -72,45 +72,58 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
7272

7373
<section>
7474
<h2>HTML Sectioning Elements</h2>
75-
<p> The following HTML sectioning elements create ARIA landmark regions.</p>
75+
<p>
76+
Several HTML sectioning elements automatically create ARIA landmark regions.
77+
So, in order to provide assistive technology users with a logical view of a page, it is important to understand the effects of using HTML sectioning elements.
78+
[[HTML-ARIA]] contains more information on HTML element role mapping.
79+
</p>
7680
<div class="table-wrap"><table class="widget-features">
7781
<caption>
78-
Landmark roles generated by HTML sectioning elements
82+
Default landmark roles for HTML sectioning elements
7983
</caption>
8084
<thead>
8185
<tr>
8286
<th>HTML Element</th>
83-
<th>Implied Landmark Role</th>
87+
88+
<th>Default Landmark Role</th>
8489
</tr>
8590
</thead>
91+
8692
<tbody>
8793
<tr>
8894
<td><code>aside</code></td>
95+
8996
<td><code>complementary</code></td>
9097
</tr>
98+
9199
<tr>
92-
<td><code>footer</code> if it is in the context of a <code>body</code> element</td>
93-
<td><code>contentinfo</code></td>
100+
<td><code>footer</code></td>
101+
102+
<td><code>contentinfo</code> when in context of the <code>body</code> element</td>
94103
</tr>
104+
95105
<tr>
96-
<td><code>header</code> if it is in the context of a <code>body</code> element</td>
97-
<td><code>banner</code></td>
106+
<td><code>header</code></td>
107+
108+
<td><code>banner</code> when in context of the <code>body</code> element</td>
98109
</tr>
110+
99111
<tr>
100112
<td><code>main</code></td>
113+
101114
<td><code>main</code></td>
102115
</tr>
116+
103117
<tr>
104118
<td><code>nav</code></td>
119+
105120
<td><code>navigation</code></td>
106121
</tr>
122+
107123
<tr>
108-
<td><code>section</code> if it has an accessible name provided by <code>aria-labelledby</code> or <code>aria-label</code></td>
109-
<td><code>region</code></td>
110-
</tr>
111-
<tr>
112-
<td><code>search</code></td>
113-
<td><code>search</code></td>
124+
<td><code>section</code></td>
125+
126+
<td><code>region</code> when it has an accessible name using <code>aria-labelledby</code> or <code>aria-label</code></td>
114127
</tr>
115128
</tbody>
116129
</table></div>
@@ -411,7 +424,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
411424

412425
<li>If a page includes more than one <code>region</code> landmark, each should have a unique label (see <a href="#aria_lh_step3">Step 3</a> above).</li>
413426

414-
<li>The <code>region</code> landmark can be used to identify content that named landmarks do not appropriately describe.</li>
427+
<li>The <code>region</code> landmark can be used identify content that named landmarks do not appropriately describe.</li>
415428
</ul>
416429

417430
<section>
@@ -444,12 +457,11 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
444457

445458
<section>
446459
<h4>HTML Technique</h4>
447-
448-
<p>Use the HTML <code>search</code> element to define a <code>search</code> landmark.</p>
460+
<p>There is no HTML element that defines a <code>search</code> landmark.</p>
449461

450462
<h4>ARIA Technique</h4>
451463

452-
<p>If the HTML <code>search</code> element technique is not being used, use a <code>role=&quot;search&quot;</code> attribute to define a <code>search</code> landmark.</p>
464+
<p>The <code>role=&quot;search&quot;</code> attribute defines a <code>search</code> landmark.</p>
453465
</section>
454466

455467
<section>

_external/aria-practices

0 commit comments

Comments
 (0)