Skip to content
Merged
Changes from 1 commit
Commits
Show all changes
64 commits
Select commit Hold shift + click to select a range
97f74a9
adding initial switch example using input[type=checkbox]
jongund May 7, 2021
02e388c
fixed spell checker issue
jongund May 7, 2021
91aeb0b
updated documentation
jongund May 7, 2021
c00b665
add exception for the HTML validator
jongund May 7, 2021
7f943cc
checked out menu-button_links.js to use same fix in add-jump-to branch
jongund May 13, 2021
77abf1d
restored original test file
jongund May 13, 2021
a32ebb7
updated examples for on/off labels to be in content and not CSS
jongund May 27, 2021
27f2ebe
updated CSS for example to make it simplier
jongund May 28, 2021
bf5ded6
updated code to include DIV with class example-header for code pen sp…
jongund Jul 15, 2021
2d403bc
updated .vnurc file
jongund Jul 15, 2021
218de1f
fixed label not to include visual on/off text
jongund Jul 27, 2021
8e5f3be
Merge branch 'main' into switch-checkbox
jongund Jul 27, 2021
e73bc13
fixed label bug using aria-hidden=true on on and off text
jongund Jul 27, 2021
a7b41e3
identifed validator bug
jongund Jul 27, 2021
e7d7788
documented validator bug
jongund Jul 27, 2021
1d86f3f
fixed code pen issue
jongund Jul 27, 2021
6b61219
removed Enter key support
jongund Aug 3, 2021
48851af
Revise title
mcking65 Aug 29, 2021
2ca24b8
Editorial revision to intro
mcking65 Aug 29, 2021
813cbf1
further clarification of intro
mcking65 Aug 29, 2021
02da47b
Editorial changes to accessibility features for clarity and brevity
mcking65 Aug 29, 2021
063e4a7
white space
mcking65 Aug 29, 2021
4b3f267
Merge remote-tracking branch 'origin/main' into switch-checkbox
mcking65 Aug 29, 2021
60ebb9f
Further editorial clarification of accessibility features documentation
mcking65 Aug 29, 2021
0308ff2
Revise state and property descriptions
mcking65 Aug 29, 2021
93d8996
Remove unnecessary list markup from kb table
mcking65 Aug 29, 2021
4456f7e
updated spacing discription
jongund Sep 7, 2021
399fbc1
updated accessibility documentation
jongund Sep 7, 2021
50cf98b
fixed linting error
jongund Sep 7, 2021
85041af
fixed linting error
jongund Sep 7, 2021
41a801c
updated accessibility documentation
jongund Sep 8, 2021
dd2535a
updated accessibility documentation
jongund Sep 8, 2021
4372458
updated reference table
jongund Sep 21, 2021
80e26b0
udpated documentation
jongund Sep 21, 2021
a60b782
updated accessibility documentation
jongund Sep 21, 2021
197e98a
Merge branch 'main' into switch-checkbox
jongund Sep 22, 2021
b05cace
Merge branch 'main' of github.com:w3c/aria-practices
jongund Sep 28, 2021
bf32c6f
Merge branch 'main' into switch-checkbox
jongund Sep 28, 2021
e0b872f
removed statement about synchronizing with the input.checked property…
jongund Sep 28, 2021
ef6a773
Editorial clarification of accessibility features
mcking65 Oct 3, 2021
1b3f2c7
comment out links to similar examples that are not yet merged
mcking65 Oct 3, 2021
4334d0e
minor editorial change to intro
mcking65 Oct 3, 2021
499acde
Merge remote-tracking branch 'origin/main' into switch-checkbox
mcking65 Oct 3, 2021
c6e44db
Add link to example from main document
mcking65 Oct 3, 2021
66b6a55
Resolve conflicts with main and merge latest from main
mcking65 Oct 4, 2021
1a009fc
Add links to examples from main doc and between example pages
mcking65 Oct 4, 2021
6044a71
Merge branch 'main' of github.com:w3c/aria-practices
jongund Oct 5, 2021
47041ce
Merge branch 'main' of github.com:w3c/aria-practices
jongund Oct 18, 2021
13351af
Merge branch 'main' of github.com:w3c/aria-practices
jongund Oct 26, 2021
7211c39
Merge in latest from main and resolve conflicts
mcking65 Oct 29, 2021
b761845
Add links among example pages for similar examples
mcking65 Oct 29, 2021
88733e1
Merge branch 'main' of github.com:w3c/aria-practices
jongund Oct 29, 2021
ac426b1
Merge branch 'main' of github.com:w3c/aria-practices
jongund Oct 31, 2021
9c8fae3
Merge remote-tracking branch 'origin/main' into switch-checkbox
mcking65 Nov 1, 2021
b613279
Merge branch 'main' of github.com:w3c/aria-practices
jongund Nov 1, 2021
5d41df7
Merge branch 'main' into switch-checkbox
jongund Nov 1, 2021
fcc1cc4
Change /> to >
mcking65 Nov 7, 2021
2b088d8
Change /> to >
mcking65 Nov 7, 2021
f31b97c
Change /> to >
mcking65 Nov 7, 2021
2e7ee8b
Change /> to >
mcking65 Nov 7, 2021
de13911
Merge branch 'main' of github.com:w3c/aria-practices
jongund Nov 8, 2021
562fe03
Merge branch 'main' into switch-checkbox
jongund Nov 8, 2021
13face8
updated CSS properties to remove -moz-user-select and -ms-user-select
jongund Nov 8, 2021
558fc72
Remove more -moz- and -ms- properties
zcorpan Nov 10, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Editorial changes to accessibility features for clarity and brevity
  • Loading branch information
mcking65 committed Aug 29, 2021
commit 02da47b26c505d4f0af5cfe42c20f33d5b527620
21 changes: 14 additions & 7 deletions examples/switch/switch-checkbox.html
Original file line number Diff line number Diff line change
Expand Up @@ -78,19 +78,26 @@ <h2 id="ex_label">Example</h2>
<div role="separator" id="ex_end_sep" aria-labelledby="ex_end_sep ex_label" aria-label="End of"></div>
</section>

<section>
<section>
<h2>Accessibility Features</h2>
<ul>
<li>To help assistive technology users understand that the accessibility preferences are made of a group of two switches, the switches are wrapped in a <code>fieldset</code> element labeled with a <code>legend</code> element.</li>
<li>To provide a visual indication the labels can also be used to change the state of a switch, the background color is changed and a border appears when the pointer moves over the switch or the label. Including the border insures people with visual impairments can perceive the target area in high contrast modes.</li>
<li>A visual text label (i.e. &quot;on&quot; and &quot;off&quot;) of the state of the switch is placed after the graphic indication of the state to make it easier for users with visual or cognitive impairments to understand the current state of the switch.<br/>
NOTE: CSS attribute selectors are used ensure synchronization of the visual states with the value of the <code>input[type=&quot;checkbox&quot;]:checked</code> property.</li>
<li>The graphical rendering of the switch state uses 2 pixel borders for the container, and a 2 pixel border on the circle indicating the on and off position of the switch. There is 2 pixels of space between the container border and the border of the circle. The use of spacing and borders insures the graphic will be visible and discernible in high contrast modes used by people with visual impairments.
<li>To help assistive technology users understand each switch belongs to a set of switches related to <q>Accessibility Preferences</q>, the switches are wrapped in a <code>fieldset</code> element labeled with a <code>legend</code> element.</li>
<li>
To provide a visual indication the labels can also be used to change the switch state, when the pointer moves over either the switch or the label, both the switch and label are treated with a border and background color change.
Note that the border treatment is necessary for the target area to be perceivable when browser or operating system high contrast settings are enabled.
</li>
<li>
A visual text label (<q>on</q> or <q>off</q>) of the state is rendered adjacent to the graphical state indicator to make understanding the state easier for users with visual or cognitive disabilities.<br/>
NOTE: To avoid redundant state announcement by screen readers, these labels are hidden from assistive technologies with <code>aria-hidden</code>, and CSS attribute selectors ensure the label display is synchronized with the value of the <code>input</code>.
</li>
<li>Spacing and borders are used to ensure the graphics will be visible and discernible when browser or operating system high contrast settings are enabled:
<ul>
<li>Two pixel borders are used for the switch state container and the circle indicating the on and off position of the switch.</li>
<li>There are 2 pixels of space between the container border and the border of the circle.</li>
</ul>
</li>
</ul>
</section>
</section>

<section>
<h2 id="kbd_label">Keyboard Support</h2>
Expand Down