...
Eroare HTML și CSS · Lighthouse: accesibilitate, SEO și performanță

Links rely on color to be distinguishable.

Pe scurt

Linkurile din text se deosebesc de restul paragrafului doar prin culoare (ai pus text-decoration: none), iar cine nu distinge bine culorile nu le vede. Lasă linkurile din paragrafe subliniate sau adaugă alt semn vizibil în afară de culoare, de exemplu text îngroșat sau o bordură jos.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Auditul (Accesibilitate, regula axe link-in-text-block) verifică linkurile aflate în interiorul unui bloc de text. Un link fără subliniere, diferit doar prin culoare de textul din jur, este greu de văzut pentru persoanele cu deficiențe de vedere a culorilor și pe ecrane cu contrast slab.

Regula acceptă culoarea ca singură diferență doar dacă linkul are un contrast de cel puțin 3:1 față de textul din jur și primește un semn vizibil la hover și focus. Pentru un text gri închis și un link albastru, contrastul dintre ele este de obicei sub 3:1, deci auditul eșuează.

Cel mai simplu: lasă sublinierea pentru linkurile din paragrafe. Meniurile și butoanele nu intră în regulă, pentru că acolo e clar că sunt linkuri. Poți ajusta aspectul sublinierii cu text-underline-offset și text-decoration-thickness.

De ce apare: cauzele frecvente

1Subliniere scoasă de pe toate linkurile

Greșit
HTML
a {
  color: #2563eb;
  text-decoration: none;
}
Corect
HTML
a {
  color: #2563eb;
}

.meniu a {
  text-decoration: none;
}

Linkurile din text rămân subliniate, iar doar meniul, unde rolul e evident, le are fără subliniere.

2Subliniere doar la hover

Greșit
HTML
.articol a { text-decoration: none; }
.articol a:hover { text-decoration: underline; }
Corect
HTML
.articol a {
  text-decoration: underline;
  text-underline-offset: 3px;
}

Pe telefon nu există hover, iar la citire linkul trebuie recunoscut fără mouse. Sublinierea discretă rezolvă și designul, și accesibilitatea.

3Alt semn decât culoarea

Greșit
HTML
.articol a {
  color: #2563eb;
  text-decoration: none;
}
Corect
HTML
.articol a {
  color: #2563eb;
  text-decoration: none;
  font-weight: 700;
  border-bottom: 2px solid currentColor;
}

Bordura de jos și grosimea fac linkul vizibil și fără să distingi culoarea.

Repară tu

Repară eroarea, direct în pagină

Lighthouse → Accessibility raportează „Links rely on color to be distinguishable.” pentru linkurile din articol, care au doar altă culoare decât textul. Fă linkurile din .articol subliniate, păstrând culoarea albastră.

Codul care dă eroarea
HTML
<!DOCTYPE html>
<html lang="ro">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Ghid</title>
    <style>
      body {
        font-family: system-ui, Arial, sans-serif;
        padding: 20px;
        color: #1f2937;
      }

      .articol a {
        color: #2563eb;
        text-decoration: none;
      }
    </style>
  </head>
  <body>
    <article class="articol">
      <h1>Cum alegi un ceai verde</h1>
      <p>Pentru început, încearcă un <a href="/sencha">ceai Sencha</a>, apoi compară-l cu un <a href="/matcha">Matcha de calitate</a>.</p>
    </article>
  </body>
</html>
Indiciu

Uită-te la text-decoration.

Alte forme ale mesajului

  • Links must be distinguishable without relying on color

Cum o eviți pe viitor

  • Nu scoate sublinierea global (a { text-decoration: none; }); scoate-o doar în meniuri și butoane.
  • Folosește text-underline-offset pentru o subliniere mai elegantă.
  • Pune și stiluri :focus-visible pentru linkuri.
  • Verifică pagina în DevTools → Rendering → Emulate vision deficiencies.

Întrebări frecvente

Dar contrastul linkului cu fundalul e bun. De ce pică?

Pentru că auditul compară linkul cu textul din jur, nu cu fundalul. Albastrul și negrul pot avea fiecare contrast bun cu albul, dar între ele foarte mic.

Linkurile din meniu trebuie și ele subliniate?

Nu. Regula se aplică doar linkurilor din blocuri de text (paragrafe, liste cu text). Într-un meniu, poziția și aspectul arată deja că sunt linkuri.

Erori înrudite

← Toate erorile HTML și CSS

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață HTML și CSS de la zero, cu exerciții la fiecare lecție

Curs HTML & CSS: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.