An `<sp-link>` allows users to navigate to a different location. They can be presented in-line inside a paragraph or as a standalone text.
npm install @spectrum-web-components/linkAn
``bash`
yarn add @spectrum-web-components/link
Import the side effectful registration of via:
`js`
import '@spectrum-web-components/link/sp-link.js';
When looking to leverage the Link base class as a type and/or for extension purposes, do so via:
`js`
import { Link } from '@spectrum-web-components/link';
Primary links are blue and should be used to call attention to the link or for when the blue color won’t feel too overwhelming in the experience.
`html`
This is a
The secondary variant is the same color as the paragraph text inline of which it appears. Its subdued appearance is optimal for when the primary variant is too overwhelming, such as in blocks of text with several references linked throughout.
`html`
This is a
All links can have a quiet style, which means they don’t have an underline. This style should only be used when the placement and context of the link is explicit enough that a visible underline isn’t necessary.
Quiet links are less accessible because users may not recognise them as links. Use only when context and placement make their purpose unmistakable, and avoid using quiet links for critical navigation.
This is a This is a
`html
>
This is a
over a background.
#### Static colored links
When a link needs to be placed on top of a colored background or a visual it may be appropriate to ship it with a static color, regardless of the theme settings with which it is delivered. Leverage the
attribute with its white or black values to ensure the delivery is the same in all contexts.
White
`html
>
This
link
is over a background.
Black
html
>
This
link
is over a background.
$3
#### Disabled links
Disabled links are blue, unfocusable, unclickable and should not propagate any events.
html
This is a disabled link .
`$3
The download attribute on an
tag prompts a user to download a link as opposed to navigating to it. This attribute has been carried forward to to function the same.While it functions this way without assigning a value, actually assigning the value allows custom naming of the download link in accordance
with standard
rules defined by the browser.
`html
This is a download link .
`$3
#### Best Practices
- Use links in body copy and not in titles. For a larger call to action, consider using a button instead.
- Identify the target of each link directly in the link text to communicate context and set clear expectations about where the link will go.
- Be mindful of link placement and language, and create experiences that are inclusive of users navigating with screen readers, who may navigate links without their surrounding language.
- It’s more accessible and inclusive to write link text as unique descriptions of the navigational target or function.
- Implement skip links to improve navigation for keyboard and screen reader users when necessary, especially when the page has many sections and lengthy scroll.
- For links that open in a new tab, add
, rel="noopener noreferrer" and a UI icon to the link.
- Add aria-label or aria-labelledby to links for screen readers who need additional context. Links can be more concise to lessen visible noise, but adding these attributes can help make the purpose of the link more clear.
- Ensure strong color contrast between the link and its background. For users with low vision,consider using 7:1 ratio for critical links and 21:1 ratio for severe vision impairments.#### Keyboard Interaction
-
Tab: Move focus to the next focusable element.
- Enter: Activate the link.
- Shift + F10` (Optional): Open the context menu for the link.