Skip to content

Commit 6d700a0

Browse files
committed
add missing callout class
1 parent c4b85b1 commit 6d700a0

File tree

7 files changed

+18
-18
lines changed

7 files changed

+18
-18
lines changed

docs/topics/code/accessible-name/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ A proper accessible name for HTML elements is essential for screen reader users
2020

2121
Abdulqudus Abubakre gives an excellent, detailed writeup of the accessible name [Understanding Accessible Names in HTML](https://dev.to/ibn_abubakre/understanding-accessible-names-in-html-562).
2222

23-
{: .info }
23+
{: .callout .info }
2424
Note: An `aria-label` attribute on a link or a button overrides all textual content within.
2525
For example, the accessible name of the button `<button aria-label="Close">Open</button>` is "Close".
2626

@@ -59,7 +59,7 @@ The accessibility tree of Chrome shows the following relevant information: the a
5959
- Focused: true
6060
- Expanded: false
6161

62-
{: .info }
62+
{: .callout .info }
6363
In this example the accessible name is taken from "Contents". The other options are not specified. An accessible name can be overwritten. Here the different steps for defining an accessible name are shown and sorted in order of the computation. A value for the `aria-label` will overwrite the Contents value.
6464

6565
![Screenshot accessible name menu in Chrome]({{site.baseurl}}/assets/images/accessible-name-button.png)

docs/topics/content/links/link-text.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ nav_order: 2
1111
This content will be reviewed, restructured and expanded.
1212
Related issue on [GitHub #110 Topic Write a meaningful link text](https://github.com/wpaccessibility/wp-a11y-docs/issues/110).
1313

14-
{: .tip }
14+
{: .callout .tip }
1515
**Rule of thumb**: a link text should describe the resource that it links to, so that when the text is read out of context the user will still know what to expect. A link is a promise, not a surprise.
1616

1717
Link text should stand on its own. Some assistive software scans a page for links and presents them to the user as a simple list. In these situations, all the links will be read out of context. So it is important the text used in a link is descriptive and meaningful.
@@ -34,11 +34,11 @@ With these types of links, users have to read the whole sentence to understand t
3434
<figcaption>Useless, non-descriptive link text in the Apple VoiceOver link list.</figcaption>
3535
</figure>
3636

37-
{: .dont}
37+
{: .callout .dont }
3838
Poor qualify (non-descriptive) link texts:
3939
If you are interested in our work, [click here](#dummy-link) to subscribe to our newsletter. You can [download](#dummy-link) the manual of the espresso machine, or contact us for more [info](#dummy-link).
4040

41-
{: .do }
41+
{: .callout .do }
4242
Helpful (descriptive) link texts:
4343
[Subscribe to our newsletter](#dummy-link) if you are interested in our work. You can download the [manual as a PDF]((#dummy-link) ) of the espresso machine, or [contact us](#dummy-link) for more info.
4444

@@ -61,11 +61,11 @@ Sequences of all capital letters are harder to read for people with dyslexia, sc
6161

6262
Some URLs are highly readable, such as “wordpress.org”. Others are almost impossible to parse as language. In most cases, you should avoid using a URL as the visible link text. If you are explicitly referring to a web address, keep it short: [wordpress.org](https://www.wordpress.org) instead of [https://www.wordpress.org](https://www.wordpress.org).
6363

64-
{: .dont}
64+
{: .callout .dont }
6565
Poor quality (non-descriptive) link texts:
6666
If you are interested in our work, [click here](#dummy-link) to subscribe to our newsletter. You can [download](#dummy-link) the manual of the espresso machine, or contact us for more [info](#dummy-link).
6767

68-
{: .do}
68+
{: .callout .do }
6969
Helpful (descriptive) link texts:
7070
[Subscribe to our newsletter]((#dummy-link)) if you are interested in our work. You can download the [manual as a PDF]((#dummy-link)) of the espresso machine, or [contact us](#dummy-link) for more info.
7171

docs/topics/forms/descriptions/connect-description.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ For the documentation about descriptions in fieldsets read [Description with a f
4949

5050
## Examples
5151

52-
{: .dont }
52+
{: .callout .dont }
5353
No connection between a form field and its description.
5454

5555
```html
@@ -66,7 +66,7 @@ No connection between a form field and its description.
6666
/>
6767
```
6868

69-
{: .do }
69+
{: .callout .do }
7070
Connection between a form field and its description.
7171

7272
```html

docs/topics/forms/descriptions/location-description.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Also check the [description decision tree]({{site.baseurl}}/docs/topics/forms/de
2121

2222
## Examples
2323

24-
{: .do }
24+
{: .callout .do }
2525
Place descriptions in a consistent location, preferably between the label and the form field.
2626

2727
```html
@@ -38,7 +38,7 @@ Place descriptions in a consistent location, preferably between the label and th
3838
/>
3939
```
4040

41-
{: .do }
41+
{: .callout .do }
4242
Place all descriptions, including error messages, in a consistent location, preferably between the label and the form field.
4343

4444
```html
@@ -59,7 +59,7 @@ Place all descriptions, including error messages, in a consistent location, pref
5959
```
6060

6161

62-
{: .dont }
62+
{: .callout .dont }
6363
Avoid placing the description below the form field.
6464

6565
```html
@@ -78,7 +78,7 @@ Avoid placing the description below the form field.
7878
```
7979

8080

81-
{: .dont }
81+
{: .callout .dont }
8282
Do not place a description above the form field and an error message below it. Be consistent in the location of descriptions.
8383

8484
```html

docs/topics/forms/fieldsets/fieldset-descriptions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ In HTML, simplified
4343

4444
## Examples
4545

46-
{: .do }
46+
{: .callout .do }
4747
Connect a description to the form field, using aria-describedby.
4848

4949
```html

docs/topics/forms/input-label/accessible-name.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ Visual text or equivalent, like a search icon, should always be visible, so sigh
110110

111111
If you must hide a label or control from vision, use the CSS class [`.screen-reader-text`](https://make.wordpress.org/accessibility/handbook/best-practices/markup/the-css-class-screen-reader-text/) or equivalent.
112112

113-
{: .dont }
113+
{: .callout .dont }
114114
Don't use the CSS `display: none`, `visibility: hidden` or the HTML attribute `hidden` on a label, as that also removes the element, and its accessible name, from the accessibility tree.
115115

116116
```html
@@ -127,7 +127,7 @@ Don't use the CSS `display: none`, `visibility: hidden` or the HTML attribute `h
127127
<button>Search</button>
128128
```
129129

130-
{: .do }
130+
{: .callout .do }
131131
Always add a visible hint about how to fill out the form field.
132132
<label for="search-text" class="screen-reader-text">Search this website</label>
133133
<input type="text" name="s" id="search-text">

docs/topics/forms/input-label/text-only.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ The populair [WordPress form plugin Contact Form 7](https://wordpress.org/plugin
4040

4141
## Examples
4242

43-
{: .do }
43+
{: .callout .do }
4444
Place the link to the terms of delivery outside and above the label.
4545
[The terms of delivery](#).
4646
<input id="alv3" type="checkbox"/>
@@ -56,7 +56,7 @@ Place the link to the terms of delivery outside and above the label.
5656

5757
Note that the reading order is also meaningful: first the link to the terms and after that the checkbox to agree with them.
5858

59-
{: .dont }
59+
{: .callout .dont }
6060
Place the link to the terms of delivery inside the label.
6161
<input id="alv4" type="checkbox"/>
6262
<label for="alv4">I agree with [the terms of delivery](#)</label>

0 commit comments

Comments
 (0)