WAI-ARIA: Role=Link • Digital A11y

An interactive reference to an internal or external resource that, when activated, causes the user agent to navigate to that resource.

Description

An interactive reference to an internal or external resource that, when activated, causes the user agent to navigate to that resource. See related button.

If this is a native link in the host language (such as an HTML anchor with an href value), activating the link causes the user agent to navigate to that resource. If this is a simulated link, the web application author is responsible for managing navigation.

Note: If pressing the link triggers an action but does not change browser focus or page location, authors are advised to consider using the button role instead of the link role.

Example

HTML Example

<div tabindex="0" role="link" onClick="window.location='http://www.google.com'">This is an ARIA link</div>

Characteristics

Superclass Role

command

Related Concepts

HTML a
HTML link

Supported States and Properties

aria-expanded

Inherited States and Properties

aria-atomic
aria-busy (state)
aria-controls
aria-current (state)
aria-describedby
aria-details
aria-disabled (state)
aria-dropeffect
aria-errormessage
aria-flowto
aria-grabbed (state)
aria-haspopup
aria-hidden (state)
aria-invalid (state)
aria-keyshortcuts
aria-label
aria-labelledby
aria-live
aria-owns
aria-relevant
aria-roledescription

Name From

contents
author

Accessible Name Required

True

Semantic HTML

Use the HTML <a> tag.

<a href="http://www.html5accessibility.com">HTML5 Accessibility</a>

Reference

W3C (opens new window)