...
Eroare React · Formulare și câmpuri controlate

A form label must be associated with a control.

Pe scurt

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:

  • htmlFor pe label egal cu id-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ă

Greșit
JSX
<label>Email</label>
<input id="email" type="email" />
Corect
JSX
<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ă

Greșit
JSX
function Camp({ eticheta }) {
  return (
    <>
      <label>{eticheta}</label>
      <input />
    </>
  );
}
Corect
JSX
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

Greșit
JSX
<input type="checkbox" id="termeni" />
<span>Accept termenii</span>
Corect
JSX
<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ă tu

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.

Codul care dă eroarea
JSX
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>

Alte forme ale mesajului

  • A form label must be associated with a control. jsx-a11y/label-has-associated-control
  • Form label must have associated control jsx-a11y/label-has-for
  • Form 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/id sau prin încadrare.
  • În componente refolosibile, generează id-urile cu useId().
  • Folosește htmlFor, nu for, î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

← 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.