Skip to content

Commit

Permalink
Merge pull request #3180 from laurwill/patch-3
Browse files Browse the repository at this point in the history
Clarifying new aria guidance
  • Loading branch information
danbrady authored Sep 12, 2024
2 parents b2fe132 + 70efa39 commit 7b7d277
Showing 1 changed file with 5 additions and 3 deletions.
8 changes: 5 additions & 3 deletions src/_includes/content/phone-numbers.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,12 @@ Using the [Telephone component]({{ site.baseurl }}/components/telephone) will ap
* Use a verb ahead of the number. Use "call" or "call us at..." for phone numbers and "text" or "text us at" for text numbers.
* When a phone number has (TTY: 711) included, it should be formatted in parenthesis directly following the phone number. Example: 866-440-1238 (TTY: 711) or 866-440-1238, ext. 4 (TTY: 711)

### Links
* Hyperlink all phone numbers, including TTY numbers. It’s not a requirement to link the "call" or "text" verb that precedes the number. We do however include "TTY" in the link and aria label to make it clear that it's specifically for TTY so that users who need the service see it and so those who do not do not unintentionally call a TTY number.
### Links and aria
* Hyperlink all phone numbers, including (TTY: 711). Include "TTY:" in the link. Don't link the "call" or "text" verb that precedes the number.
Example: `<a href="tel:2021231234"> 202-123-1234 </a> (<a href="tel:711">TTY: 711</a>)`
* **New guidance as of August 2024:** You no longer need to use aria labels on phone numbers or TTY. This shift came out of evolving accessibility guidance for people who use assistive technology. Teams should stop adding aria labels to phone numbers and TTY in new content, but the shift will take time to implement on existing content. If you have questions, contact the Sitewide Content, Accessibility, and Information Architecture (CAIA) team.

If for some reason you cannot use the Telephone component, you are responsible for meeting the same formatting and accessibility guidance when creating links to phone numbers.
**Note:** If for some reason you cannot use the Telephone component, you are responsible for meeting the same formatting and accessibility guidance when creating links to phone numbers.

### Don't use vanity phone numbers in body copy
We don’t use vanity phone numbers in body copy, as it adds visual noise and is not helpful to screen readers. We use and hyperlink only the numeric phone number in body copy.
Expand Down

0 comments on commit 7b7d277

Please sign in to comment.