TS_React:类型化EventHandler

简介: 今天我们主要是讲如何利用TS对React中的事件回调进行类型化处理。


焦虑可分为有用焦虑无用焦虑两种。

  1. 有用焦虑指向现在
  2. 无用焦虑指向未来,它的本质,是对现在失控的恐惧

大家好,我是柒八九

今天还是--TypeScript实战系列的文章。前面的文章中,我们从不同的角度介绍了,TS是如何结合React进行项目开发的。相关文章如下。

而今天我们主要是讲如何利用TSReact中的事件回调进行类型化处理。

好了,天不早了。我们开始粗发


1. 示例代码

这是一个非常简单的React应用,有一个input和一个button。我们用这个例子来一步步处理,如何用TS处理里面的事件回调。

import { useState } from 'react';
export default function App() {
  const [inputValue, setInputValue] = useState('');
  const handleInputChange = (event) => {
    setInputValue(event.target.value);
  };
  const handleClick = (event) => {
    console.log('提交被触发');
  };
  return (
    <div className="App">
      <h1>前端柒八九</h1>
      <input value={inputValue} onChange={handleInputChange} />
      <button onClick={handleClick}>提交</button>
    </div>
  );
}
复制代码

2. 添加TS

有几种方法来类型化上述代码中的回调函数,我们将看到3种主要的方法。

  1. 类型化事件处理程序的参数
  2. 类型化事件处理程序本身
  3. 依靠类型推断

类型化事件处理程序的参数(event)

先处理onClick事件。React 提供了一个 MouseEvent 类型,可以直接使用!

import { 
    useState, 
+   MouseEvent,
} from 'react';
export default function App() {
  // 省略部分代码
+  const handleClick = (event: MouseEvent) => {
    console.log('提交被触发');
  };
  return (
    <div className="App">
      <h1>前端柒八九</h1>
      <button onClick={handleClick}>提交</button>
    </div>
  );
}
复制代码

onClick 事件实际上是由React维护的:它是一个合成事件

合成事件是React浏览器事件的一种包装,以便不同的浏览器,都有相同的API

handleInputChange函数与 handleClick 非常相似,但有一个明显的区别。不同的是,ChangeEvent 是一个泛型,你必须提供什么样的DOM元素正在被使用

import { 
    useState, 
+   ChangeEvent
} from 'react';
export default function App() {
  const [inputValue, setInputValue] = useState('');
+ const handleInputChange = (event: ChangeEvent<HTMLInputElement>) => {
    setInputValue(event.target.value);
  };
  // 省略部分代码
  return (
    <div className="App">
      <h1>前端柒八九</h1>
      <input value={inputValue} onChange={handleInputChange} />
    </div>
  );
}
复制代码

在上面的代码中需要注意的一点是,HTMLInputElement 特指HTML的输入标签。如果我们使用的是 textarea,我们将使用 HTMLTextAreaElement 来代替。

注意,MouseEvent 也是一个泛型,你可以在必要时对它进行限制。例如,让我们把上面的 MouseEvent 限制为专门从一个按钮发出的鼠标事件。

const handleClick = (event: MouseEvent<HTMLButtonElement>) => {
  console.log('提交被触发');
};
复制代码

还需要提示的是,React为我们提供了很多 Event 对象的类型声明。

Event 事件对象类型

事件类型 解释
ClipboardEvent<T = Element> 剪切板事件对象
DragEvent<T =Element> 拖拽事件对象
ChangeEvent<T = Element> Change事件对象
KeyboardEvent<T = Element> 键盘事件对象
MouseEvent<T = Element> 鼠标事件对象
TouchEvent<T = Element> 触摸事件对象
WheelEvent<T = Element> 滚轮时间对象
AnimationEvent<T = Element> 动画事件对象
TransitionEvent<T = Element> 过渡事件对象

类型化事件处理程序本身

React 声明文件所提供的 EventHandler 类型别名,通过不同事件的 EventHandler 的类型别名来定义事件处理函数的类型,更方便定义其函数类型。

type EventHandler<E extends SyntheticEvent<any>> = {
  bivarianceHack(event: E): void
}['bivarianceHack']
复制代码

bivarianceHack 为事件处理函数的类型定义,函数接收一个 event 对象,并且其类型为接收到的泛型变量 E 的类型, 返回值为 void

而在类型定义的时候,有一个很怪异的行为['bivarianceHack']

这与 strictfunctionTypes 下的功能兼容性有关。在此选项下,如果参数是派生类型,则不能将其传递给将传入基类参数的函数。例如:

class Animal { private x:undefined }
class Dog extends Animal { private d: undefined }
type EventHandler<E extends Animal> = (event: E) => void
let o: EventHandler<Animal> = (o: Dog) => { } // 在 strictFunctionTypes 模式下,失败
复制代码

此时,TS会报警告。

所以hack的作用是即使在 strictFunctionTypes启用的情况下允许EventHandler的二元行为。 由于事件处理程序的签名将在方法声明中有其来源,因此它不会受到更严格的函数检查。

type BivariantEventHandler<E extends Animal> = { bivarianceHack(event: E): void }["bivarianceHack"];
// 在 strictFunctionTypes 模式下,生效
let o2: BivariantEventHandler<Animal> = (o: Dog) => { } 
复制代码

讲的有点多,我们还是绕回本文的重点。使用EventHandler来对上面的例子进行改造处理。

import { 
   useState, 
+  ChangeEventHandler, 
+  MouseEventHandler 
} from 'react';
export default function App() {
  const [inputValue, setInputValue] = useState('');
+ const handleInputChange: ChangeEventHandler<HTMLInputElement> = (event) =>{
    setInputValue(event.target.value);
  };
+  const handleClick: MouseEventHandler = (event) => {
    console.log('提交被触发');
  };
  return (
   // ...省略....
  );
}
复制代码

系不系,很简单。


依赖类型推断

你也可以依靠类型推断,而不需要自己处理函数。但是,你需要将回调函数内联处理

import { useState } from 'react';
export default function App() {
  const [inputValue, setInputValue] = useState('');
  return (
    <div className="App">
      <h1>前端柒八九</h1>
      <input 
        value={inputValue} 
+        onChange={(event) => setInputValue(event.target.value)}
      />
      <button 
+        onClick={(event) => console.log('提交被触发')}
      >
        提交
      </button>
    </div>
  );
}
复制代码

这个更简单


后记

分享是一种态度

参考资料:

全文完,既然看到这里了,如果觉得不错,随手点个赞和“在看”吧。


相关文章
|
6月前
|
前端开发 JavaScript 安全
TypeScript在React Hooks中的应用:提升React开发的类型安全与可维护性
【7月更文挑战第17天】TypeScript在React Hooks中的应用极大地提升了React应用的类型安全性和可维护性。通过为状态、依赖项和自定义Hooks指定明确的类型,开发者可以编写更加健壮、易于理解和维护的代码。随着React和TypeScript的不断发展,结合两者的优势将成为构建现代Web应用的标准做法。
|
2月前
|
前端开发 安全
如何使用类型参数来创建 React 泛型组件?
通过以上步骤,就可以使用类型参数来创建灵活、可复用且类型安全的React泛型组件,以满足不同的数据类型和业务需求。
|
3月前
|
JavaScript 前端开发 安全
使用 TypeScript 加强 React 组件的类型安全
【10月更文挑战第1天】使用 TypeScript 加强 React 组件的类型安全
41 3
|
5月前
|
前端开发 JavaScript
React 中的不同类型组件
【8月更文挑战第31天】
36 0
|
8月前
|
缓存 前端开发 JavaScript
React适合开发什么类型的应用?
【5月更文挑战第27天】React适合开发什么类型的应用?
124 3
|
8月前
react+typescript给state和props定义指定类型
react+typescript给state和props定义指定类型
104 1
|
前端开发 JavaScript 算法
解密二叉树:探索概念、类型与常见算法的奥秘(顺带说一下React中的reconcile)
二叉树作为程序的一种数据结构,应用广泛,比如React中的reconcile过程,Fiber树的调和过程。确实,在React中,Fiber树是通过child和sibling连接子节点和兄弟节点的方式来表示的,这与普通的二叉树有所不同。 在React中,reconcile过程是将虚拟DOM转化为实际DOM的过程。通过比较新旧两棵树的差异,React可以高效地更新实际DOM,而不是每次都完全重新渲染整个DOM树。这个过程中会涉及到对Fiber树的遍历和调整,确保更新只发生在需要更新的部分。 Fiber树作为一种数据结构,可以帮助React跟踪组件的状态和变化,以及进行调度和渲染。它使用链表的形
62 1
解密二叉树:探索概念、类型与常见算法的奥秘(顺带说一下React中的reconcile)
|
JavaScript 前端开发 编译器
TS_React:Hook类型化
依赖类型推断 类型化 useState 类型化 useReducer 类型化 useRef 类型化 forwardRef 类型化 useEffect 和 useLayoutEffect 类型化 useMemo 和 useCallback 类型化 useContext 类型化自定义hook
|
前端开发 API
react + zarm 实现账单列表类型以及时间条件弹窗封装
react + zarm 实现账单列表类型以及时间条件弹窗封装
107 0
react + zarm 实现账单列表类型以及时间条件弹窗封装
|
Rust JavaScript 前端开发
TS_React:使用泛型来改善类型
TypeScript 是什么 {泛型| Generics} 是个啥 在React中使用泛型
178 0