HOWTO · React
Utilice el evento onChange en React
onChange es uno de los eventos de entrada más comunes en React. Este artículo le ayudará a comprender cómo funciona.
En esta página
La prop onChange de React permite que un componente responda a los cambios realizados en los controles de un formulario. Un controlador lee el valor del control que cambió y actualiza el estado que proporciona el valor mostrado. onChange de React no es simplemente el atributo HTML nativo onchange: React gestiona los cambios del formulario mediante su sistema de eventos, cuyo comportamiento está adaptado a los controles de React.
Usa una entrada controlada cuando el componente deba administrar el valor actual del formulario, validarlo o utilizarlo en otra parte de la interfaz. El patrón básico consiste en pasar un valor de estado al control y actualizar ese estado en su controlador onChange.
Cómo funciona el evento onChange
Asocia un controlador a un elemento input, textarea o select mediante la prop JSX onChange. En los campos de texto y los selectores, lee event.target.value; en las casillas de verificación, lee el valor booleano event.target.checked. Después, el controlador actualiza el estado asociado a ese control.
En un control de formulario controlado, el valor mostrado proviene del estado. Cuando el controlador actualiza el estado, React vuelve a representar el control con el valor nuevo. Así, la interfaz y los datos del componente se mantienen sincronizados. Elige un control no controlado si el componente no necesita administrar su valor durante la interacción.
Cómo implementar onChange en campos de texto
Para un campo de texto, guarda una cadena en el estado, pásala mediante value y actualízala a partir del evento. En un componente de clase cuyo estado contiene name, el control JSX puede escribirse así: <input value={this.state.name} onChange={event => this.setState({ name: event.target.value })} />. La actualización del estado hace que el texto mostrado refleje cada edición. Mantén el valor del estado como una cadena durante toda la vida del campo.
El JavaScript ejecutable que aparece a continuación aísla la lógica de los controladores para un campo de texto, una casilla de verificación y un selector. Usa pequeños métodos para actualizar el estado y mostrar qué propiedad del evento lee cada controlador; no representa controles de React. Las líneas JSX de este artículo muestran cómo conectar esos valores con controles controlados de React.
let name = '';
let subscribed = false;
let category = 'books';
const setName = (value) => { name = value; };
const setSubscribed = (value) => { subscribed = value; };
const setCategory = (value) => { category = value; };
const handleNameChange = (event) => setName(event.target.value);
const handleSubscribedChange = (event) => setSubscribed(event.target.checked);
const handleCategoryChange = (event) => setCategory(event.target.value);
handleNameChange({ target: { value: 'Ada' } });
handleSubscribedChange({ target: { checked: true } });
handleCategoryChange({ target: { value: 'music' } });
console.log(`Name: ${name}`);
console.log(`Subscribed: ${subscribed}`);
console.log(`Category: ${category}`);
La salida de este ejemplo muestra etiquetas en inglés. Como el bloque no se modifica, esas etiquetas permanecen en inglés.
Name: Ada
Subscribed: true
Category: music
En un componente de React, los métodos de actualización del ejemplo ejecutable corresponden a las actualizaciones del estado. El valor mostrado por el control proviene de ese estado, lo que permite a React mantener sincronizadas la vista y los datos.
Cómo trabajar con casillas de verificación
Una casilla de verificación representa una opción booleana, así que controla su selección con checked y lee event.target.checked en su controlador. En un componente de clase, una casilla puede usar checked={this.state.subscribed} y onChange={event => this.setState({ subscribed: event.target.checked })}. La propiedad value de la casilla es el valor que se envía con el formulario; no indica si el usuario la ha seleccionado.
Cómo usar onChange con listas desplegables
En un selector, pasa el estado de la opción seleccionada mediante value y lee la siguiente opción de event.target.value. Por ejemplo, usa <select value={this.state.category} onChange={event => this.setState({ category: event.target.value })}><option value="books">Books</option><option value="music">Music</option></select>. El valor de la opción es el dato que se guarda en el estado y puede ser distinto de la etiqueta visible. Al actualizar el estado, la opción seleccionada y cualquier parte dependiente de la interfaz siguen una misma fuente de verdad.
Buenas prácticas para usar onChange
Procura que los controladores se centren en leer el evento y actualizar el estado correspondiente. Valida según las necesidades del formulario: por ejemplo, mientras el usuario escribe si necesitas ofrecer comentarios inmediatos, o al enviar el formulario si mostrar comentarios durante la escritura resultaría molesto. Asegúrate de que la prop value y su estado tengan un tipo coherente, y usa checked para el estado de una casilla de verificación.
La técnica de debounce puede ayudar cuando un controlador inicia una tarea costosa, como filtrar un conjunto grande de datos o enviar una solicitud de búsqueda. Añade un retraso a la respuesta y no evita automáticamente que React vuelva a renderizar, así que úsala solo cuando la tarea y la experiencia de usuario se beneficien. Actualizar el estado controlado con cada pulsación es una práctica normal.
Cambiar mediante código el valor de un elemento de entrada del DOM es un caso avanzado. Asignar un valor directamente no garantiza por sí solo que React detecte el cambio o invoque el controlador esperado. Es preferible actualizar el estado que controla el campo. Si un código externo debe interactuar con un control de formulario, usa la interfaz pública del componente cuando sea posible y comprueba el comportamiento de esa integración; nombres de métodos auxiliares como setNativeValue no corresponden a API generales de React ni son soluciones garantizadas.
Conclusión
Los controladores onChange de React conectan las ediciones del usuario con el estado del componente. Lee value en los controles de texto y los selectores, y checked en las casillas de verificación; después, representa los controles controlados a partir del estado actualizado. Aplica la validación y la técnica de debounce según las necesidades del formulario, no como reglas universales.
Preguntas frecuentes
-
¿Qué hace
onChangeenReact? Llama a un controlador cuando cambia un control del formulario para que el componente pueda leer el valor nuevo y actualizar sus datos o su estado. -
¿Cómo gestiono un campo de texto? Pasa una cadena del estado a la prop
valuedel campo y actualiza ese estado desdeevent.target.valueenonChange. -
¿Cómo gestiono una casilla de verificación? Contrólala con un estado booleano mediante
checkedy actualiza ese estado desdeevent.target.checked. -
¿Cómo gestiono un selector? Asigna su
valuea partir del estado y actualiza ese estado desdeevent.target.valuecuando cambie la selección. -
¿Debo aplicar debounce a todos los controladores
onChange? No. Considéralo cuando el controlador inicie una tarea costosa; no hace falta para cada actualización del estado y no garantiza que haya menos renderizados. -
¿Por qué quizá un cambio programático del valor no invoque mi controlador? Asignar directamente un valor del DOM no activa necesariamente el manejo de cambios de
React. Actualiza el estado que controla el campo o usa la interfaz admitida por el componente.