You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _rules/heading-descriptive-b49b2e.md
+15-17Lines changed: 15 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,17 +31,15 @@ This rule applies to any [semantic][semantic role] `heading` element that is [in
31
31
32
32
## Expectation
33
33
34
-
Each target element describes the topic or purpose of the first [perceivable content][] after the test target that is not [decorative][].
34
+
Each target element describes the topic or purpose of the first [perceivable content][] after the test target that is not [decorative][]. The order of elements is determined by the [flat tree][].
35
35
36
-
The order of elements is determined by the [flat tree][].
37
-
38
-
**Note:** Headings do not need to be lengthy. A word, or even a single character, may suffice.
36
+
**Note:** Headings do not need to be lengthy. A word, or even a single character, may be sufficient.
39
37
40
38
## Assumptions
41
39
42
-
This rule assumes that the [flat tree][] order is close to the reading order, as elements are rendered on the page. Due to positioning, it is possible to render a document in an order that greatly differs from the tree order, in which case the content which is visually associated with a heading might not be the content following it in tree order and this rule might fail while [Success Criterion 2.4.6 Headings and Label][sc246] is still satisfied.
40
+
This rule assumes that the [flat tree][] order is close to the reading order as elements are rendered on the page. Due to positioning, it is possible to render a document in an order that greatly differs from the tree order, in which case the content which is visually associated with a heading might not be the content following it in tree order and this rule might fail while [Success Criterion 2.4.6 Headings and Label][sc246] is still satisfied.
43
41
44
-
This rule also assumes that the content the heading is intended to describe is [visible][] and not hidden from AT. Otherwise, cases such as expandable content using a heading might fail this rule while [Success Criterion 2.4.6 Headings and Label][sc246] is still satisfied.
42
+
This rule also assumes that the content the heading is intended to describe is [visible][] and not hidden from assistive technologies. Otherwise, cases such as expandable content using a heading might fail this rule while [Success Criterion 2.4.6 Headings and Label][sc246] is still satisfied.
45
43
46
44
## Accessibility Support
47
45
@@ -66,7 +64,7 @@ Headings that are visible but not in the accessibility tree are a failure of [Su
66
64
67
65
#### Passed Example 1
68
66
69
-
Heading marked up with `h1` element that describes the topic or purpose of the following [perceivable content][].
67
+
This `h1`heading element describes the topic of the following paragraph.
70
68
71
69
```html
72
70
<htmllang="en">
@@ -77,7 +75,7 @@ Heading marked up with `h1` element that describes the topic or purpose of the f
77
75
78
76
#### Passed Example 2
79
77
80
-
Heading marked up with `role="heading"` that describes the topic or purpose of the following [perceivable content][].
78
+
This heading marked up with an [explicit role][] of `heading`describes the topic of the following paragraph.
81
79
82
80
```html
83
81
<htmllang="en">
@@ -88,7 +86,7 @@ Heading marked up with `role="heading"` that describes the topic or purpose of t
88
86
89
87
#### Passed Example 3
90
88
91
-
Heading marked up with `h1` element with an image that describes the topic or purpose of the following [perceivable content][].
89
+
This `h1`heading element with an image describes the topic of the following paragraph.
92
90
93
91
```html
94
92
<htmllang="en">
@@ -101,7 +99,7 @@ Heading marked up with `h1` element with an image that describes the topic or pu
101
99
102
100
#### Passed Example 4
103
101
104
-
Heading marked up with `h1` element that is a single character that describes the topic or purpose of the following [perceivable content][].
102
+
This `h1`heading element has a single character text that describes the topic of the following description list.
105
103
106
104
```html
107
105
<htmllang="en">
@@ -121,7 +119,7 @@ Heading marked up with `h1` element that is a single character that describes th
121
119
122
120
#### Passed Example 5
123
121
124
-
Heading marked up with `role="heading"` that describes the topic or purpose of the following [perceivable content][]. The heading is positioned off screen but is [included in the accessibility tree][].
122
+
This heading marked up with an [explicit role][] of `heading`describes the topic of the following paragraph. The heading is positioned off screen but is [included in the accessibility tree][].
125
123
126
124
```html
127
125
<htmllang="en">
@@ -148,7 +146,7 @@ This heading describes the first [perceivable content][] after it (the first `p`
148
146
149
147
#### Failed Example 1
150
148
151
-
Heading marked up with `h1` element that does not describe the topic or purpose of the following [perceivable content][].
149
+
This `h1`heading element does not describes the topic of the following paragraph.
152
150
153
151
```html
154
152
<htmllang="en">
@@ -159,7 +157,7 @@ Heading marked up with `h1` element that does not describe the topic or purpose
159
157
160
158
#### Failed Example 2
161
159
162
-
Heading marked up with `role="heading"` that does not describe the topic or purpose of the following [perceivable content][].
160
+
This heading marked up with an [explicit role][] of `heading`does not describe the topic of the following paragraph.
163
161
164
162
```html
165
163
<htmllang="en">
@@ -170,7 +168,7 @@ Heading marked up with `role="heading"` that does not describe the topic or purp
170
168
171
169
#### Failed Example 3
172
170
173
-
Heading marked up with `role="heading"` that does not describe the topic or purpose of the following [perceivable content][]. The heading is positioned off screen but is [included in the accessibility tree][].
171
+
This heading marked up with an [explicit role][] of `heading`does not describe the topic of the following paragraph. The heading is positioned off screen but is [included in the accessibility tree][].
174
172
175
173
```html
176
174
<htmllang="en">
@@ -183,7 +181,7 @@ Heading marked up with `role="heading"` that does not describe the topic or purp
183
181
184
182
#### Failed Example 4
185
183
186
-
This heading does not describe the first [perceivable content][] after it (the first `p` element). The next [perceivable content][] (the second `p` element) is not considered by this rule.
184
+
This `h1`heading element does not describe the first [perceivable content][] after it (the first `p` element). The next [perceivable content][] (the second `p` element) is not considered by this rule.
187
185
188
186
```html
189
187
<htmllang="en">
@@ -207,7 +205,7 @@ There is no heading.
207
205
208
206
#### Inapplicable Example 2
209
207
210
-
Heading is not [included in the accessibility tree][].
208
+
This `h1` heading element is not [included in the accessibility tree][].
211
209
212
210
```html
213
211
<htmllang="en">
@@ -218,7 +216,7 @@ Heading is not [included in the accessibility tree][].
218
216
219
217
#### Inapplicable Example 3
220
218
221
-
`h1` element has an empty [accessible name][].
219
+
This `h1` heading element has an empty [accessible name][].
0 commit comments