React / 系统课时
状态与事件类型
状态与事件类型
本课解决 React 与 TypeScript 中两类高频问题:状态初始值不足以表达完整类型,以及事件处理函数不知道该写什么类型。完成后,你可以为表单状态和常用事件建立准确类型,并避免依赖 any。
学习目标
- 为基础值、联合类型、数组和可空状态设置
useState泛型 - 正确使用表单、鼠标、键盘和提交事件类型
- 理解
currentTarget与事件泛型之间的关系
为状态指定正确泛型
useState 会根据初始值推断状态类型。useState("") 会得到字符串状态,useState(false) 会得到布尔状态;这种情况下通常不必重复写泛型。
当初始值不能代表后续全部取值时,应显式声明泛型。例如,尚未加载的用户需要 User | null,请求状态可以使用字符串联合类型,空数组则应明确元素类型。
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> |

事件来源应优先读取 currentTarget。它表示绑定处理函数的元素,类型与泛型一致;target 只表示事件最初发生的位置,类型通常更宽,也可能是按钮内部的图标或文字节点。
完整表单示例
下面的组件可直接放入 React 18 与 TypeScript 项目的 App.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>
);
}预期结果
输入“Lin”并提交:页面显示“已提交:Lin”
按 Esc:输入框内容被清空
点击提交按钮:浏览器控制台输出 submitButton实际页面样式会受项目现有 CSS 影响,但交互结果应一致。
关键边界
事件处理函数直接写在 JSX 中时,TypeScript 通常能从属性位置推断事件类型;将函数提取为独立变量后,显式标注类型更清楚。
不要使用 any 绕过事件类型。若元素类型写错,例如把输入框事件声明为 ChangeEvent<HTMLSelectElement>,读取属性或绑定函数时会立即出现类型错误。
状态更新函数只接受泛型允许的值。若状态存在“未加载、成功、失败”等有限阶段,联合类型通常比宽泛的 string 更安全。