news 2026/4/16 13:04:25

React 表单与状态管理:彻底搞懂 useRef、受控与非受控组件

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
React 表单与状态管理:彻底搞懂 useRef、受控与非受控组件

在 React 开发中,处理表单和 DOM 元素是每个开发者都会遇到的基础挑战。很多初学者在使用useStateuseRef时容易混淆,对于到底是选择“受控组件”还是“非受控组件”也常常感到困惑。

今天,我们将深入剖析这两个核心概念,通过实际的代码案例(如评论框、登录框、计时器等),带你彻底打通 React 数据流管理的任督二脉。

一、 useRef:不仅仅是 DOM 的“钩子”

提到useRef,很多开发者的第一反应是:“哦,这是用来获取<input>焦点或者滚动位置的。”

没错,但访问 DOM 只是useRef能力的一半。为了真正理解它,我们需要从两个维度来看待它:DOM 访问变量存储

1. 场景一:访问 DOM 节点(命令式操作)

在 React 的声明式 UI 中,有时我们需要“强行”执行一些命令式操作,比如页面加载后自动聚焦输入框。

import { useRef, useEffect } from 'react'; function AutoFocusInput() { const inputRef = useRef(null); // 1. 创建 ref 容器,初始值为空 useEffect(() => { // 3. 组件挂载后,current 属性已指向真实的 DOM 元素 // 此时我们可以直接调用原生 DOM API console.log(inputRef.current); inputRef.current.focus(); }, []); // 2. 将 ref 绑定到元素上 return <input ref={inputRef} />; }

原理:useRef创建了一个包含.current属性的普通 JavaScript 对象。当 React 创建 DOM 节点后,会将其引用赋值给这个.current属性。

2. 场景二:“默默奉献”的可变容器

useRefuseState都可以存储数据,但它们有一个本质区别:useRef的变化不会触发组件重新渲染

  • useState:是响应式的。一旦改变,React 会感知并更新视图。
  • useRef:是持久化的容器。它像一个盒子,你可以随时往里存取东西,React 即使重新渲染组件,这个盒子里的东西也不会丢,但修改它也不会通知 React 更新 UI。

这非常适合存储像定时器 ID这种“不需要渲染在页面上”的数据:

import { useRef, useState } from 'react'; function Timer() { let intervalId = useRef(null); // 存储计时器 ID const [count, setCount] = useState(0); function start() { // 修改 current 不会触发重渲染,也不会丢失 intervalId.current = setInterval(() => { console.log('tick~~~~'); }, 1000); } function stop() { // 直接读取 current 清理计时器 clearInterval(intervalId.current); } return ( <> <button onClick={start}>开始</button> <button onClick={stop}>停止</button> </> ) }

二、 非受控组件 (Uncontrolled Components)

理解了useRef,就很好理解非受控组件了。所谓的“非受控”,是指表单数据由 DOM 节点本身处理,而不是由 React 组件的状态处理。

代码演示:评论框

在这种模式下,React 并不实时掌握输入框里的内容。我们通常在提交那一刻,利用ref去 DOM 里“拉取”数据。

import { useRef } from 'react'; export default function CommentBox() { const textareaRef = useRef(null); const handleSubmit = () => { // 只有在需要的时候(比如提交时),才去 DOM 里面拿值 const comment = textareaRef.current.value; if(!comment) return alert('请输入评论'); console.log(comment); } return ( <div> {/* defaultValue 可以设置初始值,但之后就是用户自由控制了 */} <textarea ref={textareaRef} placeholder="请输入评论..."></textarea> <button onClick={handleSubmit}>提交</button> </div> ) }

优缺点分析

  • 优点:代码量少,容易集成非 React 代码(如 jQuery 插件),适合文件上传等场景。
  • 缺点:无法实时验证(例如无法在用户打字时提示“密码太短”),难以实现字段间的联动。
  • 适用场景:一次性读取数据、性能敏感场景、文件上传。

三、 受控组件 (Controlled Components)

受控组件是 React 官方推荐的处理表单的方式。在这里,React 的 state 成为“单一数据源” (Single Source of Truth)

这意味着:输入框的 value 来源于 state,而用户的输入(onChange)通过更新 state 来改变 value。

代码演示:登录表单

import { useState } from 'react'; export default function LoginForm() { const [form, setForm] = useState({ username: '', password: '' }); const handleChange = (e) => { // 状态更新驱动页面变化 setForm({ ...form, // 使用计算属性名处理多个输入 [e.target.name]: e.target.value }) } const handleSubmit = (e) => { e.preventDefault(); console.log(form); // 直接打印 state,不需要去 DOM 查值 } return ( <form onSubmit={handleSubmit}> <input type="text" name="username" value={form.username} // 数据 -> 视图 onChange={handleChange} // 视图 -> 数据 /> <input type="password" name="password" value={form.password} onChange={handleChange} /> <button type="submit">登录</button> </form> ) }

为什么要这么麻烦?

虽然代码看起来比非受控组件多了几行,但这带来了巨大的好处:

  1. 即时验证:你可以在handleChange里立即判断输入是否合法,并显示错误信息。
  2. 条件禁用:例如disabled={!form.username},没填用户名不能点登录。
  3. 数据格式化:可以强制用户输入的内容符合特定格式(如大写转换)。

四、 巅峰对决:如何选择?

总结来说,两者的核心区别在于谁掌握了数据的所有权

特性非受控组件 (Uncontrolled)受控组件 (Controlled)
数据来源DOM 节点React State
获取值的方式使用useRef(current.value)使用useState(直接读取变量)
实时交互弱 (适合一次性获取)强 (适合即时反馈)
代码量较少稍多
典型用途文件上传、简单表单表单校验、联动、实时搜索

最佳实践建议

在绝大多数日常开发中(90% 的场景),建议优先使用受控组件。它能让你完全掌控数据流,避免状态与 UI 不一致的问题。

只有在以下情况考虑使用非受控组件:

  1. 需要通过<input type="file" />上传文件(因为文件是只读的,React 无法控制)。
  2. 集成了大量第三方 DOM 库。
  3. 非常简单的表单,完全不需要验证逻辑。

掌握了useRef的双重用法以及两种组件模式的区别,你就已经跨过了 React 表单开发中最重要的一道门槛。接下来,去尝试用受控组件重构你复杂的表单逻辑吧!

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/12 0:25:44

vivado注册 2035 超详细版:每一步截图说明

Vivado注册2035&#xff1f;别被名字吓到&#xff01;手把手带你搞定FPGA开发第一步 你是不是也曾在搜索引擎里输入“vivado注册 2035”——然后一头雾水&#xff1f; 别急&#xff0c;这其实不是什么神秘代码&#xff0c;也不是某个隐藏功能。所谓的“ vivado注册 2035 ”…

作者头像 李华
网站建设 2026/4/15 2:55:37

Jupyter Notebook嵌入视频演示模型效果

Jupyter Notebook 嵌入视频演示模型效果 在一场算法评审会上&#xff0c;团队成员正展示一个基于深度学习的行人跟踪系统。当讲到关键帧处理逻辑时&#xff0c;主讲人突然切换窗口&#xff0c;打开本地播放器&#xff0c;开始播放一段标注了检测框的视频。“看&#xff0c;这里…

作者头像 李华
网站建设 2026/4/15 9:58:52

cuDNN加速PyTorch深度学习模型训练实测效果

cuDNN 加速 PyTorch 深度学习模型训练实测效果 在现代深度学习研发中&#xff0c;一个再熟悉不过的场景是&#xff1a;你刚刚写完一段模型代码&#xff0c;满怀期待地按下运行&#xff0c;结果发现单个 epoch 就要几个小时。尤其当你面对 ResNet、ViT 或更大规模的网络时&#…

作者头像 李华
网站建设 2026/4/12 14:14:58

超详细版Driver Store Explorer安装与配置步骤

驱动存储库清理利器&#xff1a;Driver Store Explorer 实战指南 你有没有遇到过这样的情况&#xff1f;一台用了几年的 Windows 电脑&#xff0c;C 盘空间越来越紧张&#xff0c;系统运行也变得迟缓。任务管理器看不出明显问题&#xff0c;杀毒软件也没发现异常——但就是“卡…

作者头像 李华
网站建设 2026/4/14 20:18:58

PyTorch模型量化入门:降低大模型推理Token消耗

PyTorch模型量化入门&#xff1a;降低大模型推理Token消耗 在当前AI服务广泛采用按量计费模式的背景下&#xff0c;一次API调用所消耗的Token数量不仅取决于输入输出长度&#xff0c;更与模型响应速度密切相关——响应越慢&#xff0c;会话停留时间越长&#xff0c;后台计时越久…

作者头像 李华
网站建设 2026/4/8 12:08:12

Jupyter Notebook %who列出当前PyTorch变量

Jupyter Notebook 中高效管理 PyTorch 变量的实用技巧 在深度学习项目的开发过程中&#xff0c;尤其是在使用 Jupyter Notebook 进行实验性建模时&#xff0c;一个常见的困扰是&#xff1a;你写了几轮代码后&#xff0c;突然不确定当前会话里到底定义了哪些张量、模型或中间变量…

作者头像 李华