Gestione degli Eventi
These docs are old and won’t be updated. Go to react.dev for the new React docs.
These new documentation pages teach modern React and include live examples:
La gestione degli eventi negli elementi React è molto simile alla gestione degli eventi negli elementi DOM. Vi sono alcune differenze sintattiche:
- Gli eventi React vengono dichiarati utilizzando camelCase, anziché in minuscolo.
- In JSX, il gestore di eventi (event handler) viene passato come funzione, piuttosto che stringa.
Per esempio, l’HTML:
<button onclick="attivaLasers()">
Attiva Lasers
</button>
è leggermente diverso in React:
<button onClick={attivaLasers}> Attiva Lasers
</button>
Un’altra differenza è che, in React, non è possibile ritornare false
per impedire il comportamento predefinito. Devi chiamare preventDefault
esplicitamente. Ad esempio, in un semplice codice HTML per impedire il comportamento predefinito del form nel submit, potresti scrivere:
<form onsubmit="console.log('Hai cliccato Invia.'); return false">
<button type="submit">Invia</button>
</form>
In React, invece sarebbe:
function Form() {
function handleSubmit(e) {
e.preventDefault(); console.log('Hai cliccato Invia.');
}
return (
<form onSubmit={handleSubmit}>
<button type="submit">Invia</button>
</form>
);
}
In questo esempio, il parametro e
è un evento sintetico (synthetic event). React definisce questi eventi sintetici in base alle specifiche W3C, quindi non hai bisogno di preoccuparti della compatibilità tra browser. Gli eventi React non funzionano esattamente allo stesso modo degli eventi nativi. Consulta la guida di riferimento SyntheticEvent
per saperne di più.
Usando React, in generale, non dovresti aver bisogno di chiamare addEventListener
per aggiungere listeners ad un elemento DOM dopo la sua creazione. Invece, basta fornire un listener quando l’elemento è inizialmente renderizzato.
Quando definisci un componente usando una classe ES6, un pattern comune è usare un metodo della classe come gestore di eventi. Ad esempio, questo componente Interruttore
renderizza un pulsante che consente all’utente di alternare gli stati “Acceso” e “Spento”:
class Interruttore extends React.Component {
constructor(props) {
super(props);
this.state = {acceso: true};
// Necessario per accedere al corretto valore di `this` all'interno della callback this.handleClick = this.handleClick.bind(this); }
handleClick() { this.setState(prevState => ({ acceso: !prevState.acceso })); }
render() {
return (
<button onClick={this.handleClick}> {this.state.acceso ? 'Acceso' : 'Spento'}
</button>
);
}
}
Fai attenzione al valore di this
nelle callback JSX. In JavaScript, i metodi delle classi non sono associati (bound) di default. Se dimentichi di applicare bind
a this.handleClick
e di passarlo a onClick
, this
sarà undefined
quando la funzione verrà effettivamente chiamata.
Questo non è un comportamento specifico in React: è parte di come funzionano le funzioni in JavaScript. In generale, se ti riferisci ad un metodo senza ()
dopo di esso, per esempio onClick = {this.handleClick}
, potresti aver bisogno di applicare bind
a quel metodo.
Se usare la chiamata al metodo bind
ti sembra troppo, ci sono due alternative a disposizione. Puoi usare la sintassi proprietà pubbliche delle classi, per associare correttamente le callback:
class LoggingButton extends React.Component {
// This syntax ensures `this` is bound within handleClick. handleClick = () => { console.log('this is:', this); }; render() {
return (
<button onClick={this.handleClick}>
Clicca qui
</button>
);
}
}
Questa sintassi è abilitata nelle impostazioni predefinite di Create React App.
Se non stai usando la sintassi delle proprietà delle classi, è possibile utilizzare una funzione a freccia all’interno della callback:
class LoggingButton extends React.Component {
handleClick() {
console.log('Il valore di `this` è: ', this);
}
render() {
// Questa sintassi garantisce che `this` sia associato correttamente all'interno di handleClick return ( <button onClick={() => this.handleClick()}> Clicca qui
</button>
);
}
}
Il problema con questa sintassi è che viene creata una callback diversa ogni volta che LoggingButton
viene renderizzato. Nella maggior parte dei casi, non vi sono problemi. Tuttavia, se questa callback viene passata come prop a componenti inferiori, tali componenti potrebbero eseguire un ulteriore re-renderizzamento. In generale, vi consigliamo di utilizzare bind
nel costruttore o la sintassi delle proprietà pubbliche nelle classi, per evitare questo tipo di problema di prestazioni.
Passare Argomenti ai Gestori di Eventi
All’interno di un ciclo, è comune avere l’esigenza di passare un parametro aggiuntivo ad un gestore di eventi. Ad esempio, avendo id
come l’identificativo della riga, le seguenti dichiarazioni sarebbero entrambe valide:
<button onClick={(e) => this.deleteRow(id, e)}>Elimina riga</button>
<button onClick={this.deleteRow.bind(this, id)}>Elimina riga</button>
Le due linee di codice precedenti sono equivalenti e utilizzano le funzioni a freccia e Function.prototype.bind
rispettivamente.
In entrambi i casi, l’argomento e
, che rappresenta l’evento React, verrà passato come secondo argomento dopo l’ID. Con la funzione a freccia, devi passarlo esplicitamente, mentre con bind
qualsiasi altro argomento viene passato automaticamente.