2.3: Links

In this section, we review how to add accessible links to content. Links include weblinks, links between different chapters of a book, links within a chapter, and links to attached files.

What are links?

A link (also called a hyperlink) is found in a file, document, or web page that redirects the reader to additional information found in another online location such as a new web page; links are typically activated by clicking on a highlighted word or image on the screen.

File types used: HTML, PDF, DOCX, XLS

Why are you including the links you have selected?

Generally, links are included within content to point the user to additional information that is available at another location. Links between different parts of a book are also used to facilitate navigation.

For a detailed description on how to link to material in Pressbooks, see Hyperlink Material in the Pressbooks Guide.

Who are you doing this for?

This work supports students who:

• Have a physical disability, like Trish
• Have a form of cognitive disability, like Ann
• Are deaf or hard of hearing, like Steven
• Are blind or have low vision, like Jacob and Diana

---

What do you need to do?

Links can be helpful. But, like other non-text elements, they must be assessed for how students with a range of challenges can and will access them. Understanding and attending to these needs through descriptive text, proper link opening, and—when needed—a web address will ensure that all students can benefit.

Create descriptive link text

You need to ensure that all links have text that describes the topic or purpose of the link. This is important because people using screen readers might have their screen reader set to read out the text for each link on a page. As such, the link text must describe the content of the link when taken out of context for the surrounding paragraph. While link texts such as “click here” or “read more” will make sense to sighted users, they mean nothing when read on their own.^[1]

Example 1: Click here for information on LibreTexts.

Example 2: You can find more information onLibreTexts at https://libretexts.org/.

Example 3: Information on LibreTexts is available online.

While the first two examples make sense in the context of the sentence, neither link text describes the purpose of its link. While the second example is better than the first, having the web address as the link text still does not make the purpose of the link clear. The third example is the most accessible.

Link to non-web content

If you want to link to something that isn’t a web page—such as a Word document, Excel file, or PDF—you should include this information in the link text.^[2] This is important because it informs the user what will happen when they click on the link, thus preventing confusion. In addition, a user may decide not to click on a link if they know it’s a certain file type. This typically happens when a user doesn’t have the software needed to open the file or when they know the file type is inaccessible to them.

New tabs/windows

The default setting for links in LibreTexts is that they not open in a new window or tab. This is the preferred behaviour, since a new window, opening unexpectedly, can be disorienting for people. This is especially true for individuals who have difficulty perceiving visual content.^[3]

However, if a link must open in a new window or tab, the best practice is to include a textual reference.^[4]

LibreTexts allows you to edit whether or not a link opens in a new tab. Here is how:

Figure \(\PageIndex{1}\): Copy and Paste Caption here. (Copyright; author via source)

Links in reference lists

Citation styles often require a URL to be provided for all web-based content. For example, in APA style, the Accessibility Toolkit would be referenced as follows:

Coolidge, A., Doner, S., Robertson, T., & Gray, J. (2018). Accessibility Toolkit (2nd ed.). BCcampus. https://opentextbc.ca/accessibilitytoolkit/

The URL is provided to make it easy for people to navigate to the original source. However, it can be frustrating when screen readers read out the full URL for every source. As such, how can we make this link accessible to people using screen readers while still adhering to citation guidelines?

Option 1: WAI-ARIA labels

One solution is WAI-ARIA.^[5] WAI-ARIA allows you to add attributes to HTML to provide instructions that are recognized by assistive technologies. As such, we can hyperlink the URL and use an ARIA label to specify what the screen reader should read aloud. This way, the URL will still appear visually and can be clicked to navigate to the source, but when a screen reader encounters it, it will read out the ARIA label rather than the URL.

Here is what the citation would look like:

Coolidge, A., Doner, S., Robertson, T., & Gray, J. (2018). Accessibility Toolkit (2nd ed.). BCcampus. https://opentextbc.ca/accessibilitytoolkit/

Here is what the HTML would look like.

<p class="hanging-indent">Coolidge, A., Doner, S., Robertson, T., & Gray, J. (2018). <em>Accessibility Toolkit</em> (2nd ed). BCcampus. <a aria-label="Accessibility Toolkit" href="https://opentextbc.ca/accessibilitytoolkit/>https://opentextbc.ca/accessibility toolkit/</a></p>

Option 2: Link the citation title

If editing HTML is out of your comfort zone, another option is to use the title in the citation as the link text and leave the URL unlinked.

Here is an example:

Coolidge, A., Doner, S., Robertson, T., & Gray, J. (2018). Accessibility Toolkit (2nd ed.). BCcampus. https://opentextbc.ca/accessibilitytoolkit/

With this method, screen readers would still read out the URL if references were being read through from beginning to end. However, if a person using a screen reader wanted to navigate through the page by links, they would hear the title rather than the URL.

Provide web addresses in print copies

One thing to keep in mind is that most open textbooks have a print-on-demand option. For that reason, it is a good idea to provide the web address for external links so people using a print copy of the book can find the online content. You can do this by including the web address in-text (Example 1), providing the web address in a footnote (Example 2), or by providing a list of web addresses on a single page in the back matter of the book organized by chapter (Example 3).

Example 1: Information on BCcampus Open Education (https://open.bccampus.ca) is available online.

Example 2: Information on BCcampus Open Education^[6] is available online.

Example 3: See the List of Links by Chapter for Print Users in the back matter of this toolkit.

Media Attributions

• Trish: “WFE002: Emily” by Rosenfeld Media. © Creative Commons Attribution 2.0 Generic Licence.

---

1. "Ensure link text is meaningful within context," Web Accessibility, accessed March 28, 2018, https://www.webaccessibility.com/bes...actice_id=1301. ↵
2. "Links to non-HTML resources," WebAIM, accessed March 28, 2018, https://webaim.org/techniques/hypert...links#non_html. ↵
3. "G200: Opening new windows and tabs from a link only when necessary," accessed March 28, 2018, W3C, http://www.w3.org/TR/2014/NOTE-WCAG2...-20140916/G200. ↵
4. Penn State, "Links on a Web Page," Accessibility, accessed March 28, 2018, http://accessibility.psu.edu/linkshtml. ↵
5. Thank you to Baldur Bjarnason for sharing this workaround on the Rebus Community help page. ↵
6. https://open.bccampus.ca ↵
7. Thank you to Christina Hendricks for sharing this workaround in her blog post: Some things I'm learning about accessibility and open textbooks. ↵