Skip to content

Commit ea88a7f

Browse files
authored
Merge pull request #21 from hackforla/Rabia2219-patch-6
Update error-missing-form-label.md
2 parents 83f8cf8 + 609c65a commit ea88a7f

3 files changed

Lines changed: 74 additions & 67 deletions

File tree

docs/known-issues-and-solutions/solutions-index/alert-layout-table.md

Lines changed: 47 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -16,32 +16,34 @@
1616

1717
WAVE Tool's Reference material on Layout table may not specifically address your problem. We provide it here for optional reading.
1818

19-
<details><summary>Click to see WAVE Tool Reference</summary>
20-
21-
<!-- Note For Wiki Author: WAVE Tool text content will use text that break markdown generation for the details dropdown. If the copy/pasted text includes angle brackets, surround them with backticks to avoid this problem. -->
22-
23-
> ### WAVE Category
24-
> Alerts
25-
> ### WAVE Error
26-
> Layout table
27-
> ### What It Means
28-
> A layout table is present.
29-
> ### Why It Matters
30-
> Layout tables exist merely to position content visually - to create columns, insert spacing, or align content neatly for sighted users. Their content is not at all tabular in nature. Layout tables should not be used in HTML5. They can introduce reading and navigation order issues. Screen readers may interpret them as data tables (i.e., announcing column and row numbers), especially if they contain table header (`<th>`) cells. This introduces significant overhead on screen reader users.
31-
> ### What To Do
32-
> In almost every case, layout tables can be replaced with other HTML elements and styled with CSS to achieve the desired visual presentation. If the table contains tabular data, provide appropriate header (`<th>`) cells. If the layout table remains, verify that the reading and navigation order of table content (based on underlying source code order) is logical and give it role="presentation" to ensure it is not identified as a table to screen reader users.
33-
> ### The Algorithm... in English
34-
> A `<table>` element is present that does not contain any header (`<th>`) cells.
35-
> ### Standards and Guidelines
36-
> - [1.3.1 Info and Relationships (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.1)
37-
> - [1.3.2 Meaningful Sequence (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.2)
19+
??? Info "Click to see WAVE Tool Reference"
20+
21+
<!-- Note For Wiki Author: WAVE Tool text content will use text that break markdown generation for the details dropdown. If the copy/pasted text includes angle brackets, surround them with backticks to avoid this problem. -->
22+
23+
This content added 2026-02-26. Check for updated guidance at: <a href="https://wave.webaim.org/api/docs?format=html#table_layout" target="_blank">https://wave.webaim.org/api/docs?format=html#table_layout</a>
24+
25+
> ### WAVE Category
26+
> Alerts
27+
> ### WAVE Error
28+
> Layout table
29+
> ### What It Means
30+
> A layout table is present.
31+
> ### Why It Matters
32+
> Layout tables exist merely to position content visually - to create columns, insert spacing, or align content neatly for sighted users. Their content is not at all tabular in nature. Layout tables should not be used in HTML5. They can introduce reading and navigation order issues. Screen readers may interpret them as data tables (i.e., announcing column and row numbers), especially if they contain table header (`<th>`) cells. This introduces significant overhead on screen reader users.
33+
> ### What To Do
34+
> In almost every case, layout tables can be replaced with other HTML elements and styled with CSS to achieve the desired visual presentation. If the table contains tabular data, provide appropriate header (`<th>`) cells. If the layout table remains, verify that the reading and navigation order of table content (based on underlying source code order) is logical and give it role="presentation" to ensure it is not identified as a table to screen reader users.
35+
> ### The Algorithm... in English
36+
> A `<table>` element is present that does not contain any header (`<th>`) cells.
37+
> ### Standards and Guidelines
38+
> - [1.3.1 Info and Relationships (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.1)
39+
> - [1.3.2 Meaningful Sequence (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.2)
3840
</details>
3941

4042
## Example of a DOM Snippet Generated From WAVE Tool
4143

42-
> ```html
43-
> [HTML snippet showing the problematic code structure that WAVE detected]
44-
> ```
44+
> ```html
45+
> [HTML snippet showing the problematic code structure that WAVE detected]
46+
> ```
4547

4648

4749
## Project Team Error guidance
@@ -77,35 +79,26 @@ The following material covers how the Project Team has provided a solution to th
7779
#### Step-By-Step Guide
7880
<!-- Author Instructions: Replace details dropdown with N/A if this does not apply -->
7981

80-
<details><summary>Click to see step-by-step guide</summary>
81-
<p>
82+
??? Info "Click to see step-by-step guide"
8283

83-
[ADD DETAILED INSTRUCTIONS HERE]
84+
[ADD DETAILED INSTRUCTIONS HERE]
8485

85-
</p>
86-
</details>
8786

8887
#### Other Technical Details
8988
<!-- Author Instructions: Write N/A if this does not apply -->
9089

91-
<details><summary>Click to see other technical details</summary>
92-
<p>
93-
94-
[ INSERT OTHER DETAILS e.g. Prop References, Return Value ]
95-
96-
</p>
97-
</details>
90+
??? Info "Click to see other technical details"
9891

92+
[ INSERT OTHER DETAILS e.g. Prop References, Return Value ]
93+
9994
#### Code Snippet With Solution
100-
<details><summary>Click to see code snippets...</summary>
101-
102-
[INSERT PATH file/path/to/Snippet.jsx]
95+
??? Info "Click to see code snippets"
10396

104-
```jsx
105-
[Code example showing the fix/solution]
106-
```
97+
[INSERT PATH file/path/to/Snippet.jsx]
10798

108-
</details>
99+
```jsx
100+
[Code example showing the fix/solution]
101+
```
109102

110103
#### Why the Fix Works
111104
<!-- Author Instruction: Add an explanation of how the code changes resolve the accessibility issue and why this approach was chosen -->
@@ -121,12 +114,21 @@ The following material covers how the Project Team has provided a solution to th
121114

122115
<!-- Author Instructions: when including markdown images, ensure they are responsive by specifying EITHER width OR height. Do not provide both. -->
123116

124-
<details><summary>1. [Descriptive Title for Screenshot Set 1]</summary>
117+
??? Info "1. Descriptive Title for Screenshot Set 1"
125118

126-
<img width="400" alt="Image" src="https://github.com/user-attachments/assets/123456789" />
119+
Description/text for image
127120

128-
</p>
129-
</details>
121+
> [INSERT IMAGE HERE]
122+
123+
Description/text for image
124+
125+
> [INSERT IMAGE HERE]
126+
127+
??? Info "1. Descriptive Title for Screenshot Set 2"
128+
129+
Descriptoin/text for image
130+
131+
> [INSERT IMAGE HERE]
130132

131133
## Credits/Authors
132134
<!-- Author Instructions: Add bullet points with GitHub handles of all HfLA members who contributed to this wiki page and/or contributed to Pull Requests that provided solutions for this page -->

docs/known-issues-and-solutions/solutions-index/error-missing-form-label.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -134,7 +134,7 @@ The following material covers how the Project Team has provided a solution to th
134134
135135
??? Info "1. [Descriptive Title for Screenshot Set 1]"
136136
137-
> ![Image](https://github.com/user-attachments/assets/123456789)
137+
> [INSERT IMAGE HERE]
138138
139139
140140
## Credits/Authors

docs/known-issues-and-solutions/solutions-index/test-file.md

Lines changed: 26 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -22,28 +22,28 @@ WAVE Tool's Reference material on Orphaned form label may not specifically addre
2222

2323
<!-- Note For Wiki Author: WAVE Tool text content will use text that break markdown generation for the details dropdown. If the copy/pasted text includes angle brackets, surround them with backticks to avoid this problem. -->
2424

25-
> ### WAVE Category
26-
> Alerts
27-
> ### WAVE Error
28-
> Layout table
29-
> ### What It Means
30-
> A layout table is present.
31-
> ### Why It Matters
32-
> Layout tables exist merely to position content visually - to create columns, insert spacing, or align content neatly for sighted users. Their content is not at all tabular in nature. Layout tables should not be used in HTML5. They can introduce reading and navigation order issues. Screen readers may interpret them as data tables (i.e., announcing column and row numbers), especially if they contain table header (`<th>`) cells. This introduces significant overhead on screen reader users.
33-
> ### What To Do
34-
> In almost every case, layout tables can be replaced with other HTML elements and styled with CSS to achieve the desired visual presentation. If the table contains tabular data, provide appropriate header (`<th>`) cells. If the layout table remains, verify that the reading and navigation order of table content (based on underlying source code order) is logical and give it role="presentation" to ensure it is not identified as a table to screen reader users.
35-
> ### The Algorithm... in English
36-
> A `<table>` element is present that does not contain any header (`<th>`) cells.
37-
> ### Standards and Guidelines
38-
> - [1.3.1 Info and Relationships (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.1)
39-
> - [1.3.2 Meaningful Sequence (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.2)
25+
### WAVE Category
26+
Alerts
27+
### WAVE Error
28+
Layout table
29+
### What It Means
30+
A layout table is present.
31+
### Why It Matters
32+
Layout tables exist merely to position content visually - to create columns, insert spacing, or align content neatly for sighted users. Their content is not at all tabular in nature. Layout tables should not be used in HTML5. They can introduce reading and navigation order issues. Screen readers may interpret them as data tables (i.e., announcing column and row numbers), especially if they contain table header (`<th>`) cells. This introduces significant overhead on screen reader users.
33+
### What To Do
34+
In almost every case, layout tables can be replaced with other HTML elements and styled with CSS to achieve the desired visual presentation. If the table contains tabular data, provide appropriate header (`<th>`) cells. If the layout table remains, verify that the reading and navigation order of table content (based on underlying source code order) is logical and give it role="presentation" to ensure it is not identified as a table to screen reader users.
35+
### The Algorithm... in English
36+
A `<table>` element is present that does not contain any header (`<th>`) cells.
37+
### Standards and Guidelines
38+
- [1.3.1 Info and Relationships (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.1)
39+
- [1.3.2 Meaningful Sequence (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.2)
4040

4141

4242
## Example of a DOM Snippet Generated From WAVE Tool
4343

44-
> ```html
45-
> [HTML snippet showing the problematic code structure that WAVE detected]
46-
> ```
44+
```html
45+
[HTML snippet showing the problematic code structure that WAVE detected]
46+
```
4747

4848

4949
## Project Team Error guidance
@@ -116,11 +116,16 @@ The following material covers how the Project Team has provided a solution to th
116116

117117
<!-- Author Instructions: when including markdown images, ensure they are responsive by specifying EITHER width OR height. Do not provide both. -->
118118

119-
<details><summary>1. [Descriptive Title for Screenshot Set 1]</summary>
119+
??? Info "1. [Descriptive Title for Screenshot Set 1]"
120120

121-
[INSERT IMAGE HERE]
121+
Description/text for image
122+
123+
![Image](https://github.com/user-attachments/assets/a61292ba-4212-403f-9583-212e0f4314e1)
124+
125+
Description/text for image
126+
127+
<img width="240" height="240" alt="image" src="https://github.com/user-attachments/assets/6470b47a-199d-4075-9cee-5337cd8af11d" />
122128

123-
</details>
124129

125130
## Credits/Authors
126131
<!-- Author Instructions: Add bullet points with GitHub handles of all HfLA members who contributed to this wiki page and/or contributed to Pull Requests that provided solutions for this page -->

0 commit comments

Comments
 (0)