From 8ddf07de7c628d4e0af009f0739d600e1b3a9c67 Mon Sep 17 00:00:00 2001 From: sage-putnam <163018910+sage-putnam@users.noreply.github.com> Date: Thu, 14 Aug 2025 11:12:56 -0400 Subject: [PATCH 1/5] Update form-field-label-descriptive-cc0f0a.md --- _rules/form-field-label-descriptive-cc0f0a.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/_rules/form-field-label-descriptive-cc0f0a.md b/_rules/form-field-label-descriptive-cc0f0a.md index 6487aab98e2..c8a12cefe58 100755 --- a/_rules/form-field-label-descriptive-cc0f0a.md +++ b/_rules/form-field-label-descriptive-cc0f0a.md @@ -34,7 +34,7 @@ acknowledgments: ## Applicability -This rule applies to any [programmatic label][] of an element which has one of the following [semantic roles][semantic role]: +This rule applies to any element which has one of the following [semantic roles][semantic role]: - `checkbox` - `combobox` @@ -50,7 +50,11 @@ This rule applies to any [programmatic label][] of an element which has one of t and where both the element and the [programmatic label][] are [visible][]. -## Expectation +## Expectation 1 + +Each test target has a label, and the label is descriptive. + +## Expectation 2 Each test target, together with its [visual context][], describes the purpose of the associated element. @@ -69,7 +73,6 @@ Having a [label][] which is not included in the [accessible name][] is a violati ### Assumptions -- This rule assumes that [labels][label] are intended for sighted users, and that hiding a [visible][] [label][] from assistive technologies, is a failure of [Success Criterion 4.1.2: Name, Role and Value][sc412], but not of [Success Criterion 2.4.6: Headings and Labels][sc246]. - This rule assumes that the [programmatic labels][programmatic label] of an element are also part of its [visual context][]. ### Accessibility Support From 33f5374237d62f43c0921aa5bcff7fcddf38af51 Mon Sep 17 00:00:00 2001 From: sage-putnam <163018910+sage-putnam@users.noreply.github.com> Date: Thu, 28 Aug 2025 11:06:58 -0400 Subject: [PATCH 2/5] update expectations per August 28th session discussion --- _rules/form-field-label-descriptive-cc0f0a.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_rules/form-field-label-descriptive-cc0f0a.md b/_rules/form-field-label-descriptive-cc0f0a.md index c8a12cefe58..9b93035d91b 100755 --- a/_rules/form-field-label-descriptive-cc0f0a.md +++ b/_rules/form-field-label-descriptive-cc0f0a.md @@ -52,11 +52,11 @@ and where both the element and the [programmatic label][] are [visible][]. ## Expectation 1 -Each test target has a label, and the label is descriptive. +Each test target has at least one label, and the label is descriptive. ## Expectation 2 -Each test target, together with its [visual context][], describes the purpose of the associated element. +All of the test target's labels describe the purpose of the test target. ## Background From 9d8dc9ee163c9e979d5b6503578868201d2886e5 Mon Sep 17 00:00:00 2001 From: sage-putnam <163018910+sage-putnam@users.noreply.github.com> Date: Thu, 28 Aug 2025 11:07:56 -0400 Subject: [PATCH 3/5] Second update from August 28th session discussion --- _rules/form-field-label-descriptive-cc0f0a.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_rules/form-field-label-descriptive-cc0f0a.md b/_rules/form-field-label-descriptive-cc0f0a.md index 9b93035d91b..9e31d2534fa 100755 --- a/_rules/form-field-label-descriptive-cc0f0a.md +++ b/_rules/form-field-label-descriptive-cc0f0a.md @@ -52,7 +52,7 @@ and where both the element and the [programmatic label][] are [visible][]. ## Expectation 1 -Each test target has at least one label, and the label is descriptive. +Each test target has at least one label. ## Expectation 2 From 5638b7f5d1e2746947c1d3cb4187400eb9986f31 Mon Sep 17 00:00:00 2001 From: sage-putnam <163018910+sage-putnam@users.noreply.github.com> Date: Thu, 23 Oct 2025 10:56:32 -0400 Subject: [PATCH 4/5] Apply suggestion from @sage-putnam --- _rules/form-field-label-descriptive-cc0f0a.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/_rules/form-field-label-descriptive-cc0f0a.md b/_rules/form-field-label-descriptive-cc0f0a.md index 9e31d2534fa..7f90db784a6 100755 --- a/_rules/form-field-label-descriptive-cc0f0a.md +++ b/_rules/form-field-label-descriptive-cc0f0a.md @@ -52,7 +52,9 @@ and where both the element and the [programmatic label][] are [visible][]. ## Expectation 1 -Each test target has at least one label. +Each test target is positioned and styled so that it has a visual relationship with at least one [label][]. + +**Note**: Labels are not just adjacent text. They can include captions or headings for groups of controls or adjacent buttons, and they may be non-textual content. ## Expectation 2 From 926f59f2b78096343cab51763813c55d466586b9 Mon Sep 17 00:00:00 2001 From: sage-putnam <163018910+sage-putnam@users.noreply.github.com> Date: Thu, 23 Oct 2025 10:56:48 -0400 Subject: [PATCH 5/5] Apply suggestion from @WilcoFiers Co-authored-by: Wilco Fiers --- _rules/form-field-label-descriptive-cc0f0a.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_rules/form-field-label-descriptive-cc0f0a.md b/_rules/form-field-label-descriptive-cc0f0a.md index 7f90db784a6..6f45af32f4a 100755 --- a/_rules/form-field-label-descriptive-cc0f0a.md +++ b/_rules/form-field-label-descriptive-cc0f0a.md @@ -58,7 +58,7 @@ Each test target is positioned and styled so that it has a visual relationship w ## Expectation 2 -All of the test target's labels describe the purpose of the test target. +Each test target's purpose is described by its labels (from expectation 1). ## Background