Skip to content

Commit ee933bc

Browse files
authored
Merge pull request #16 from hackforla/Rabia2219-patch-2
Update alert-link-to-pdf-document.md
2 parents b80002f + 239cda2 commit ee933bc

12 files changed

Lines changed: 271 additions & 311 deletions

docs/known-issues-and-solutions/solutions-index/alert-link-to-pdf-document.md

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -15,25 +15,27 @@
1515

1616
WAVE Tool's Reference material on Link to PDF document may not specifically address your problem. We provide it here for optional reading.
1717

18-
<details><summary>Click to see WAVE Tool Reference</summary>
19-
20-
<!-- 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. -->
21-
22-
### WAVE Category
23-
Alerts
24-
### WAVE Error
25-
Link to PDF document
26-
### What It Means
27-
A link to a PDF document is present.
28-
### Why It Matters
29-
Unless authored with accessibility in mind, PDF documents often have accessibility issues. Additionally, PDF documents are typically viewed using a separate application or plug-in, and can thus cause confusion and navigation difficulties.
30-
### What To Do
31-
Ensure the PDF document is natively accessible. Additionally, inform the user that the link will open a PDF document. Because PDF documents may have limitations in accessibility (particularly for complex content) and require a separate program, HTML content should often be used in place of or in addition to the PDF document.
32-
### The Algorithm... in English
33-
A link to a .pdf file is present.
34-
### Standards and Guidelines
35-
None
36-
</details>
18+
??? Info "Click to see WAVE Tool Reference"
19+
20+
This content added 2026-02-26. Check for updated guidance at: <a href="https://wave.webaim.org/api/docs?format=html#link_pdf" target="_blank">https://wave.webaim.org/api/docs?format=html#link_pdf</a>
21+
22+
<!-- 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. -->
23+
24+
> ### WAVE Category
25+
> Alerts
26+
> ### WAVE Error
27+
> Link to PDF document
28+
> ### What It Means
29+
> A link to a PDF document is present.
30+
> ### Why It Matters
31+
> Unless authored with accessibility in mind, PDF documents often have accessibility > issues. Additionally, PDF documents are typically viewed using a separate application or plug- in, and can thus cause confusion and navigation difficulties.
32+
> ### What To Do
33+
> Ensure the PDF document is natively accessible. Additionally, inform the user that the link will open a PDF document. Because PDF documents may have limitations in accessibility (particularly for complex content) and require a separate program, HTML content should often be used in place of or in addition to the PDF document.
34+
> ### The Algorithm... in English
35+
> A link to a .pdf file is present.
36+
> ### Standards and Guidelines
37+
> None
38+
3739

3840
## Example of a DOM Snippet Generated From WAVE Tool
3941

docs/known-issues-and-solutions/solutions-index/alert-missing-fieldset.md

Lines changed: 24 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -15,31 +15,30 @@
1515

1616
WAVE Tool's Reference material on Missing fieldset may not specifically address your problem. We provide it here for optional reading.
1717

18-
<details><summary>Click to see WAVE Tool Reference</summary>
19-
<p>
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-
> Missing fieldset
27-
> ### What It Means
28-
> A group of check boxes or radio buttons is not enclosed in a fieldset.
29-
> ### Why It Matters
30-
> A fieldset provides a visual and structural grouping of related form elements. It is typically necessary for groups of check boxes or radio buttons where a higher level description (called a legend) is necessary to understand the function of the check boxes or radio buttons. The description will be identified by a screen reader only if provided in a fieldset legend.
31-
> ### What To Do
32-
> Determine whether the grouping of check boxes or radio buttons has or needs text that explains the purpose of the check boxes or radio button grouping. If so, mark up the group within a fieldset and put the group description in a legend element.
33-
> ### The Algorithm... in English
34-
> Two or more checkbox or radio input elements within a form have the same name value, but are not enclosed in a fieldset.
35-
> ### Standards and Guidelines
36-
> - [1.1.1 Non-text Content (Level A)](https://webaim.org/standards/wcag/checklist#sc1.1.1)
37-
> - [1.3.1 Info and Relationships (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.1)
38-
> - [2.4.6 Headings and Labels (Level AA)](https://webaim.org/standards/wcag/checklist#sc2.4.6)
39-
> - [3.3.2 Labels or Instructions (Level A)](https://webaim.org/standards/wcag/checklist#sc3.3.2)
40-
41-
</p>
42-
</details>
18+
??? Info "Click to see WAVE Tool Reference"
19+
20+
This content added 2026-02-26. Check for updated guidance at: <a href="https://wave.webaim.org/api/docs?format=html#fieldset_missing" target="_blank">https://wave.webaim.org/api/docs?format=html#fieldset_missing</a>
21+
22+
23+
<!-- 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. -->
24+
25+
> ### WAVE Category
26+
> Alerts
27+
> ### WAVE Error
28+
> Missing fieldset
29+
> ### What It Means
30+
> A group of check boxes or radio buttons is not enclosed in a fieldset.
31+
> ### Why It Matters
32+
> A fieldset provides a visual and structural grouping of related form elements. It is typically necessary for groups of check boxes or radio buttons where a higher level description (called a legend) is necessary to understand the function of the check boxes or radio buttons. The description will be identified by a screen reader only if provided in a fieldset legend.
33+
> ### What To Do
34+
> Determine whether the grouping of check boxes or radio buttons has or needs text that explains the purpose of the check boxes or radio button grouping. If so, mark up the group within a fieldset and put the group description in a legend element.
35+
> ### The Algorithm... in English
36+
> Two or more checkbox or radio input elements within a form have the same name value, but are not enclosed in a fieldset.
37+
> ### Standards and Guidelines
38+
> - [1.1.1 Non-text Content (Level A)](https://webaim.org/standards/wcag/checklist#sc1.1.1)
39+
> - [1.3.1 Info and Relationships (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.1)
40+
> - [2.4.6 Headings and Labels (Level AA)](https://webaim.org/standards/wcag/checklist#sc2.4.6)
41+
> - [3.3.2 Labels or Instructions (Level A)](https://webaim.org/standards/wcag/checklist#sc3.3.2)
4342

4443
## Example of a DOM Snippet Generated From WAVE Tool
4544

docs/known-issues-and-solutions/solutions-index/alert-orphaned-form-label.md

Lines changed: 27 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -15,34 +15,33 @@
1515

1616
WAVE Tool's Reference material on Orphaned form label may not specifically address your problem. We provide it here for optional reading.
1717

18-
<details><summary>Click to see WAVE Tool Reference</summary>
19-
<p>
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-
Alert
25-
26-
### WAVE Error
27-
Orphaned form label
28-
29-
### What It Means
30-
A form label is present, but it is not correctly associated with a form control.
31-
32-
### Why It Matters
33-
If a label is not associated with a control, screen reader users may not know the function or purpose of the form control.
34-
35-
### What To Do
36-
If the label is for a form control that is present on the page, ensure that the for attribute of the label references the id value of the associated form control. If no form control is present, either remove the label or add the missing control.
37-
38-
### The Algorithm... in English
39-
[REPLACE WITH WAVE CONTENT FOR The Algorithm... In English]
40-
41-
### Standards and Guidelines
42-
A `<label>` element does not have a properly associated form control. A label must have a for attribute value that matches the id value of a form control, or it must surround the form control itself.
43-
44-
</p>
45-
</details>
18+
??? Info "Click to see WAVE Tool Reference"
19+
20+
This content added 2026-02-26. Check for updated guidance at: https://wave.webaim.org/api/docs?format=html#label_orphaned
21+
22+
<!-- 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. -->
23+
24+
> ### WAVE Category
25+
> Alert
26+
> ### WAVE Error
27+
> Orphaned form label
28+
> ### What It Means
29+
> A form label is present, but it is not correctly associated with a form control.
30+
> ### Why It Matters
31+
> An incorrectly associated label does not provide functionality or information about the form control to the user. It usually indicates a coding or other form labeling issues.
32+
> ### What To Do
33+
> Properly associate the label with its corresponding form control. If there is no corresponding form control, remove the label. Labels are not appropriate for image, submit, reset, button, or hidden form controls.
34+
> ### The Algorithm... in English
35+
> A `<label>` element
36+
> - does not surround a form control and the for attribute is missing/empty
37+
> - references an element that is not present in the page
38+
> - references an element that is not an <input>, <select> or <textarea> element
39+
> - references an <input> element with image, submit, reset, button, or hidden type
40+
> ### Standards and Guidelines
41+
> - 1.1.1 Non-text Content (Level A)
42+
> - 1.3.1 Info and Relationships (Level A)
43+
> - 2.4.6 Headings and Labels (Level AA)
44+
> - 3.3.2 Labels or Instructions (Level A)
4645

4746
## Example of a DOM Snippet Generated From WAVE Tool
4847

docs/known-issues-and-solutions/solutions-index/alert-possible-heading.md

Lines changed: 24 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -15,32 +15,30 @@
1515

1616
WAVE Tool's Reference material on Possible heading may not specifically address your problem. We provide it here for optional reading.
1717

18-
<details><summary>Click to see WAVE Tool Reference</summary>
19-
<p>
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-
> Possible heading
27-
> ### What It Means
28-
> Text appears to be a heading but is not a heading element.
29-
> ### Why It Matters
30-
> Heading elements (`<h1>-<h6>`) provide important document structure, outlines, and navigation functionality to assistive technology users. If heading text is not a true heading, this information and functionality will not be available for that text.
31-
> ### What To Do
32-
> If the paragraph is a section heading, use a heading element instead (`<h1>-<h6>`).
33-
> ### The Algorithm... in English
34-
> A `<p>` element contains less than 50 characters and is either:
35-
> - 20 pixels or bigger
36-
> - 16 pixels or bigger and bold and/or italicized
37-
> ### Standards and Guidelines
38-
> - [1.3.1 Info and Relationships (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.1)
39-
> - [2.4.1 Bypass Blocks (Level A)](https://webaim.org/standards/wcag/checklist#sc2.4.1)
40-
> - [2.4.6 Headings and Labels (Level AA)](https://webaim.org/standards/wcag/checklist#sc2.4.6)
41-
42-
</p>
43-
</details>
18+
??? Info "Click to see WAVE Tool Reference"
19+
20+
This content added 2026-02-26. Check for updated guidance at: <a href="https://wave.webaim.org/api/docs?format=html#heading_possible" target="_blank">https://wave.webaim.org/api/docs?format=html#heading_possible</a>
21+
22+
<!-- 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. -->
23+
24+
> ### WAVE Category
25+
> Alerts
26+
> ### WAVE Error
27+
> Possible heading
28+
> ### What It Means
29+
> Text appears to be a heading but is not a heading element.
30+
> ### Why It Matters
31+
> Heading elements (`<h1>-<h6>`) provide important document structure, outlines, and navigation functionality to assistive technology users. If heading text is not a true heading, this information and functionality will not be available for that text.
32+
> ### What To Do
33+
> If the paragraph is a section heading, use a heading element instead (`<h1>-<h6>`).
34+
> ### The Algorithm... in English
35+
> A `<p>` element contains less than 50 characters and is either:
36+
> - 20 pixels or bigger
37+
> - 16 pixels or bigger and bold and/or italicized
38+
> ### Standards and Guidelines
39+
> - [1.3.1 Info and Relationships (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.1)
40+
> - [2.4.1 Bypass Blocks (Level A)](https://webaim.org/standards/wcag/checklist#sc2.4.1)
41+
> - [2.4.6 Headings and Labels (Level AA)](https://webaim.org/standards/wcag/checklist#sc2.4.6)
4442

4543
## Example of a DOM Snippet Generated From WAVE Tool
4644

docs/known-issues-and-solutions/solutions-index/alert-redundant-link.md

Lines changed: 20 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -15,28 +15,26 @@
1515

1616
WAVE Tool's Reference material on Redundant link may not specifically address your problem. We provide it here for optional reading.
1717

18-
<details><summary>Click to see WAVE Tool Reference</summary>
19-
<p>
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-
> Redundant link
27-
> ### What It Means
28-
> Adjacent links go to the same URL.
29-
> ### Why It Matters
30-
> When adjacent links go to the same location (such as a linked product image and an adjacent linked product name that go to the same product page) this results in additional navigation and repetition for keyboard and screen reader users.
31-
> ### What To Do
32-
> If possible, combine the redundant links into one link and remove any redundant text or alternative text (for example, if a product image and product name are in the same link, the image can usually be given alt="").
33-
> ### The Algorithm... in English
34-
> Two adjacent links go to the same URL.
35-
> ### Standards and Guidelines
36-
> - [2.4.4 Link Purpose (In Context) (Level A)](https://webaim.org/standards/wcag/checklist#sc2.4.4)
37-
38-
</p>
39-
</details>
18+
??? Info "Click to see WAVE Tool Reference"
19+
20+
This content added 2026-02-26. Check for updated guidance at: <a href="https://wave.webaim.org/api/docs?format=html#link_redundant" target="_blank">https://wave.webaim.org/api/docs?format=html#link_redundant</a>
21+
22+
<!-- 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. -->
23+
24+
> ### WAVE Category
25+
> Alerts
26+
> ### WAVE Error
27+
> Redundant link
28+
> ### What It Means
29+
> Adjacent links go to the same URL.
30+
> ### Why It Matters
31+
> When adjacent links go to the same location (such as a linked product image and an adjacent linked product name that go to the same product page) this results in additional navigation and repetition for keyboard and screen reader users.
32+
> ### What To Do
33+
> If possible, combine the redundant links into one link and remove any redundant text or alternative text (for example, if a product image and product name are in the same link, the image can usually be given alt="").
34+
> ### The Algorithm... in English
35+
> Two adjacent links go to the same URL.
36+
> ### Standards and Guidelines
37+
> - [2.4.4 Link Purpose (In Context) (Level A)](https://webaim.org/standards/wcag/checklist#sc2.4.4)
4038

4139
## Example of a DOM Snippet Generated From WAVE Tool
4240

docs/known-issues-and-solutions/solutions-index/alert-skipped-heading-level.md

Lines changed: 22 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -15,31 +15,28 @@
1515

1616
WAVE Tool's Reference material on Skipped heading level may not specifically address your problem. We provide it here for optional reading.
1717

18-
<details><summary>Click to see WAVE Tool Reference</summary>
19-
<p>
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-
> Skipped heading level
27-
> ### What It Means
28-
> A heading level is skipped.
29-
> ### Why It Matters
30-
> Headings provide document structure and facilitate keyboard navigation by users of assistive technology. These users may be confused or experience difficulty navigating when heading levels are skipped.
31-
> ### What To Do
32-
> Restructure the document headings to ensure that heading levels are not skipped.
33-
> ### The Algorithm... in English
34-
> A heading level is skipped (e.g., an `<h1>` is followed by an `<h3>`, with no intermediate `<h2>`). Note that an `<h1>` is not required to be the first heading within the document.
35-
> ### Standards and Guidelines
36-
> - [1.3.1 Info and Relationships (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.1)
37-
> - [2.4.1 Bypass Blocks (Level A)](https://webaim.org/standards/wcag/checklist#sc2.4.1)
38-
> - [2.4.6 Headings and Labels (Level AA)](https://webaim.org/standards/wcag/checklist#sc2.4.6)
39-
40-
41-
</p>
42-
</details>
18+
??? Info "Click to see WAVE Tool Reference"
19+
20+
This content added 2026-02-26. Check for updated guidance at: <a href="https://wave.webaim.org/api/docs?format=html#heading_skipped" target="_blank">https://wave.webaim.org/api/docs?format=html#heading_skipped</a>
21+
22+
<!-- 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. -->
23+
24+
> ### WAVE Category
25+
> Alerts
26+
> ### WAVE Error
27+
> Skipped heading level
28+
> ### What It Means
29+
> A heading level is skipped.
30+
> ### Why It Matters
31+
> Headings provide document structure and facilitate keyboard navigation by users of assistive technology. These users may be confused or experience difficulty navigating when heading levels are skipped.
32+
> ### What To Do
33+
> Restructure the document headings to ensure that heading levels are not skipped.
34+
> ### The Algorithm... in English
35+
> A heading level is skipped (e.g., an `<h1>` is followed by an `<h3>`, with no intermediate `<h2>`). Note that an `<h1>` is not required to be the first heading within the document.
36+
> ### Standards and Guidelines
37+
> - [1.3.1 Info and Relationships (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.1)
38+
> - [2.4.1 Bypass Blocks (Level A)](https://webaim.org/standards/wcag/checklist#sc2.4.1)
39+
> - [2.4.6 Headings and Labels (Level AA)](https://webaim.org/standards/wcag/checklist#sc2.4.6)
4340

4441
## Example of a DOM Snippet Generated From WAVE Tool
4542

0 commit comments

Comments
 (0)