0Pricing
React Academy · Lección

Tipar eventos y refs en TypeScript

Utilice los genéricos React.ChangeEvent, React.MouseEvent y RefObject para las interacciones con el DOM.

Tipar eventos y refs en TypeScript es una lección gratuita de React Academy en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de React Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de React Academy incluye 4 lecciones en total.

Eventos sintéticos de React

React encapsula los eventos nativos del DOM en SyntheticEvent. Cada tipo de evento tiene un genérico específico: React.ChangeEvent<HTMLInputElement>, React.MouseEvent<HTMLButtonElement>, etc.

Tipar onChange

El evento más común es onChange en los campos de entrada. Tipa su controlador con React.ChangeEvent<HTMLInputElement>.

function SearchInput() {
  const [value, setValue] = useState('');

  const handleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
    setValue(e.target.value);
  };

  return <input value={value} onChange={handleChange} />;
}

Tipar onClick

Los clics de los botones utilizan React.MouseEvent<HTMLButtonElement>. Acceda a e.currentTarget, e.preventDefault() y e.stopPropagation() con un tipado completo.

function DeleteButton({ onDelete }: { onDelete: () => void }) {
  const handleClick = (e: React.MouseEvent<HTMLButtonElement>) => {
    e.stopPropagation();
    onDelete();
  };
  return <button onClick={handleClick}>Delete</button>;
}

Tipar onSubmit

El envío de formularios utiliza React.FormEvent<HTMLFormElement>. Llame siempre a e.preventDefault() para detener la navegación predeterminada del navegador.

function LoginForm() {
  const handleSubmit = (e: React.FormEvent<HTMLFormElement>) => {
    e.preventDefault();
    const form = e.currentTarget;
    const email = (form.elements.namedItem('email') as HTMLInputElement).value;
    console.log(email);
  };
  return (
    <form onSubmit={handleSubmit}>
      <input name="email" />
      <button type="submit">Login</button>
    </form>
  );
}

Tipar eventos de teclado

Utilice React.KeyboardEvent<HTMLElement> para tipar los controladores de teclado. Acceda de forma segura a e.key, e.code y e.ctrlKey.

function CommandInput() {
  const handleKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {
    if (e.key === 'Enter' && e.metaKey) {
      submitCommand();
    }
  };
  return <input onKeyDown={handleKeyDown} />;
}

useRef para elementos del DOM

Proporcione el tipo del elemento HTML como genérico de useRef e inicialícelo con null. Así, TypeScript sabe que la referencia contiene ese tipo de elemento.

function AutoFocusInput() {
  const inputRef = useRef<HTMLInputElement>(null);

  useEffect(() => {
    inputRef.current?.focus();
  }, []);

  return <input ref={inputRef} />;
}

Referencia mutable frente a referencia del DOM

Al almacenar un valor mutable, no un nodo del DOM, inicialice useRef con un valor en lugar de null. TypeScript inferirá una MutableRefObject mutable.

// DOM ref (read-only current)
const divRef = useRef<HTMLDivElement>(null);

// Mutable ref (read-write current)
const countRef = useRef<number>(0);
countRef.current += 1; // ✓ no TypeScript error

Tipar useImperativeHandle

Al exponer una API de referencia desde un componente hijo, defina una interfaz para el identificador y utilícela tanto en forwardRef como en useImperativeHandle.

interface DialogHandle {
  open: () => void;
  close: () => void;
}

const Dialog = forwardRef<DialogHandle, { title: string }>((props, ref) => {
  useImperativeHandle(ref, () => ({
    open: () => console.log('open'),
    close: () => console.log('close'),
  }));
  return <div>{props.title}</div>;
});

Callbacks de referencias

Un callback de referencia recibe el elemento del DOM o null. Típelo como (node: HTMLElement | null) => void.

function MeasureDiv() {
  const [height, setHeight] = useState(0);

  const measuredRef = (node: HTMLDivElement | null) => {
    if (node) setHeight(node.getBoundingClientRect().height);
  };

  return <div ref={measuredRef}>Content: {height}px tall</div>;
}

Target del evento frente a currentTarget

e.target es el elemento que activó el evento; e.currentTarget es el elemento al que está asociado el controlador. Convierta e.target cuando necesite propiedades específicas.

const handleClick = (e: React.MouseEvent<HTMLUListElement>) => {
  const target = e.target as HTMLLIElement;
  console.log(target.dataset.id);
};

Tipo genérico para controladores de eventos

Para escribir funciones reutilizables de controladores de eventos, utilice el genérico React.EventHandler<Event> o escriba directamente la firma completa de la función.

type InputChangeHandler = React.ChangeEventHandler<HTMLInputElement>;

const logChange: InputChangeHandler = (e) => {
  console.log(e.target.value); // e is fully typed
};

Comprobación rápida

¿Qué tipo de TypeScript debe utilizar para un useRef que contiene un HTMLInputElement?

Resumen

Tipa los controladores de eventos con los genéricos React.ChangeEvent, React.MouseEvent y React.FormEvent. Tipa las referencias del DOM con useRef<HTMLElement>(null) y las referencias mutables con el tipo del valor. Utilice forwardRef con una interfaz de identificador explícita para las API imperativas.

Preguntas frecuentes

¿La lección «Tipar eventos y refs en TypeScript» es gratis?

Sí — el texto completo de «Tipar eventos y refs en TypeScript» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de React Academy, actualiza a CoddyKit PRO. El curso de React Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Tipar eventos y refs en TypeScript»?

Utilice los genéricos React.ChangeEvent, React.MouseEvent y RefObject para las interacciones con el DOM. Practicas React Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar React Academy?

No se requiere experiencia previa. React Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.

¿Cuánto tiempo toma la lección «Tipar eventos y refs en TypeScript»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de React Academy?

Sí. Cada lección de React Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Tipar props y tipos de retorno de componentes
  2. Tipar eventos y refs en TypeScript
  3. Componentes genéricos y tipos utilitarios
  4. Tipar contextos y custom hooks
← Volver a React Academy