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

Warning: Unknown event handler property `onHover`. It will be ignored.

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

React recunoaște o listă fixă de evenimente (onClick, onChange, onSubmit, onMouseEnter, onKeyDown, onFocus și altele). Orice prop care începe cu on și nu e în listă este ignorat pe elementele HTML, iar React te avertizează că funcția ta nu va fi apelată niciodată.

Cele mai frecvente nume inventate:

  • onHover: în React (și în DOM) nu există; hover-ul înseamnă onMouseEnter + onMouseLeave;
  • onEnter / onEnterPress: se face cu onKeyDown și verificarea e.key === "Enter";
  • onDoubleClick e corect, dar onDblClick nu;
  • props-uri ale unei biblioteci (onClickOutside) puse direct pe un div.

Dacă handler-ul e destinat unei componente proprii, React nu avertizează: acolo poți folosi orice nume. Mesajul apare doar pe elementele HTML.

De ce apare: cauzele frecvente

1onHover în loc de onMouseEnter

Greșit
JSX
<div onHover={() => setArata(true)}>Detalii</div>
Corect
JSX
<div
  onMouseEnter={() => setArata(true)}
  onMouseLeave={() => setArata(false)}
>Detalii</div>

Hover-ul are două momente: intrarea și ieșirea mouse-ului, fiecare cu evenimentul ei.

2onEnter pentru tasta Enter

Greșit
JSX
<input onEnter={cauta} />
Corect
JSX
<input onKeyDown={(e) => { if (e.key === "Enter") cauta(); }} />

Tastele vin prin onKeyDown; tasta apăsată se citește din e.key.

3Prop de componentă pus pe un element HTML

Greșit
JSX
<div onClickOutside={inchide}>...</div>
Corect
JSX
<Dropdown onClickOutside={inchide}>...</Dropdown>

Numele inventate funcționează doar pentru componentele tale, care primesc prop-ul și îl apelează.

Repară tu

Repară eroarea, direct în pagină

Cardul de mai jos ar trebui să afișeze paragraful #detalii („Livrare gratuită”) cât timp mouse-ul e deasupra lui, dar consola arată „Unknown event handler property onHover” și nu se întâmplă nimic. Repar-o ca, atunci când mouse-ul intră pe #card, să apară #detalii.

Codul care dă eroarea
JSX
import { useState } from "react";

export default function App() {
  const [arata, setArata] = useState(false);

  return (
    <div id="card" onHover={() => setArata(true)}>
      <h3>Laptop</h3>
      {arata && <p id="detalii">Livrare gratuită</p>}
    </div>
  );
}
Indiciu

Intrarea mouse-ului pe un element se prinde cu onMouseEnter.

Alte forme ale mesajului

  • Warning: Unknown event handler property `onEnter`. It will be ignored.
  • Warning: Unknown event handler property `onClickOutside`. It will be ignored.
  • Warning: Unknown event handler property `onDblClick`. It will be ignored.

Cum o eviți pe viitor

  • Pentru elemente HTML folosește doar evenimentele React documentate (lista e în documentația React, la „Common components”).
  • Hover: onMouseEnter / onMouseLeave; tastatură: onKeyDown; formular: onSubmit; câmpuri: onChange.
  • Dacă vrei un eveniment propriu, fă-l prop al unei componente și apelează-l din handler-ul unui eveniment real.

Întrebări frecvente

Care e diferența față de „Invalid event handler property onclick”?

Acolo evenimentul există, dar e scris cu litere mici; React îți propune forma corectă. Aici numele nu corespunde niciunui eveniment, deci React nu are ce să-ți propună.

Pot face hover doar din CSS?

Da, și e de preferat când doar schimbi stilul: .card:hover { ... }. Evenimentele onMouseEnter / onMouseLeave sunt utile când trebuie să schimbi state-ul (să afișezi un tooltip, să încarci date).

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.