...
Eroare React · Atribute, stiluri și evenimente

Warning: Invalid ARIA attribute `ariaLabel`. Did you mean `aria-label`?

Pe scurt

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

Greșit
JSX
<button ariaLabel="Închide">×</button>
Corect
JSX
<button aria-label="Închide">×</button>

Atributele ARIA păstrează în JSX forma din HTML, cu cratimă.

2Alte atribute ARIA

Greșit
JSX
<div ariaHidden="true" ariaExpanded={deschis}>...</div>
Corect
JSX
<div aria-hidden="true" aria-expanded={deschis}>...</div>

Aceeași regulă pentru toate: aria-hidden, aria-expanded, aria-describedby, aria-live.

Repară tu

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.

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

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-props
  • Warning: Unknown ARIA attribute `aria-labeledby`. Did you mean `aria-labelledby`?

Cum o eviți pe viitor

  • Reține excepțiile: aria-* și data-* se scriu cu cratimă, tot restul în camelCase.
  • Butoanele care au doar o iconiță au nevoie de aria-label.
  • Pluginul ESLint jsx-a11y semnalează 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

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