For AI agents: the complete documentation index is available at /next/zh/llms.txt, the full documentation bundle is available at /next/zh/llms-full.txt, and this page is available as Markdown at /next/zh/api/react/Hooks/useRef.md.
  • 简体中文
  • 函数: useRef()

    调用签名

    useRef<T>(initialValue: T): RefObject<T>

    useRef 返回一个可变的 ref 对象,其 .current 属性会被初始化为传入的参数 (initialValue)。返回的对象会在组件的整个生命周期内持续存在。

    请注意,useRef() 的用途不止 ref 属性。它也很适合用来保存任意可变 值,类似于在 class 中使用实例字段的方式。

    类型参数

    类型参数
    T

    参数

    参数类型
    initialValueT

    返回

    RefObject<T>

    Version

    16.8.0

    参阅

    https://react.dev/reference/react/useRef

    调用签名

    useRef<T>(initialValue: T | null): RefObject<T | null>

    useRef 返回一个可变的 ref 对象,其 .current 属性会被初始化为传入的参数 (initialValue)。返回的对象会在组件的整个生命周期内持续存在。

    请注意,useRef() 的用途不止 ref 属性。它也很适合用来保存任意可变 值,类似于在 class 中使用实例字段的方式。

    类型参数

    类型参数
    T

    参数

    参数类型
    initialValueT | null

    返回

    RefObject<T | null>

    Version

    16.8.0

    参阅

    https://react.dev/reference/react/useRef

    调用签名

    useRef<T>(initialValue: T | undefined): RefObject<T | undefined>

    useRef 返回一个可变的 ref 对象,其 .current 属性会被初始化为传入的参数 (initialValue)。返回的对象会在组件的整个生命周期内持续存在。

    请注意,useRef() 的用途不止 ref 属性。它也很适合用来保存任意可变 值,类似于在 class 中使用实例字段的方式。

    类型参数

    类型参数
    T

    参数

    参数类型
    initialValueT | undefined

    返回

    RefObject<T | undefined>

    Version

    16.8.0

    参阅

    https://react.dev/reference/react/useRef

    除非另有说明,本项目采用知识共享署名 4.0 国际许可协议进行许可,代码示例采用 Apache License 2.0 许可协议进行许可。