Warning: Invalid ARIA attribute `ariaLabel`. Did you mean `aria-label`?
Atributele ARIA se scriu în JSX exact ca în HTML, cu cratimă și litere mici: aria-label, aria-hidden, aria-expanded. Spre deosebire de className sau onClick, ele nu se transformă în camelCase. Scrie aria-label="..." în loc de ariaLabel.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În JSX, majoritatea atributelor HTML se scriu în camelCase: className, htmlFor, tabIndex, onClick. Există însă două excepții: atributele **aria-* (accesibilitate) și data-*** (date proprii) rămân cu cratimă, exact ca în HTML.
Dacă scrii ariaLabel, React nu îl recunoaște ca atribut ARIA, nu îl pune corect în pagină și îți spune care e forma bună: aria-label. Cititoarele de ecran nu vor mai găsi eticheta, iar testele care caută după nume accesibil (de exemplu getByRole("button", { name: "Închide" })) eșuează.
Avertismentul apare des la butoanele cu doar o iconiță (×, coș, meniu), unde aria-label este singurul text care descrie butonul.
De ce apare: cauzele frecvente
1aria-label scris în camelCase
<button ariaLabel="Închide">×</button><button aria-label="Închide">×</button>Atributele ARIA păstrează în JSX forma din HTML, cu cratimă.
2Alte atribute ARIA
<div ariaHidden="true" ariaExpanded={deschis}>...</div><div aria-hidden="true" aria-expanded={deschis}>...</div>Aceeași regulă pentru toate: aria-hidden, aria-expanded, aria-describedby, aria-live.
Repară eroarea, direct în pagină
Butonul #inchide din modalul de mai jos are doar simbolul „×”, iar eticheta lui pentru cititoarele de ecran nu ajunge în pagină: consola arată „Invalid ARIA attribute ariaLabel”. Repar-o ca butonul să aibă atributul aria-label „Închide fereastra”, iar click-ul pe el să ascundă #modal.
import { useState } from "react";
export default function App() {
const [deschis, setDeschis] = useState(true);
return (
<div>
{deschis && (
<div id="modal">
<p>Ai un cupon de 10%!</p>
<button id="inchide" ariaLabel="Închide fereastra" onClick={() => setDeschis(false)}>×</button>
</div>
)}
</div>
);
}Indiciu
Atributele ARIA se scriu cu cratimă, ca în HTML.
Reparația
import { useState } from "react";
export default function App() {
const [deschis, setDeschis] = useState(true);
return (
<div>
{deschis && (
<div id="modal">
<p>Ai un cupon de 10%!</p>
<button id="inchide" aria-label="Închide fereastra" onClick={() => setDeschis(false)}>×</button>
</div>
)}
</div>
);
}De ce merge
React transformă în atribute HTML doar numele pe care le cunoaște. Pentru accesibilitate, el recunoaște atributele cu cratimă (aria-label, aria-hidden), nu variantele camelCase, așa că ariaLabel nu ajungea corect în pagină.
Cu aria-label="Închide fereastra", butonul are un nume accesibil: cititorul de ecran îl anunță ca „Închide fereastra, buton” în loc de un simplu „×”. Comportamentul la click rămâne același.
Alte forme ale mesajului
Warning: Invalid ARIA attribute `ariaHidden`. Did you mean `aria-hidden`?Warning: Invalid aria prop `aria-lable` on <button> tag. For details, see https://reactjs.org/link/invalid-aria-propsWarning: Unknown ARIA attribute `aria-labeledby`. Did you mean `aria-labelledby`?
Cum o eviți pe viitor
- Reține excepțiile:
aria-*șidata-*se scriu cu cratimă, tot restul în camelCase. - Butoanele care au doar o iconiță au nevoie de
aria-label. - Pluginul ESLint
jsx-a11ysemnalează atributele ARIA greșite sau scrise incorect direct în editor, înainte să rulezi aplicația.
Întrebări frecvente
De ce className e camelCase, dar aria-label nu?
Pentru că React folosește numele proprietăților DOM din JavaScript (element.className). Atributele ARIA și data-* nu au astfel de nume în camelCase pe care React să le folosească, așa că rămân ca în HTML.
Pot scrie aria-expanded={true}?
Da: React transformă booleanul în textul „true” sau „false”, care este exact ce așteaptă ARIA.
Erori înrudite
Warning: Invalid DOM property `class`. Did you mean `className`? În JSX atributul HTML class se scrie className, pentru că class este cuvânt rezervat în JavaScript. Înlocuiește class= cu className= (în tot fișierul). Warning: React does not recognize the `esteActiv` prop on a DOM element. If you intentionally want it to appear in the DOM as a custom attribute, spell it as lowercase `esteactiv` instead. If you accidentally passed it from a parent component, remove it from the DOM element. Un prop al componentei tale (de exemplu esteActiv) a ajuns pe un element HTML, de obicei prin {...rest}. Scoate-l din obiectul transmis mai departe și folosește-l doar în componentă (de exemplu pentru className). Warning: Unknown event handler property `onHover`. It will be ignored. Ai pus pe un element HTML un eveniment care nu există în React, de exemplu onHover, onEnter sau onClickOutside, iar React îl ignoră. Folosește evenimentul real: onMouseEnter / onMouseLeave pentru hover, onKeyDown pentru taste, onChange pentru câmpuri. Î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.
