Skip to content
aidsgnaidsgnaidsgn

Link

aidsgn-link renders navigation as a native anchor in light DOM. Its content supplies the accessible name, while the platform retains link semantics, keyboard activation, downloads, and context-menu behavior.

Browse components

<aidsgn-link href="/components/"><a class="aidsgn-link" href="/components/">Browse components</a></aidsgn-link>

Use Link for destinations and aidsgn-button for immediate actions. Write descriptive visible text rather than “click here.” target, rel, download, hreflang, and type pass through to the native anchor. Use current="page" or another supported current value for the active item in a navigation set.

Removing href creates a non-navigating anchor, not a disabled link. Avoid that state in application interfaces. The component deliberately leaves router interception and external-link indicators to the parent application.

Usage guidelines

Section titled “Usage guidelines”
A Browse components Link is presented as navigation to the component catalogue.A Browse components Link is presented as navigation to the component catalogue.
Do

Use Link for navigation

Choose Link when activation moves to another location or opens a resource.

Three links use the specific labels Installation guide, Accessibility requirements, and Release process.Three links use the specific labels Installation guide, Accessibility requirements, and Release process.
Do

Name the destination

Write link text that identifies where it leads even when read outside the surrounding sentence.

A Delete project Link is incorrectly used for an in-page destructive action.A Delete project Link is incorrectly used for an in-page destructive action.
Don’t

Avoid Link for actions

Use Button for an in-page operation that does not change the current location.

Three repeated Click here links appear beside unrelated destinations, followed by a disabled-looking link.Three repeated Click here links appear beside unrelated destinations, followed by a disabled-looking link.
Don’t

Avoid vague or disabled links

Replace repeated labels such as “click here” with meaningful destinations, and do not imply unsupported disabled behavior.