Skip to content

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 用于属性链接。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表