Skip to content

Update form-field-label-descriptive-cc0f0a.md #2345

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sage-putnam wants to merge 5 commits into
base: develop
Choose a base branch
from
Open

Update form-field-label-descriptive-cc0f0a.md #2345

Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
8ddf07d
Update form-field-label-descriptive-cc0f0a.md
sage-putnam Aug 14, 2025
33f5374
update expectations per August 28th session discussion
sage-putnam Aug 28, 2025
9d8dc9e
Second update from August 28th session discussion
sage-putnam Aug 28, 2025
5638b7f
Apply suggestion from @sage-putnam
sage-putnam Oct 23, 2025
926f59f
Apply suggestion from @WilcoFiers
sage-putnam Oct 23, 2025
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
9 changes: 6 additions & 3 deletions _rules/form-field-label-descriptive-cc0f0a.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Expand All @@ -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.
Copy link
Collaborator

@kengdoj kengdoj Aug 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Each test target, together with its [visual context][], describes the purpose of the associated element.
Each test target's label, together with its [visual context][], describes the purpose of the associated element.

Copy link
Collaborator Author

@sage-putnam sage-putnam Aug 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As discussed in today's meeting, I'll be removing this and refactoring expectation 1 into two separate expectations instead. We will still need to come up with a better definition for label, however.


Expand All @@ -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
Expand Down