useControlled

useControlled 是一個自定義 hook，幫助你管理受控組件。它是 useState 的一個包裝器，允許你從外部控制組件的值。

useControlled 讓一個元件同時支援受控和非受控兩種模式。它接受 value（受控值）和 defaultValue（非受控預設值），回傳當前值和設定函式。當提供了 value 時為受控模式，否則使用內部 state。

使用場景

• 建構同時支援受控和非受控使用方式的表單元件
• 開發可重用的 UI 元件函式庫，讓消費者選擇控制模式
• 遷移非受控元件為受控元件時提供向後相容性

注意事項

• 模式偵測：根據 value 是否為 undefined 來決定使用受控還是非受控模式。
• onChange 回呼：在兩種模式下都會呼叫 onChange 回呼，讓父元件可以追蹤值的變更。
• 相關 hooks：另請參閱 useBoolean 和 useToggle 用於特定型別的狀態管理。

Usage

function Demo() {
  const [state, setState] = useState<string>("");
  const [value, setValue] = useControlled(state, "");
  const [value1, setValue1] = useControlled(undefined, "非受控值");

  const handleChange = (event) => {
    setState(event.target.value);
  };

  const handleChange1 = (event) => {
    setValue1(event.target.value);
  };

  return (
    <>
      <input value={value} onChange={handleChange} />
      <p>受控值：{value}</p>
      <input value={value1} onChange={handleChange1} />
    </>
  );
}

API

useControlledState

Returns

[T, (value: T) => void]: 包含以下元素的元組：

• 當前值。
• 更新當前值的函數。

Arguments