From 3ac151682728a0de2a1cdb6b70ec202b32ea0a28 Mon Sep 17 00:00:00 2001
From: Detlev Fischer
Date: Mon, 26 Feb 2024 14:29:54 +0100
Subject: [PATCH 01/22] Update use-of-color.html
Adding two examples for using color in focusing elements, one for links that have an additional underline and one for buttons where the background color changes and focused ansd unfocused background habve a contrast difference equal or better than 3:1.
---
understanding/20/use-of-color.html | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/understanding/20/use-of-color.html b/understanding/20/use-of-color.html
index 398159db4e..ead204c2f8 100644
--- a/understanding/20/use-of-color.html
+++ b/understanding/20/use-of-color.html
@@ -167,8 +167,12 @@
Examples of Use of Color
element. A legend shows the color and number for each type of element. Sighted users who
cannot perceive all the color differences can still understand the image by relying on
the numbers.
+
Focus on links
+
A page has links in blue. When they receive keyboard focus, the links are shown in a darker color. In addition, they are underlined, so the change of color is not the only indicator of focus.
+
+
Focus on buttons
+
A page has buttons with white text on a medium blue background. When the buttons receive keyboard focus, their background turns black. The difference of contrast between the unfocused and the focused button background is above 3:1. This difference of contrast means that the change of color is not the only indicator of focus.
cannot perceive all the color differences can still understand the image by relying on
the numbers.
Focus on links
-
A page has links in blue. When they receive keyboard focus, the links are shown in a darker color. In addition, they are underlined, so the change of color is not the only indicator of focus.
+
A page has text links in blue that have a contrast of 3:1 to the surrounding text. When these links receive keyboard focus, they are shown in a darker color. In addition, they are underlined, so the change of color is not the only indicator of focus.
Focus on buttons
A page has buttons with white text on a medium blue background. When the buttons receive keyboard focus, their background turns black. The difference of contrast between the unfocused and the focused button background is above 3:1. This difference of contrast means that the change of color is not the only indicator of focus.
A form that uses color and text to indicate required fields
-
A form contains both required and optional fields. Instructions at the top of the
+
A form that uses color and text to indicate required fields
+
A form contains both required and optional fields. Instructions at the top of the
form explain that required fields are labeled with red text and also with an icon.
Users who cannot perceive the difference between the optional field labels and the
red labels for the required fields will still be able to see the icon next to the
- red labels.
-
An examination
-
Students view an SVG image of a chemical compound and identify the chemical elements
+ red labels.
+
+
An examination
+
Students view an SVG image of a chemical compound and identify the chemical elements
present based both on the colors used, as well as numbers next to each
element. A legend shows the color and number for each type of element. Sighted users who
cannot perceive all the color differences can still understand the image by relying on
- the numbers.
-
Focus on links
-
A page has text links in blue that have a contrast of 3:1 to the surrounding text. When these links receive keyboard focus, they are shown in a darker color. In addition, they are underlined, so the change of color is not the only indicator of focus.
-
-
Focus on buttons
-
A page has buttons with white text on a medium blue background. When the buttons receive keyboard focus, their background turns black. The difference of contrast between the unfocused and the focused button background is above 3:1. This difference of contrast means that the change of color is not the only indicator of focus.
-
+ the numbers.
+
+
Focus on links
+
A page has text links in blue that have a contrast of 3:1 to the surrounding text. When these links receive keyboard focus, they are shown in a darker color. In addition, they are underlined, so the change of color is not the only indicator of focus.
+
+
+
+
+
Focus on buttons
+
A page has buttons with white text on a medium blue background. When the buttons receive keyboard focus, their background turns black. The difference of contrast between the unfocused and the focused button background is above 3:1. This difference of contrast means that the change of color is not the only indicator of focus.
A page has text links in blue that have a contrast of 3:1 to the surrounding text. When these links receive keyboard focus, they are shown in a darker color. In addition, they are underlined, so the change of color is not the only indicator of focus.
Focus on buttons
A page has buttons with white text on a medium blue background. When the buttons receive keyboard focus, their background turns black. The difference of contrast between the unfocused and the focused button background is above 3:1. This difference of contrast means that the change of color is not the only indicator of focus.
A page has buttons with white text on a medium blue background. When the buttons receive keyboard focus, their background turns black. The difference of contrast between the unfocused and the focused button background is above 3:1. This difference of contrast means that the change of color is not the only indicator of focus.
- The button has white text with a contrast of 5:1 on a mid-blue background. When receiving keyboard focus the background turns black. The difference of contrast to the baxkground in the unfocused state is only 4.2:1 (i.e., above 3:1).
+ The button has white text with a contrast of 5:1 on a mid-blue background. When receiving keyboard focus the background turns black. The difference of contrast between the focused and the unfocused state of the background is 4.2:1.
From d63b5d346be72750041590986f8317b9153e38eb Mon Sep 17 00:00:00 2001
From: Detlev Fischer
Date: Mon, 26 Feb 2024 18:58:40 +0100
Subject: [PATCH 07/22] Update use-of-color.html
---
understanding/20/use-of-color.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/understanding/20/use-of-color.html b/understanding/20/use-of-color.html
index 54e7e3b9bc..8d1cfd7b15 100644
--- a/understanding/20/use-of-color.html
+++ b/understanding/20/use-of-color.html
@@ -179,7 +179,7 @@
Focus on links
Focus on buttons
A page has buttons with white text on a medium blue background. When the buttons receive keyboard focus, their background turns black. The difference of contrast between the unfocused and the focused button background is above 3:1. This difference of contrast means that the change of color is not the only indicator of focus.
A page has text links in blue that have a contrast of 3:1 to the surrounding text. When these links receive keyboard focus, they are shown in a darker color. In addition, they are underlined, so the change of color is not the only indicator of focus.
+
A block of text has a text link in blue that has a contrast of 3:1 to the surrounding text. When this link receives keyboard focus, it turns into a darker blue. The contrast between the color of the focused and the unfocused state is below 3:1. In addition, the link is underlined, so the change of color is not the only indicator of focus. Without an additional focus indicator the example would fail the Success Criterion 1.4.1 Use of Color.
- The blue inline text link has a contrast of 5.5:1 to the white background. It gets darker when receiving keyboard focus and then has a contrast of 10.8:1 to the background. However, the difference of contrast to the unfocused state is only 2.0:1 (i.e., below 3:1).
+ The blue inline text link has a contrast of 5.5:1 to the white background. The link gets darker when receiving keyboard focus and then has a contrast of 10.8:1 to the background. However, the difference of contrast to the link color in unfocused state is only 2.0:1 (i.e., below 3:1).
Focus on buttons
A page has buttons with white text on a medium blue background. When the buttons receive keyboard focus, their background turns black. The difference of contrast between the unfocused and the focused button background is above 3:1. This difference of contrast means that the change of color is not the only indicator of focus.
-
- The button has white text with a contrast of 5:1 on a mid-blue background. When receiving keyboard focus the background turns black. The difference of contrast between the focused and the unfocused state of the background is 4.2:1.
+
+ Three buttons with white text on a mid-blue background with a contrast of 5:1. Keyboard focus turns the background black. The difference of contrast between the focused and the unfocused state of the background color is 4.2:1.
From ec69938e29689b48ee8ee92d4a5b255470c384ed Mon Sep 17 00:00:00 2001
From: Detlev Fischer
Date: Mon, 26 Feb 2024 19:21:10 +0100
Subject: [PATCH 10/22] Update use-of-color.html
---
understanding/20/use-of-color.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/understanding/20/use-of-color.html b/understanding/20/use-of-color.html
index e194774095..f1da4ebe29 100644
--- a/understanding/20/use-of-color.html
+++ b/understanding/20/use-of-color.html
@@ -169,7 +169,7 @@
An examination
the numbers.
Focus on links
-
A block of text has a text link in blue that has a contrast of 3:1 to the surrounding text. When this link receives keyboard focus, it turns into a darker blue. The contrast between the color of the focused and the unfocused state is below 3:1. In addition, the link is underlined, so the change of color is not the only indicator of focus. Without an additional focus indicator the example would fail the Success Criterion 1.4.1 Use of Color.
+
A block of text has a text link in blue that has a contrast of 3:1 to the surrounding text. When this link receives keyboard focus, it turns into a darker blue. The contrast difference between the link color in the focused and the unfocused state is only 2.0:1. In addition, the contrast dfference between the link and the surrounding text is now also below 3:1. To sho the keyboard focus clearly, the link is in addition underlined, so the change of color is not the only indicator of focus. Without an additional focus indicator the example would fail the Success Criterion 1.4.1 Use of Color.
The blue inline text link has a contrast of 5.5:1 to the white background. The link gets darker when receiving keyboard focus and then has a contrast of 10.8:1 to the background. However, the difference of contrast to the link color in unfocused state is only 2.0:1 (i.e., below 3:1).
From 211b9548de0e94456691f7897a506d985e5bea37 Mon Sep 17 00:00:00 2001
From: Detlev Fischer
Date: Mon, 26 Feb 2024 19:26:14 +0100
Subject: [PATCH 11/22] Update use-of-color.html
---
understanding/20/use-of-color.html | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/understanding/20/use-of-color.html b/understanding/20/use-of-color.html
index f1da4ebe29..d5f09c066a 100644
--- a/understanding/20/use-of-color.html
+++ b/understanding/20/use-of-color.html
@@ -169,7 +169,7 @@
An examination
the numbers.
Focus on links
-
A block of text has a text link in blue that has a contrast of 3:1 to the surrounding text. When this link receives keyboard focus, it turns into a darker blue. The contrast difference between the link color in the focused and the unfocused state is only 2.0:1. In addition, the contrast dfference between the link and the surrounding text is now also below 3:1. To sho the keyboard focus clearly, the link is in addition underlined, so the change of color is not the only indicator of focus. Without an additional focus indicator the example would fail the Success Criterion 1.4.1 Use of Color.
+
A block of text has a text link in blue that has a contrast of 3:1 to the surrounding text. When this link receives keyboard focus, it turns into a darker blue. The contrast difference between the link color in the focused and the unfocused state is only 2.0:1. In addition, after receiving focus the contrast difference between the link and the surrounding text is now also well below 3:1. To show the keyboard focus clearly, the link is in addition underlined, so the change of color is not the only indicator of keyboard focus. Without an additional focus indicator the example would fail the Success Criterion 1.4.1 Use of Color.
The blue inline text link has a contrast of 5.5:1 to the white background. The link gets darker when receiving keyboard focus and then has a contrast of 10.8:1 to the background. However, the difference of contrast to the link color in unfocused state is only 2.0:1 (i.e., below 3:1).
@@ -177,10 +177,10 @@
Focus on links
Focus on buttons
-
A page has buttons with white text on a medium blue background. When the buttons receive keyboard focus, their background turns black. The difference of contrast between the unfocused and the focused button background is above 3:1. This difference of contrast means that the change of color is not the only indicator of focus.
+
A page has a row of buttons with white text on a medium blue background. When one of the buttons receives keyboard focus, its background turns black. The difference of contrast between the unfocused and the focused button background is above 3:1. This difference of contrast means that a change of color is not the only indicator of focus.
-
- Three buttons with white text on a mid-blue background with a contrast of 5:1. Keyboard focus turns the background black. The difference of contrast between the focused and the unfocused state of the background color is 4.2:1.
+
+ A row buttons that all have white text on a mid-blue background with a contrast of 5:1. Keyboard focus turns the background black. The difference of contrast between the focused and the unfocused state of the button background color is 4.2:1.
From c9f188611a3c8013424f8b504999d54b4bfd4435 Mon Sep 17 00:00:00 2001
From: Detlev Fischer
Date: Fri, 8 Mar 2024 20:24:01 +0100
Subject: [PATCH 12/22] Update understanding/20/use-of-color.html
Co-authored-by: Scott O'Hara
---
understanding/20/use-of-color.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/understanding/20/use-of-color.html b/understanding/20/use-of-color.html
index d5f09c066a..bd16d46f9e 100644
--- a/understanding/20/use-of-color.html
+++ b/understanding/20/use-of-color.html
@@ -169,7 +169,7 @@
An examination
the numbers.
Focus on links
-
A block of text has a text link in blue that has a contrast of 3:1 to the surrounding text. When this link receives keyboard focus, it turns into a darker blue. The contrast difference between the link color in the focused and the unfocused state is only 2.0:1. In addition, after receiving focus the contrast difference between the link and the surrounding text is now also well below 3:1. To show the keyboard focus clearly, the link is in addition underlined, so the change of color is not the only indicator of keyboard focus. Without an additional focus indicator the example would fail the Success Criterion 1.4.1 Use of Color.
+
A block of text contains a non-underlined blue hyperlink that has a contrast of 3:1 to the surrounding text. When receiving keyboard focus, the link's text color changes to a darker blue. The contrast difference between the link color in the focused and the unfocused state is only 2:1. In addition, when focused the contrast difference between the link's text color and the surrounding text falls well below a 3:1 ratio. However, to further emphasize the focused state the link is provided an additional underline. Due to the additional underline, color is not used as the only visual indicator of the focused hyperlink, so it passes Success Criterion 1.4.1 Use of Color. Without the underline, the hyperlink would have failed this Success Criterion.
The blue inline text link has a contrast of 5.5:1 to the white background. The link gets darker when receiving keyboard focus and then has a contrast of 10.8:1 to the background. However, the difference of contrast to the link color in unfocused state is only 2.0:1 (i.e., below 3:1).
From b5c98146260d915033495004285a22778a3f9826 Mon Sep 17 00:00:00 2001
From: Detlev Fischer
Date: Fri, 8 Mar 2024 20:25:09 +0100
Subject: [PATCH 13/22] Update understanding/20/use-of-color.html
Co-authored-by: Scott O'Hara
---
understanding/20/use-of-color.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/understanding/20/use-of-color.html b/understanding/20/use-of-color.html
index bd16d46f9e..514c6ce1f6 100644
--- a/understanding/20/use-of-color.html
+++ b/understanding/20/use-of-color.html
@@ -171,7 +171,7 @@
An examination
Focus on links
A block of text contains a non-underlined blue hyperlink that has a contrast of 3:1 to the surrounding text. When receiving keyboard focus, the link's text color changes to a darker blue. The contrast difference between the link color in the focused and the unfocused state is only 2:1. In addition, when focused the contrast difference between the link's text color and the surrounding text falls well below a 3:1 ratio. However, to further emphasize the focused state the link is provided an additional underline. Due to the additional underline, color is not used as the only visual indicator of the focused hyperlink, so it passes Success Criterion 1.4.1 Use of Color. Without the underline, the hyperlink would have failed this Success Criterion.
-
+
The blue inline text link has a contrast of 5.5:1 to the white background. The link gets darker when receiving keyboard focus and then has a contrast of 10.8:1 to the background. However, the difference of contrast to the link color in unfocused state is only 2.0:1 (i.e., below 3:1).
From 8ba0a28e6d1f9b29f28a8fc7c32f4a7cce2ca7ac Mon Sep 17 00:00:00 2001
From: Detlev Fischer
Date: Fri, 8 Mar 2024 20:25:47 +0100
Subject: [PATCH 14/22] Update understanding/20/use-of-color.html
Co-authored-by: Scott O'Hara
---
understanding/20/use-of-color.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/understanding/20/use-of-color.html b/understanding/20/use-of-color.html
index 514c6ce1f6..7fba2ded2f 100644
--- a/understanding/20/use-of-color.html
+++ b/understanding/20/use-of-color.html
@@ -172,7 +172,7 @@
Focus on links
A block of text contains a non-underlined blue hyperlink that has a contrast of 3:1 to the surrounding text. When receiving keyboard focus, the link's text color changes to a darker blue. The contrast difference between the link color in the focused and the unfocused state is only 2:1. In addition, when focused the contrast difference between the link's text color and the surrounding text falls well below a 3:1 ratio. However, to further emphasize the focused state the link is provided an additional underline. Due to the additional underline, color is not used as the only visual indicator of the focused hyperlink, so it passes Success Criterion 1.4.1 Use of Color. Without the underline, the hyperlink would have failed this Success Criterion.
- The blue inline text link has a contrast of 5.5:1 to the white background. The link gets darker when receiving keyboard focus and then has a contrast of 10.8:1 to the background. However, the difference of contrast to the link color in unfocused state is only 2.0:1 (i.e., below 3:1).
+ In the default state, the blue hyperlink has a contrast of 5.5:1 to the white background. When focused the hyperlink's darker blue text color has a contrast of 10.8:1 to the background. However, the difference of contrast to the link color in unfocused state is only 2.0:1 (i.e., below 3:1).
From f3f6e71bedde431ceaf9115303d54b3107b67601 Mon Sep 17 00:00:00 2001
From: Detlev Fischer
Date: Fri, 8 Mar 2024 20:26:09 +0100
Subject: [PATCH 15/22] Update understanding/20/use-of-color.html
Co-authored-by: Scott O'Hara
---
understanding/20/use-of-color.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/understanding/20/use-of-color.html b/understanding/20/use-of-color.html
index 7fba2ded2f..a1450d2252 100644
--- a/understanding/20/use-of-color.html
+++ b/understanding/20/use-of-color.html
@@ -180,7 +180,7 @@
Focus on buttons
A page has a row of buttons with white text on a medium blue background. When one of the buttons receives keyboard focus, its background turns black. The difference of contrast between the unfocused and the focused button background is above 3:1. This difference of contrast means that a change of color is not the only indicator of focus.
- A row buttons that all have white text on a mid-blue background with a contrast of 5:1. Keyboard focus turns the background black. The difference of contrast between the focused and the unfocused state of the button background color is 4.2:1.
+ A row buttons that all have white text on a mid-blue background with a contrast of 5:1. The black button represents a button which has received keyboard focus. The difference of contrast between the focused and the unfocused state of the button's background color is 4.2:1.
From 2ac4857e413259e3ed9f8c6f76b82f54199e6a95 Mon Sep 17 00:00:00 2001
From: "Patrick H. Lauke"
Date: Sat, 16 Mar 2024 06:02:32 +0000
Subject: [PATCH 16/22] Make underline blue, expand figure caption (#3747)
A small patch to clarify one aspect of
https://github.com/w3c/wcag/pull/3717
---
understanding/20/img/textlink.svg | 862 +++++------------------------
understanding/20/use-of-color.html | 2 +-
2 files changed, 136 insertions(+), 728 deletions(-)
diff --git a/understanding/20/img/textlink.svg b/understanding/20/img/textlink.svg
index 62dc40eef4..6b55b9d34e 100644
--- a/understanding/20/img/textlink.svg
+++ b/understanding/20/img/textlink.svg
@@ -1,731 +1,139 @@
-
-
-
-