React+TypeScript中的事件类型

本文参考了 Matt Pocock 的文章 Event Types in React and TypeScript ,有条件的可以阅读英文原版。

一、前言

用 React 和 TypeScript 开发时,会经常碰到这个报错:

当我们给不同的 DOM 元素添加事件处理函数时,onChange 中参数 e 接收到的事件类型是不同的,我们必须为e 指定正确的类型。

二、解决方案

1. 鼠标悬浮

我们把鼠标悬浮在 onChange 上,IDE 会给出相应的类型,直接复制,再将类型添加给声明的事件处理函数:
我们需要的是 ?: 后面的这部分代码。

2. 内联函数

当我们只想为 e 添加类型时,首先要知道 e 的类型是什么。

创建一个内联事件处理函数,将鼠标悬浮在参数 e 上,IDE 会给出正确的类型,选中并复制:

然后添加到我们的处理函数中:

3. 使用 React.ComponentProps

React.ComponentProps 是一个类型工具,用于获取组件或元素的类型。

4. EventFor 工具类型

第三种方案非常方便,但是如果我们只是想给 e 添加类型,有没有更优雅的写法呢?

我们可以用 TypeScript 内置的工具类型 Parameters 、NonNullable 以及索引访问来实现:

解释一下上面的代码:

  • React.ComponentProps<'input'>['onChange'] 在第三种方案中用过,但是这个类型包含 undefined ,需要使用 NonNullable 把它去掉;
  • NonNullable 用于去除某个类型中的 null 和 undefined ;
  • Parameters 用于获取某个函数的所有参数类型,返回一个类型数组,再使用 [0] 取出第一个参数的类型。

如此一来,我们就拿到了参数 e 的正确类型。

但是,上面这种写法有点冗杂,我们可以再进一步,封装一个工具类型:

typescript 复制代码
type GetEventHandlers<
  T extends keyof JSX.IntrinsicElements,
> = Extract<keyof JSX.IntrinsicElements[T], `on${string}`>

type EventFor<
  TElement extends keyof JSX.IntrinsicElements,
  THandler extends GetEventHandlers<TElement>,
> = JSX.IntrinsicElements[TElement][THandler] extends
  | (((e: infer TEvent) => any) | undefined)
  ? TEvent
  : never

上面这段代码需要一些类型体操的知识,这里只解释大概原理:

  • JSX.IntrinsicElements 是一个 interface ,其中声明了所有 HTML 元素的类型;

  • GetEventHandlers 接收一个元素类型,通过 Extract 提取该元素所有 onXxxx 形式的属性,也就是所有的事件:

  • EventFor 接收两个泛型,分别代表元素类型和事件名称,根据这两个泛型从 JSX.IntrinsicElements 中取出对应事件的处理函数的类型声明,然后通过 extends 以及 infer 关键字推断参数 e 的类型并返回。

效果:

相关推荐
kyriewen11 小时前
编辑弹窗点了取消,列表里的数据怎么还是变了?
前端·javascript·人工智能
Karl_fang11 小时前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
谭光志12 小时前
如何让 AI 高效工作
前端·后端·ai编程
FRing0313 小时前
vue2干货总结11(短信验证、登录功能、统一处理错误(响应拦截器)、将token信息存入vuex、vuex持久化处理)
开发语言·前端·javascript·vue.js·vue2
泯泷13 小时前
改一个字,整段都红了?——中文内容差异对比的算法与协议设计
前端·javascript·typescript
再吃一根胡萝卜14 小时前
DSH plugin 开发示例:五种插件形态完整代码整理
前端
Yk酱2284014 小时前
A2UI随笔-demo-01
前端
云起SAAS14 小时前
本地生活同城多商户商城系统源码源码 合伙人分红加区域代理加排队返现
前端·javascript·后端
奶油话梅糖14 小时前
3 天 1,705 Star:DeepSeek 开源官方聊天前端——零后端纯静态,浏览器直连 API
前端·开源
Linye14 小时前
HTML 流程图连线交叉看不清?聊聊画布避障折线与跳弧实现
前端·人工智能