受控 vs 非受控组件：useControlled

痛点

可复用的 UI 组件通常需要支持两种模式：受控和非受控。怎么说呢，支持两种模式是 MUI、Radix 等成熟组件库的标配——但实现起来出乎意料地繁琐。

手动实现

import { useCallback。useRef,useState } from "react";interface CustomInputProps { 说到value?，string，其实，defaultValue?: string，onChange?: => void，} function CustomInput { const isControlled = value!话说回来，== undefined;const = useState;// 用 ref 始终持有最新的受控值 const valueRef = useRef;valueRef.current = value;const currentValue = isControlled?value : internalValue;const handleChange = useCallback( => { const next = e.target.value;if { setInternalValue;} onChange，.; },)，不过，return ( );}

对于一个简单输入框来说够用了。但当受控值从外部变更时、当你要提醒开发者不要在受控和非受控之间切换时、当值是复杂对象而非基本类型时这套逻辑就越来越复杂。每个需要双模式的组件都在重复同一段代码。

用 useControlled

useControlled 封装了整套受控/非受控协调逻辑。返回一个 元组，无论使用者选择哪种模式都能正常工作。

import { useControlled } from "@reactuses/core";interface CustomInputProps { value?这方面，string，defaultValue?老实说，: string;onChange，: => void;怎么说呢，} function CustomInput { const = useControlled({ value。defaultValue,onChange,});return ( setCurrentValue} style={{ padding: "8px 12px"。border: "1px solid #d1d5db",borderRadius:,fontSize:,}} /> );// ...其他代码保持不变... } // ...其他代码保持不变... // ...其他代码保持不变... // ...其他代码保持不变...

import {{
const {
{
{
}
}

const {