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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un <label> are rost doar dacă e legat de un câmp. Legătura face două lucruri: un click pe text pune focus în câmp (sau bifează checkbox-ul), iar cititoarele de ecran anunță numele câmpului când utilizatorul ajunge la el. Fără legătură, eticheta e doar un text lângă input.
Regula jsx-a11y/label-has-associated-control (din eslint-plugin-jsx-a11y) acceptă două forme:
htmlForpe label egal cuid-ul câmpului:<label htmlFor="email">+<input id="email">;- câmpul pus în interiorul labelului:
<label>Email <input /></label>.
În JSX, atributul se scrie htmlFor, nu for (cuvânt rezervat în JavaScript). Un for scris din obișnuință dă și avertismentul „Invalid DOM property for”. Când refolosești o componentă de formular de mai multe ori pe pagină, id-urile trebuie să fie unice: generează-le cu useId().
De ce apare: cauzele frecvente
1Label lângă input, fără legătură
<label>Email</label>
<input id="email" type="email" /><label htmlFor="email">Email</label>
<input id="email" type="email" />htmlFor are aceeași valoare ca id-ul inputului, deci browserul le leagă.
2Componentă de câmp refolosită
function Camp({ eticheta }) {
return (
<>
<label>{eticheta}</label>
<input />
</>
);
}function Camp({ eticheta }) {
const id = useId();
return (
<>
<label htmlFor={id}>{eticheta}</label>
<input id={id} />
</>
);
}useId dă un id unic pentru fiecare instanță, deci fiecare label se leagă de câmpul lui.
3Checkbox cu text separat
<input type="checkbox" id="termeni" />
<span>Accept termenii</span><label>
<input type="checkbox" id="termeni" /> Accept termenii
</label>Cu checkbox-ul în label, un click pe text bifează căsuța, iar textul devine numele ei accesibil.
Repară eroarea, direct în pagină
Formularul de mai jos are etichete care nu sunt legate de câmpuri, iar ESLint spune „A form label must be associated with a control”. Leagă fiecare label de câmpul lui cu htmlFor, ca labelul „Email” să indice #email, iar labelul „Parolă” să indice #parola.
export default function App() {
return (
<form>
<label>Email</label>
<input id="email" type="email" />
<label>Parolă</label>
<input id="parola" type="password" />
<button type="submit">Intră în cont</button>
</form>
);
}Indiciu
<label htmlFor="email">Email</label>
Reparația
export default function App() {
return (
<form>
<label htmlFor="email">Email</label>
<input id="email" type="email" />
<label htmlFor="parola">Parolă</label>
<input id="parola" type="password" />
<button type="submit">Intră în cont</button>
</form>
);
}De ce merge
Labelurile erau doar texte așezate lângă câmpuri: un click pe ele nu punea focus în input, iar cititoarele de ecran nu știau cum se numește fiecare câmp.
htmlFor are aceeași valoare ca id-ul câmpului, iar React îl scrie în HTML ca atributul for. Browserul leagă astfel fiecare etichetă de câmpul ei: click pe „Email” pune focus în #email, iar câmpul este anunțat cu numele etichetei.
Alte forme ale mesajului
A form label must be associated with a control. jsx-a11y/label-has-associated-controlForm label must have associated control jsx-a11y/label-has-forForm label must have ALL of the following types of associated control: nesting, id
Cum o eviți pe viitor
- Scrie fiecare câmp cu label-ul lui, legat prin
htmlFor/idsau prin încadrare. - În componente refolosibile, generează id-urile cu
useId(). - Folosește
htmlFor, nufor, în JSX. - Verifică din pagină: click pe textul etichetei trebuie să pună focus în câmp.
Întrebări frecvente
Am pus htmlFor și regula tot se plânge. De ce?
Unele configurații cer ambele forme în același timp (opțiunea assert: "both"): și htmlFor, și câmpul în interior. Verifică setările regulii în configurația ESLint a proiectului.
Pot folosi doar placeholder în loc de label?
Nu e recomandat. Placeholder-ul dispare când începi să scrii și nu e întotdeauna anunțat corect. Dacă designul nu are etichete vizibile, folosește aria-label pe câmp.
Erori înrudite
Warning: Invalid DOM property `for`. Did you mean `htmlFor`? Pe <label> atributul HTML for se scrie în JSX htmlFor, pentru că for este cuvânt rezervat în JavaScript. Scrie <label htmlFor="email"> și dă inputului id="email". 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. 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. Î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.
