Skip to content

Commit

Permalink
Map Empty-heading rule to ARIA instead of WCAG (#2120)
Browse files Browse the repository at this point in the history
Co-authored-by: Jean-Yves Moyen <jym@siteimprove.com>
  • Loading branch information
WilcoFiers and Jym77 committed Oct 13, 2023
1 parent 7f4b407 commit 8f09e92
Show file tree
Hide file tree
Showing 3 changed files with 36 additions and 142 deletions.
135 changes: 30 additions & 105 deletions content-assets/wcag-act-rules/testcases.json
Original file line number Diff line number Diff line change
Expand Up @@ -18158,17 +18158,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "passed",
Expand All @@ -18182,17 +18177,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "passed",
Expand All @@ -18206,17 +18196,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "passed",
Expand All @@ -18230,17 +18215,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "passed",
Expand All @@ -18254,17 +18234,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "passed",
Expand All @@ -18278,17 +18253,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "failed",
Expand All @@ -18302,17 +18272,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "failed",
Expand All @@ -18326,17 +18291,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "failed",
Expand All @@ -18350,17 +18310,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "failed",
Expand All @@ -18374,17 +18329,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "failed",
Expand All @@ -18398,17 +18348,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "failed",
Expand All @@ -18422,17 +18367,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "failed",
Expand All @@ -18446,17 +18386,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "failed",
Expand All @@ -18470,17 +18405,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "inapplicable",
Expand All @@ -18494,17 +18424,12 @@
"ruleId": "ffd0e9",
"ruleName": "Heading has non-empty accessible name",
"ruleAccessibilityRequirements": {
"wcag20:1.3.1": {
"aria12:namecalculation": {
"title": "ARIA 1.2,5.2.8 Accessible Name Calculation",
"forConformance": true,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
},
"wcag-technique:H42": {
"forConformance": false,
"failed": "not satisfied",
"passed": "further testing needed",
"inapplicable": "further testing needed"
}
},
"expected": "inapplicable",
Expand Down
35 changes: 4 additions & 31 deletions content/rules/ffd0e9/proposed.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ github:
feedbackmail: public-wcag-act@w3.org
footer: |
<p><strong>Rule Identifier:</strong> ffd0e9</p>
<p><strong>Date:</strong> Updated 30 August 2023</p>
<p><strong>Authors:</strong> <a href="https://github.com/Jym77">Jean-Yves Moyen</a>. Contributors: <a href="https://www.w3.org/community/act-r/participants">Participants of the ACT Rules Community Group (CG)</a>.</p>
<p><strong>Date:</strong> Updated 13 October 2023</p>
<p><strong>Authors:</strong> <a href="https://github.com/Jym77">Jean-Yves Moyen</a>, <a href="https://github.com/wilcofiers">Wilco Fiers</a>. Contributors: <a href="https://www.w3.org/community/act-r/participants">Participants of the ACT Rules Community Group (CG)</a>.</p>
<p>This rule was written in the <a href="https://w3.org/community/act-r/">ACT Rules Community Group</a>. It is written as part of the EU-funded <a href="https://www.w3.org/WAI/about/projects/wai-tools/">WAI-Tools Project</a>. Implementations are part of the EU funded <a href="https://www.w3.org/WAI/about/projects/wai-coop/">WAI-CooP Project</a>. It will be reviewed by the Accessibility Guidelines Working Group (<a href="https://www.w3.org/groups/wg/ag">AG WG</a>).</p>
proposed: true
rule_meta:
Expand All @@ -20,11 +20,7 @@ rule_meta:
original_file: heading-non-empty-accessible-name-ffd0e9.md
description: |
This rule checks that each heading has a non-empty accessible name.
last_modified: 30 August 2023
scs_tested:
- handle: Info and Relationships
num: 1.3.1
level: A
last_modified: 13 October 2023
---

## Applicability
Expand Down Expand Up @@ -59,30 +55,7 @@ Completely empty headings (e.g., `<h1></h1>`) seem to be consistently ignored by
## Accessibility Requirements Mapping

<ul class="act-requirements-list">
<li><details>
<summary><span>1.3.1 Info and Relationships (Level A)</span></summary>
<ul>
<li><a href="https://www.w3.org/TR/WCAG21/#info-and-relationships">Learn more about 1.3.1 Info and Relationships</a></li>
<li><strong>Required for conformance</strong> to WCAG 2.0 and later on level A and higher.</li>
<li>Outcome mapping: <ul>
<li>Any <code>failed</code> outcomes: success criterion is not satisfied</li>
<li>All <code>passed</code> outcomes: success criterion needs further testing</li>
<li>An <code>inapplicable</code> outcome: success criterion needs further testing</li>
</ul></li>
</ul>
</details></li>
<li><details>
<summary><span>H42: Using h1-h6 to identify headings</span></summary>
<ul>
<li><a href="https://www.w3.org/WAI/WCAG21/Techniques/html/H42">Learn more about technique H42</a></li>
<li>Not required for conformance to any W3C accessibility recommendation.</li>
<li>Outcome mapping: <ul>
<li>Any <code>failed</code> outcomes: technique is not satisfied</li>
<li>All <code>passed</code> outcomes: technique needs further testing</li>
<li>An <code>inapplicable</code> outcome: technique needs further testing</li>
</ul></li>
</ul>
</details></li>
<li>This rule is <strong>not required</strong> for conformance to WCAG 2.1 at any level.</li>
</ul>

## Input Aspects
Expand Down
8 changes: 2 additions & 6 deletions wcag-mapping.json
Original file line number Diff line number Diff line change
Expand Up @@ -683,12 +683,8 @@
{
"title": "Heading has non-empty accessible name",
"permalink": "/standards-guidelines/act/rules/ffd0e9/proposed/",
"successCriteria": [
"info-and-relationships"
],
"wcagTechniques": [
"H42"
],
"successCriteria": [],
"wcagTechniques": [],
"deprecated": false,
"proposed": true
},
Expand Down

0 comments on commit 8f09e92

Please sign in to comment.