Skip to content

Ensure links are distinguished from surrounding text in a way that does not rely on color. #9169

@msftedad

Description

@msftedad

Have you read the Contributing Guidelines on issues?

Prerequisites

  • I'm using the latest version of Docusaurus.
  • I have tried the npm run clear or yarn clear command.
  • I have tried rm -rf node_modules yarn.lock package-lock.json and re-installing packages.
  • I have tried creating a repro with https://new.docusaurus.io.
  • I have read the console error message carefully (if applicable).

Description

Ensure links are distinguished from surrounding text in a way that does not rely on color.
User is not able to differentiate between the normal text and links.
Ensures the contrast between foreground and background colors meets WCAG 2 AA contrast ratio thresholds.
Users with low vision will face difficulties if link has no styling (such as underline) to distinguish it from the surrounding text.

Reproducible demo

No response

Steps to reproduce

  1. Open https://docusaurus.io/docs URL.
  2. Navigate to link best docusaurus link present under Introduction and testimonials using tab key.
  3. Verify whether links are distinguished from surrounding text in a way that does not rely on color or not.

Expected behavior

Ensure that links are distinguished from surrounding text in a way that does not rely on color.
Ensures the contrast between foreground and background colors meets WCAG 2 AA contrast ratio thresholds.

Actual behavior

Links are distinguished from surrounding text in a way that does not rely on color. Color is the only way through which a link is identified. Underline or Chevron is not present for the links.
MicrosoftTeams-image (35)
MicrosoftTeams-image (34)

Your environment

Public source code:
Public site URL: https://www.fast.design/
Docusaurus version used:
OS: Windows 11, Version: 22H2, Build: 22621.1992  
Microsoft Edge Version: 114.0.1823.86 (Official build) (64-bit)
Tool Used: Accessibility Insights for Web.

Self-service

  • I'd be willing to fix this bug myself.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugAn error in the Docusaurus core causing instability or issues with its executiondomain: a11yRelated to accessibility concerns of the default theme

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions