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.
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
hrefvalid 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
<a onClick={() => setDeschis(true)}>Vezi detalii</a><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
<a href="#" onClick={(e) => { e.preventDefault(); adaugaInCos(); }}>Adaugă</a><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
<a onClick={() => navigate("/cos")}>Coșul meu</a><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ă 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>.
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">.
Reparația
import { useState } from "react";
export default function App() {
const [deschis, setDeschis] = useState(false);
return (
<div>
<h3>Cană albastră</h3>
<button id="detalii" type="button" onClick={() => setDeschis(true)}>Vezi detalii</button>
{deschis && <p id="descriere">Cană din ceramică, 300 ml</p>}
</div>
);
}De ce merge
Un <a> fără href nu e un link pentru browser: nu primește focus cu Tab și nu se activează cu Enter, așa că acțiunea era accesibilă doar cu mouse-ul. Regula jsx-a11y/anchor-is-valid semnalează exact acest caz.
<button type="button"> este elementul potrivit pentru o acțiune: e accesibil de la tastatură, e anunțat ca buton, iar type="button" îl împiedică să trimită un eventual formular. Click-ul afișează descrierea la fel ca înainte.
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="#"saujavascript:pentru acțiuni. - Într-o aplicație cu React Router, folosește
LinksauNavLinkpentru 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
img elements must have an alt prop, either with meaningful text, or an empty string for decorative images. Regula ESLint jsx-a11y/alt-text cere atributul alt pe fiecare <img>. Cititoarele de ecran citesc alt-ul în locul imaginii, iar el apare și când imaginea nu se încarcă. Scrie un text care descrie imaginea (alt="Cană albastră de 300 ml") sau alt="" pentru imaginile pur decorative. Visible, non-interactive elements with click handlers must have at least one keyboard listener. Regula ESLint jsx-a11y/click-events-have-key-events vede onClick pe un div, span sau li. Un astfel de element nu primește focus și nu reacționează la tastatură, deci acțiunea e doar pentru mouse. Folosește un <button> (sau un <a href> pentru navigare); doar dacă nu se poate, adaugă role, tabIndex={0} și onKeyDown. Warning: A future version of React will block javascript: URLs as a security precaution. Use event handlers instead if you can. If you need to generate unsafe HTML try using dangerouslySetInnerHTML instead. React was passed "javascript:void(0)". Ai pus un href="javascript:..." (de obicei javascript:void(0)) pe un link. React avertizează că va bloca astfel de adrese din motive de securitate. Pentru o acțiune folosește un <button> cu onClick; pentru un link real pune adresa reală în href. Î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.
