Skip to content

Commit 591b183

Browse files
authored
Merge pull request #3346 from department-of-veterans-affairs/external-link-docs
Add a11y note on external link
2 parents cc721f5 + fb4de0a commit 591b183

File tree

1 file changed

+1
-0
lines changed

1 file changed

+1
-0
lines changed

src/_components/link/index.md

+1
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,7 @@ Refer to the [Content Style Guide on Links]({{ site.baseurl }}/content-style-gui
129129
- **Keyboard navigation.** The user must be able to navigate to links using the Tab key and activate links using the Enter key.
130130
- **Purpose and target.** Link text that doesn't indicate a clear purpose or destination makes it harder for everyone--especially screen reader users--to understand where they're getting routed off to.
131131
- **External links must indicate that they are external.** Follow the methods detailed in [linking to external sites]({{ site.baseurl }}/content-style-guide/links#linking-to-external-sites).
132+
- By default, the link component's external link variation will append the text, "(opens in a new tab)", instead of using an icon. This follows [Techniques for WCAG 2.0](https://www.w3.org/TR/WCAG20-TECHS/G201.html) advice on providing users with both a spoken and visual warning that this link opens in a new tab.
132133

133134
{% include content/links-vs-buttons.md %}
134135

0 commit comments

Comments
 (0)