Notice: This is a work in progress. Please submit feedback or suggestions.

hyperlink element (html)

Screen reader support level: partial (146/150)

Voice Control support level: partial (44/45)

On this page

About this feature

If the a element has an href attribute, then it represents a hyperlink (a hypertext anchor) labeled by its contents.

Age of results

Results across all tests for this feature range from 5 months ago to 8 months ago. Detailed dates and version information can be found in associated tests.

Failing and partial results are between 8 months ago and 8 months ago.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
MUST convey an appropriate rolesupportedsupportedsupportedsupportedsupportedsupportedpartial (4/5)supportedsupportedsupported
MUST convey an appropriate namesupportedsupportedsupportedsupportedsupportedsupportedpartial (4/5)supportedsupportedsupported
MUST convey the boundaries of the elementsupportedsupportedsupportedpartial (4/5)supportedsupportedpartial (4/5)supportedsupportedsupported
SHOULD provide shortcuts to jump to this rolesupportedsupportedsupportedsupportedsupportedsupportedpartial (4/5)supportedsupportedsupported
MAY convey the visited statepartialpartialpartialnonesupportedsupportedsupportednonesupportedsupported

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
MUST convey an appropriate rolesupportedsupportednot applicablesupportedsupported
MUST convey an appropriate namesupportedsupportedsupportedsupportedpartial (4/5)

Expectation: convey an appropriate role

Rationale: A screen reader user needs to know how they can interact with the element. Voice control software might use the role to help users activate controls that do not have a visible name.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: MUST

Examples of assistive technologies support this expectation:

  • A screen reader might announce a link as something like "<name>, link"
  • Voice control software might let a user say something like "click link"

Expectation: convey an appropriate name

Rationale: A screen reader user needs to know what to enter.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: MUST

Examples of assistive technologies support this expectation:

  • A screen reader might announce a link as something like "<name>, link"
  • Voice control software might let a user say something like "click <name>"

Expectation: convey the boundaries of the element

Rationale: A user needs to know when they enter and exit an element

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples of assistive technologies support this expectation:

  • A screen reader might announce an inline link as something like "<name>, link"
  • A screen reader might announce when it enter and exits a links the spans multiple lines.
  • A screen reader might announce the link role for every line that the links spans

Expectation: provide shortcuts to jump to this role

Rationale: Screen reader users might want to quickly navigate to elements of this type.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: SHOULD
  • Voice Control: NA

Expectation: convey the visited state

Rationale: A user might want to know that they have already visted the link

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MAY
  • Voice Control: NA
Screen Reader support for 'MAY convey the visited state'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
HTML links example 4 - A visited linkpartialpartialpartialnonesupportedsupportedsupportednonesupportedsupported