...
Eroare React · Atribute, stiluri și evenimente

The href attribute is required for an anchor to be keyboard accessible. Provide a valid, navigable address as the href value. If you cannot provide an href, but still need the element to resemble a link, use a button and change it with appropriate styles.

Pe scurt

Regula ESLint jsx-a11y/anchor-is-valid vede un <a> fără href (sau cu href="#") folosit ca buton, cu onClick. Un astfel de link nu poate fi folosit de la tastatură și nu e anunțat corect. Dacă face o acțiune, folosește <button type="button">; dacă duce la o pagină, dă-i href sau folosește <Link to> din React Router.

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

Ce înseamnă

Un <a> fără href nu e un link adevărat pentru browser: nu primește focus cu Tab, nu se activează cu Enter și nu e anunțat ca link de cititoarele de ecran. href="#" sau href="javascript:void(0)" sunt variante „cârpite”, care adaugă salturi la începutul paginii și intrări în istoric.

Regula jsx-a11y/anchor-is-valid (din eslint-plugin-jsx-a11y, prezentă în Create React App și în multe configurații) face diferența între:

  • link: duce undeva (altă pagină, altă secțiune) – are nevoie de href valid sau de <Link to="..."> din React Router;
  • buton: face o acțiune în pagină (deschide un meniu, adaugă în coș, șterge) – trebuie să fie <button type="button">.

Mesajul complet se termină cu un link spre documentația regulii. Versiunea scurtă, „Anchor used as a button”, apare când <a> are onClick și nu are href valid.

De ce apare: cauzele frecvente

1Link folosit pentru o acțiune

Greșit
JSX
<a onClick={() => setDeschis(true)}>Vezi detalii</a>
Corect
JSX
<button type="button" onClick={() => setDeschis(true)}>Vezi detalii</button>

Un buton primește focus, se activează cu Enter și Space și e anunțat ca buton.

2href="#" ca să pară link

Greșit
JSX
<a href="#" onClick={(e) => { e.preventDefault(); adaugaInCos(); }}>Adaugă</a>
Corect
JSX
<button type="button" className="link" onClick={adaugaInCos}>Adaugă</button>

Stilul de link se pune cu CSS pe buton; nu mai ai nevoie de preventDefault.

3Navigare într-o aplicație cu React Router

Greșit
JSX
<a onClick={() => navigate("/cos")}>Coșul meu</a>
Corect
JSX
<Link to="/cos">Coșul meu</Link>

Link randează un <a href="/cos"> adevărat, care merge și cu tastatura, și cu „deschide în tab nou”.

Repară tu

Repară eroarea, direct în pagină

„Vezi detalii” de mai jos este un <a> fără href, cu onClick, iar ESLint spune „The href attribute is required for an anchor to be keyboard accessible”. Fă din el un buton #detalii (type="button"), ca după click să apară paragraful #descriere cu „Cană din ceramică, 300 ml”, iar în pagină să nu mai rămână niciun <a>.

Codul care dă eroarea
JSX
import { useState } from "react";

export default function App() {
  const [deschis, setDeschis] = useState(false);

  return (
    <div>
      <h3>Cană albastră</h3>
      <a id="detalii" onClick={() => setDeschis(true)}>Vezi detalii</a>
      {deschis && <p id="descriere">Cană din ceramică, 300 ml</p>}
    </div>
  );
}
Indiciu

Înlocuiește <a> cu <button type="button">.

Alte forme ale mesajului

  • Anchor used as a button. Anchors are primarily expected to navigate. Use the button element instead.
  • The href attribute requires a valid value to be accessible. Provide a valid, navigable address as the href value.
  • The href attribute is required for an anchor to be keyboard accessible. Provide a valid, navigable address as the href value. jsx-a11y/anchor-is-valid

Cum o eviți pe viitor

  • Întreabă-te: „duce undeva?” atunci link, „face ceva?” atunci buton.
  • Nu folosi href="#" sau javascript: pentru acțiuni.
  • Într-o aplicație cu React Router, folosește Link sau NavLink pentru navigare.
  • Dacă butonul trebuie să arate ca un link, schimbă-i aspectul din CSS (fără chenar, subliniat).

Întrebări frecvente

De ce nu pot lăsa <a onClick>, dacă merge cu mouse-ul?

Pentru că nu merge cu tastatura: elementul nu primește focus cu Tab și nu reacționează la Enter. Oamenii care navighează fără mouse nu pot folosi acel control.

Butonul meu dintr-un formular trimite formularul. De ce?

Un <button> dintr-un formular este implicit type="submit". Pentru acțiuni care nu trimit formularul, scrie type="button".

Erori înrudite

← Toate erorile React

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ță React de la zero, cu exerciții la fiecare lecție

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