当前位置：首页 > news >正文

React TS中如何化简DOM事件的定义

news 来源：原创 2025/7/16 5:49:13

概要

我们在做TS开发时候，总要面对各种类型的定义。React使用自己的Sythetic Event机制管理DOM事件，不同于原生的DOM事件定义，所以在TS中，事件的类型定义更加繁琐。

本文提供一中简化定义的方法，在使用中，充分发挥TS的类型推导机制，可以复用到多种事件的定义中。

我们先看一个click事件的定义方法。

const handleClick = (event:React.MouseEvent<HTMLButtonElement>) => {}

如果更精确的定义，不要自动类型推导，需要写成如下：

const handleClick:(event:React.MouseEvent<HTMLButtonElement>)=>void = (event:React.MouseEvent<HTMLButtonElement>) => {}

上面的两个例子，都有大量的类型定义代码，非常繁琐，所以我们将其简化。

HTMLButtonElement是一个泛型参数，它是可变的，如果是其它鼠标事件，例如在一个Div上定义的MouseOver事件，它可能就变成了HTMLDivElement。

也就是说这一部分是可变的，MouseEvent是固定的，那基于此，我们定义一个的回调函数的type如下：

export type HTMLButtonClickFunc<T extends HTMLElement = HTMLButtonElement> = (param:React.MouseEvent<T>)=>void;

我们将可变的部分设置为泛型T，并增加了一个约束，必须是HTMLElement或者其派生类。

我们再定义Click的事件的方法时候，通过使用HTMLButtonClickFunc，就可以给充分发挥TS类型推导的优势了，代码如下：

 const handleClick:HTMLButtonClickFunc = (e)=> {}

我们的回调方法定义，写成这样，就可以了。因为泛型T有默认的类型HTMLButtonElement，所以我们不用再定义其类型，TS可以将参数e自动推断为React.MouseEvent<HTMLButtonElement, MouseEvent>类型。

键盘事件的回调方法类型如下：

export type HTMLKeyBoardFunc<T extends HTMLElement = HTMLInputElement> = (keyboardEvent:KeyboardEvent<T>)=> void

基于上述类型，回调方法定义如下：

 const handleKeydown:HTMLKeyBoardFunc = (e) => {}

参数e被自动推导为React.KeyboardEvent类型。

Input的change事件回调方法定于如下：

export type HTMLInputChangeFunc<T extends HTMLElement = HTMLInputElement> =  (changeEvent:ChangeEvent<T> ) => void;

基于上述类型，回调方法定义如下：

const handleChnage:HTMLInputChangeFunc = (e) => {}

参数e被自动推导为 React.KeyboardEvent类型

如果我们在页面渲染过程中，需要将一些参数传递给Event的回到方法中，这个时候我们可以用同样的思路处理，我们以Input的Change事件为例，将一些业务数据传递给回调方法。

如果用JS，我们可以定义一个HOF函数，如下：

const handleChange = (businessId)=> (e) => {}

该函数首先接收了一个业务相关的参数，假设传递了一个id数据给了handleChange方法，然后该方法返回一个Change事件的回调方法，回调方法存在于闭包中，所以可以访问到这个Id。通过柯里化，我们很好的把业务数据参数和DOM Event参数进行了分割。

<input type="checkbox" onChange={handleChange(business.id)}/>

调用该方法时候，我们可以直接将id传入：

下面我们看看通过TS如下实现：

const handleChnage:(id:number)=>HTMLInputChangeFunc =(id:number)=> (e) => {}

在HTMLInputChangeFunc 基础上，我们可以直接定义一个函数，该函数返回一个类型是HTMLInputChangeFunc 的回调函数，参数e仍然可以被自动推导为React.ChangeEvent， JS中经常使用的柯里化在TS中，依然可以方便的使用。

通过预定义type和泛型参数，可以很好的帮助我们简化React中的DOM事件定义，让我们把更多的精力放到业务逻辑的代码上。