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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Elementele ca div, span, li sau img sunt neinteractive: browserul nu le dă focus cu Tab, nu le activează cu Enter sau Space, iar cititoarele de ecran nu le anunță ca butoane. Când le pui onClick, acțiunea poate fi folosită doar cu mouse-ul sau prin atingere.
Regula jsx-a11y/click-events-have-key-events (din eslint-plugin-jsx-a11y) cere ca orice astfel de element cu onClick să aibă și un ascultător de tastatură (onKeyDown, onKeyUp sau onKeyPress). De obicei vine împreună cu jsx-a11y/no-static-element-interactions, care spune să eviți cu totul elementele neinteractive cu evenimente.
Soluția simplă și corectă este aproape mereu elementul nativ: <button type="button"> pentru acțiuni, <a href> sau <Link> pentru navigare. Ele au deja focus, tastatură și rolul potrivit, iar aspectul se schimbă din CSS. Varianta cu role="button", tabIndex={0} și onKeyDown care tratează Enter și Space e corectă, dar e mai mult cod și mai ușor de greșit.
De ce apare: cauzele frecvente
1Card de produs cu onClick pe div
<div className="card" onClick={() => alege(p.id)}>
{p.nume}
</div><button type="button" className="card" onClick={() => alege(p.id)}>
{p.nume}
</button>Butonul primește focus și se activează cu Enter și Space, fără cod în plus.
2Element din listă folosit ca opțiune
<li onClick={() => setTab("detalii")}>Detalii</li><li>
<button type="button" onClick={() => setTab("detalii")}>Detalii</button>
</li>li rămâne element de listă, iar acțiunea stă pe un buton accesibil.
3Element care nu poate fi buton
<span onClick={inchide}>×</span><span
role="button"
tabIndex={0}
aria-label="Închide"
onClick={inchide}
onKeyDown={(e) => { if (e.key === "Enter" || e.key === " ") inchide(); }}
>
×
</span>Rolul, tabIndex și onKeyDown refac manual ce face un buton nativ; folosește această variantă doar când nu ai alternativă.
Repară eroarea, direct în pagină
Cardurile de mai jos sunt div-uri cu onClick, iar ESLint spune „Visible, non-interactive elements with click handlers must have at least one keyboard listener”. Fă din fiecare card un <button type="button"> cu clasa card, ca după click pe al doilea card #ales să afișeze „Ai ales: Ceainic”.
import { useState } from "react";
const produse = [
{ id: 1, nume: "Cană" },
{ id: 2, nume: "Ceainic" },
];
export default function App() {
const [ales, setAles] = useState("");
return (
<div>
{produse.map((p) => (
<div key={p.id} className="card" onClick={() => setAles(p.nume)}>
{p.nume}
</div>
))}
<p id="ales">Ai ales: {ales}</p>
</div>
);
}Indiciu
Înlocuiește <div className="card"> cu <button type="button" className="card">.
Reparația
import { useState } from "react";
const produse = [
{ id: 1, nume: "Cană" },
{ id: 2, nume: "Ceainic" },
];
export default function App() {
const [ales, setAles] = useState("");
return (
<div>
{produse.map((p) => (
<button key={p.id} type="button" className="card" onClick={() => setAles(p.nume)}>
{p.nume}
</button>
))}
<p id="ales">Ai ales: {ales}</p>
</div>
);
}De ce merge
Un div nu primește focus și nu reacționează la Enter sau Space, așa că alegerea unui produs era posibilă doar cu mouse-ul. Regula jsx-a11y/click-events-have-key-events semnalează orice element neinteractiv cu onClick.
<button type="button"> are deja tot ce lipsea: focus cu Tab, activare de la tastatură și rolul de buton pentru cititoarele de ecran. Click-ul funcționează la fel ca înainte.
Alte forme ale mesajului
Visible, non-interactive elements with click handlers must have at least one keyboard listener. jsx-a11y/click-events-have-key-eventsAvoid non-native interactive elements. If using native HTML is not possible, add an appropriate role and support for tabbing, mouse, key, and focus interactions.Static HTML elements with event handlers require a role.Elements with the 'button' interactive role must be focusable.
Cum o eviți pe viitor
- Pune
onClickdoar pebutton,a,input,selectsau pe componente care randează aceste elemente. - Resetează aspectul butoanelor din CSS când vrei să arate ca un card sau ca un link.
- Testează pagina doar cu tastatura: Tab, Enter, Space trebuie să ajungă la toate acțiunile.
- Lasă activ
eslint-plugin-jsx-a11y; prinde multe probleme de accesibilitate devreme.
Întrebări frecvente
E suficient să adaug onKeyDown pe div?
Regula va fi mulțumită, dar elementul tot nu primește focus fără tabIndex={0} și nu e anunțat ca buton fără role="button". Un <button> rezolvă toate trei dintr-o dată.
Butonul arată altfel decât designul. Ce fac?
Resetează stilurile implicite din CSS (border: none; background: none; padding: 0; font: inherit;) și aplică stilul cardului. Comportamentul accesibil rămâne.
Erori înrudite
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. A form label must be associated with a control. Regula ESLint jsx-a11y/label-has-associated-control vede un <label> care nu e legat de niciun câmp. Leagă-l cu htmlFor (în JSX, nu for) egal cu id-ul inputului sau pune inputul în interiorul labelului. Așa, click pe text pune focus în câmp, iar cititoarele de ecran anunță eticheta. Warning: Invalid event handler property `onclick`. Did you mean `onClick`? Ai scris evenimentul cu litere mici, ca în HTML (onclick, onchange). În React evenimentele se scriu în camelCase și primesc o funcție: onClick={adauga}, onChange={...}. Î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.
