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: README.md
+4-23Lines changed: 4 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,28 +24,9 @@ Are suggestions only, or used for internal navigation/reference. Don't feel you
24
24
Tabs, indentation, comments, etc. are my personal preference. It's more important to be consistent than literal when using for your own project. Use [EditorConfig](http://editorconfig.org/) to help make this easier.
25
25
26
26
### Accessibility Testing
27
-
This page has been tested via the Chrome DevTools [Accessibility Audit](https://chrome.google.com/webstore/detail/accessibility-developer-t/fpkknkljclfencbdbgkenhalefipecmb?hl=en), as well as [WebAIM's WAVE](http://wave.webaim.org/extension/) and [Deque System's aXe](http://www.deque.com/products/axe/#aXeExtensions) accessibility testing browser extensions, as well as [Khan Academy's tota11y bookmarklet](http://khan.github.io/tota11y/). Answers to specific warnings are:
28
-
29
-
#### DevTools Audit
30
-
| Error | Reasoning |
31
-
| :---- | :-------- |
32
-
|[Warning] role=main should only appear on significant elements |`role="main"` is applied to the sole `<main>` element on the page. |
33
-
|[Warning] The purpose of each link should be clear from the link text | This is good advice. I'm going with brevity in the document for the sake of expediency, but don't do this in a production environment. |
34
-
|[Warning] These elements are focusable but either invisible or obscured by another element | This error is being triggered by the fallback markup for the `<audio>`, `<video>`, etc. elements and should be retained. |
35
-
36
-
#### aXe
37
-
| Error | Reasoning |
38
-
| :---- | :-------- |
39
-
| Documents must have `<title>` element to aid in navigation | This error is generated from the `about:blank` page in the `<iframe>` example. |
40
-
|`<html> `element must have a valid lang attribute | This error is generated from the `about:blank` page in the `<iframe>` example. |
41
-
|`<ul>` and `<ol>` must only directly contain `<li>`, `<script>` or `<template>` elements | Nested lists are valid markup. |
42
-
|`<video>` elements must have an audio description track | This error won't apply when the provided `track` attribute is linked to a valid subtitle file. |
43
-
44
-
#### WAVE
45
-
| Error | Reasoning |
46
-
| :---- | :-------- |
47
-
| Suspicious link text. Link text contains extraneous text or may not make sense out of context. | This is good advice. I'm going with brevity in the document for the sake of expediency, but don't do this in a production environment. |
48
-
| Redundant link. Adjacent links go to the same URL. | Links have been given a null value. This error shouldn't appear when actual link `href` values have been included. |
27
+
This page has been tested via the Chrome DevTools [Accessibility Audit](https://chrome.google.com/webstore/detail/accessibility-developer-t/fpkknkljclfencbdbgkenhalefipecmb?hl=en), as well as [WebAIM's WAVE](http://wave.webaim.org/extension/) and [Deque System's aXe](http://www.deque.com/products/axe/#aXeExtensions) accessibility testing browser extensions, as well as [Khan Academy's tota11y bookmarklet](http://khan.github.io/tota11y/).
28
+
29
+
Specific answers to specific warnings issues are avaiable on the [repo's Wiki](https://github.com/ericwbailey/accessible-html-content-patterns/wiki).
49
30
50
31
**A note about [ARIA](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA):** ARIA is a band-aid and not a cure-all. Use semantic markup whenever possible.
51
32
@@ -55,7 +36,7 @@ Contributions are welcome! Submit a [Pull Request](https://github.com/ericwbaile
0 commit comments