Skip to content

表单输入在受控和非受控间切换

快速摘要

你的 input value 属性首次渲染为 undefined 但之后变为字符串 —— React 警告从非受控切换到受控。

为什么发生

  • 状态初始化为 undefined 或 null,使首次渲染时输入为非受控

  • value 属性条件设置,某些渲染为 undefined 某些为字符串

  • 表单字段绑定到以 undefined 开始的用户状态,交互后设为字符串

最小示例

✗ 错误代码
function Form() {
  const [name, setName] = useState(); // undefined initially
  return <input value={name} onChange={e => setName(e.target.value)} />;
}
✓ 修复代码
function Form() {
  const [name, setName] = useState(''); // empty string initially
  return <input value={name} onChange={e => setName(e.target.value)} />;
}

用空字符串初始化状态使输入从首次渲染就是受控的,避免非受控到受控切换警告。

如何诊断

  • 检查 React 控制台警告:'A component is changing an uncontrolled input to be controlled'

  • 验证受控输入的初始状态值不是 undefined 或 null

  • 检查 value 属性确保始终为字符串(或数字),永不为 undefined

如何修复

  • 用空字符串初始化状态:useState('') 而非 useState() 或 useState(null)

  • 为 value 属性提供回退:value={stateValue || ''} 确保始终为字符串

  • 对非受控输入使用 defaultValue 或始终为受控输入提供定义的值

如何预防

  • 始终用空字符串初始化受控输入状态,永不用 undefined 或 null

  • 使用 value={x ?? ''} 或 value={x || ''} 保证 value 属性始终为定义的字符串

相关资源

相关术语

相关课程

← 返回语言