2022-11-05 17:34:37 -07:00
|
|
|
This rule is triggered when an image is missing alternate text (alt text)
|
|
|
|
|
information.
|
2022-10-29 23:21:45 -07:00
|
|
|
|
|
|
|
|
Alternate text is commonly specified inline as:
|
|
|
|
|
|
|
|
|
|
```markdown
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Or with reference syntax as:
|
|
|
|
|
|
|
|
|
|
```markdown
|
|
|
|
|
![Alternate text][ref]
|
|
|
|
|
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
[ref]: image.jpg "Optional title"
|
|
|
|
|
```
|
|
|
|
|
|
2023-10-18 23:20:19 -07:00
|
|
|
Or with HTML as:
|
|
|
|
|
|
|
|
|
|
```html
|
|
|
|
|
<img src="image.jpg" alt="Alternate text" />
|
|
|
|
|
```
|
|
|
|
|
|
2022-11-05 17:34:37 -07:00
|
|
|
Guidance for writing alternate text is available from the [W3C][w3c],
|
|
|
|
|
[Wikipedia][wikipedia], and [other locations][phase2technology].
|
2022-10-29 23:21:45 -07:00
|
|
|
|
|
|
|
|
Rationale: Alternate text is important for accessibility and describes the
|
|
|
|
|
content of an image for people who may not be able to see it.
|
2022-11-05 17:34:37 -07:00
|
|
|
|
|
|
|
|
[phase2technology]: https://www.phase2technology.com/blog/no-more-excuses
|
|
|
|
|
[w3c]: https://www.w3.org/WAI/alt/
|
|
|
|
|
[wikipedia]: https://en.wikipedia.org/wiki/Alt_attribute
|
