React / 系统课时

状态与事件类型

状态与事件类型

本课解决 React 与 TypeScript 中两类高频问题:状态初始值不足以表达完整类型,以及事件处理函数不知道该写什么类型。完成后,你可以为表单状态和常用事件建立准确类型,并避免依赖 any。

学习目标

  • 为基础值、联合类型、数组和可空状态设置 useState 泛型
  • 正确使用表单、鼠标、键盘和提交事件类型
  • 理解 currentTarget 与事件泛型之间的关系

为状态指定正确泛型

useState 会根据初始值推断状态类型。useState("") 会得到字符串状态,useState(false) 会得到布尔状态;这种情况下通常不必重复写泛型。

当初始值不能代表后续全部取值时,应显式声明泛型。例如,尚未加载的用户需要 User | null,请求状态可以使用字符串联合类型,空数组则应明确元素类型。

tsx
type User = {
  id: number;
  name: string;
};

const [user, setUser] = useState<User | null>(null);
const [status, setStatus] = useState<"idle" | "submitting" | "success">("idle");
const [tags, setTags] = useState<string[]>([]);

以上是片段示例,需要放在 React 函数组件内部,并提前导入 useState。它们分别限制了可空对象、有限状态值和字符串数组,错误赋值会在编译阶段被拦截。

为常用事件选择类型

React 事件类型通常写成“事件种类 + 触发元素”的形式。元素泛型决定 event.currentTarget 的准确类型,因此处理输入框时可以读取 value,处理按钮时可以读取 name。

场景 推荐类型
输入框内容变化 ChangeEvent<HTMLInputElement>
表单提交 FormEvent<HTMLFormElement>
按钮点击 MouseEvent<HTMLButtonElement>
输入框按键 KeyboardEvent<HTMLInputElement>

React 状态与事件处理流程

事件来源应优先读取 currentTarget。它表示绑定处理函数的元素,类型与泛型一致;target 只表示事件最初发生的位置,类型通常更宽,也可能是按钮内部的图标或文字节点。

完整表单示例

下面的组件可直接放入 React 18 与 TypeScript 项目的 App.tsx。它同时演示状态泛型、输入事件、键盘事件、鼠标事件和表单提交事件。

tsx
import {
  useState,
  type ChangeEvent,
  type FormEvent,
  type KeyboardEvent,
  type MouseEvent,
} from "react";

export default function App() {
  const [name, setName] = useState<string>("");
  const [message, setMessage] = useState<string>("尚未提交");

  const handleChange = (event: ChangeEvent<HTMLInputElement>) => {
    setName(event.currentTarget.value);
  };

  const handleKeyDown = (event: KeyboardEvent<HTMLInputElement>) => {
    // Esc 只清空输入,不触发表单提交
    if (event.key === "Escape") {
      setName("");
    }
  };

  const handleButtonClick = (event: MouseEvent<HTMLButtonElement>) => {
    console.log(event.currentTarget.name);
  };

  const handleSubmit = (event: FormEvent<HTMLFormElement>) => {
    event.preventDefault();
    const value = name.trim();
    setMessage(value ? `已提交:${value}` : "请输入姓名");
  };

  return (
    <form onSubmit={handleSubmit}>
      <input
        value={name}
        onChange={handleChange}
        onKeyDown={handleKeyDown}
        placeholder="请输入姓名"
      />
      <button
        type="submit"
        name="submitButton"
        onClick={handleButtonClick}
      >
        提交
      </button>
      <p>{message}</p>
    </form>
  );
}

预期结果

text
输入“Lin”并提交:页面显示“已提交:Lin”
按 Esc:输入框内容被清空
点击提交按钮:浏览器控制台输出 submitButton

实际页面样式会受项目现有 CSS 影响,但交互结果应一致。

关键边界

事件处理函数直接写在 JSX 中时,TypeScript 通常能从属性位置推断事件类型;将函数提取为独立变量后,显式标注类型更清楚。

不要使用 any 绕过事件类型。若元素类型写错,例如把输入框事件声明为 ChangeEvent<HTMLSelectElement>,读取属性或绑定函数时会立即出现类型错误。

状态更新函数只接受泛型允许的值。若状态存在“未加载、成功、失败”等有限阶段,联合类型通常比宽泛的 string 更安全。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

状态与事件类型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通