useId
一句话解释
useId 为链接 label/input、aria 属性创建唯一 ID——SSR 安全且水合安全。
用大白话说
useId(React 18)生成在服务端和客户端渲染间稳定的唯一 ID 字符串。这防止了用 Math.random() 或 Date.now() 生成 ID 时出现的水合不匹配。用于无障碍:将 <label htmlFor> 链接到 <input id>,连接 aria-labelledby 到元素等。生成的 ID 看起来像 :r0:、:r1:——不是给人类看的。每个组件调用一次 useId,为多个元素追加后缀:id + "-tab"、id + "-panel"。
示例
jsx
import { useId } from "react";
function FormField({ label, ...props }) {
const id = useId();
return (
<div>
<label htmlFor={id}>{label}</label>
<input id={id} {...props} />
</div>
);
}
function Tabs() {
const id = useId();
return (
<>
<button id={`${id}-tab`} aria-controls={`${id}-panel`}>Tab 1</button>
<div id={`${id}-panel`} role="tabpanel">Content</div>
</>
);
}useId 为无障碍生成稳定的唯一 ID。调用一次并为多个相关元素追加后缀。
常见混淆
容易混淆的对象: useRef
关键区别: useRef 创建用于 DOM 访问的可变 ref 对象——它不生成 ID 字符串。useId 为 HTML 属性(id、htmlFor、aria-*)生成字符串 ID。它们用途不同:ref 用于命令式 DOM 访问,useId 用于属性链接。
相关术语
相关资源
相关课程
- React 18 特性
useId。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。