Form field label is descriptive

Applicability

This rule applies to any [programmatic label][] of an element which has one of the following [semantic roles][semantic role]:

checkbox
combobox
listbox
menuitemcheckbox
menuitemradio
radio
searchbox
slider
spinbutton
switch
textbox

and where both the element and the [programmatic label][] are [visible][].

Expectation

Each test target, together with its [visual context][], describes the purpose of the associated element.

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

Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some elements can have one of the applicable [semantic roles][semantic role] and fail this rule with some technology but users of other technologies would not experience any accessibility issue.

Background

The list of applicable [semantic roles][semantic role] is derived by taking all the [ARIA 1.2][aria12] roles that:

inherit from the input, menuitem or select role, and
are form field controls (this notably excludes menu, option or tree).

AI Prompt

Create a PHP class in the namespace "App\Services\AccessibilityAnalyzer\ActRules"
that extends "App\Services\AccessibilityAnalyzer\ActRuleRunner" and is called "FormFieldLabelDescriptiveCc0f0a" that has a function with the signature "protected function findApplicableElements(Crawler $crawler): Crawler". The base class includes the function "protected function isElementIncludedInAccessibilityTree(\DOMNode $element): bool" for determining if an element is included in the accessibility tree.

Web accessibility rule:

# Form field label is descriptive

metadata:
    id: cc0f0a
    name: 'Form field label is descriptive'
    rule_type: atomic
    description: "This rule checks that labels describe the purpose of form field elements.\n"
    accessibility_requirements: { 'wcag20:2.4.6': { forConformance: true, failed: 'not satisfied', passed: 'further testing needed', inapplicable: 'further testing needed' }, 'wcag-technique:G131': { forConformance: false, failed: 'not satisfied', passed: 'further testing needed', inapplicable: 'further testing needed' } }
    input_aspects: ['Accessibility Tree', 'DOM Tree', 'CSS Styling', Language]
    acknowledgments: { authors: ['Jean-Yves Moyen', 'Wilco Fiers'], previous_authors: ['Dagfinn Rømen', 'Geir Sindre Fossøy'], funding: [WAI-Tools] }

## Applicability

This rule applies to any [programmatic label][] of an element which has one of the following [semantic roles][semantic role]:

- `checkbox`
- `combobox`
- `listbox`
- `menuitemcheckbox`
- `menuitemradio`
- `radio`
- `searchbox`
- `slider`
- `spinbutton`
- `switch`
- `textbox`

and where both the element and the [programmatic label][] are [visible][].

## Expectation

Each test target, together with its [visual context][], describes the purpose of the associated element.

## 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

- Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some elements can have one of the applicable [semantic roles][semantic role] and fail this rule with some technology but users of other technologies would not experience any accessibility issue.

## Background

The list of applicable [semantic roles][semantic role] is derived by taking all the [ARIA 1.2][aria12] roles that:

- inherit from the `input`, `menuitem` or `select` role, and
- are form field controls (this notably excludes `menu`, `option` or `tree`).