Skip to content

useDeferredValue

一句话解释

useDeferredValue 让你延迟 prop/值,使 UI 在昂贵重计算期间保持响应。

用大白话说

useDeferredValue(React 18)接收一个值并返回其延迟版本。React 继续使用旧值渲染,同时在后台处理新值。当值来自 props 或父组件状态且你无法将更新包装在 startTransition 中时很有用。延迟值以更低优先级更新——如果有紧急更新到来,React 可以中断。经典用例是搜索输入,父组件持有查询,子组件做昂贵过滤。子组件延迟查询 prop,使打字保持流畅。

示例

jsx
import { useDeferredValue, useMemo } from "react";

function FilteredList({ items, query }) {
  const deferredQuery = useDeferredValue(query);
  const filtered = useMemo(
    () => items.filter(i => i.includes(deferredQuery)),
    [items, deferredQuery]
  );
  return <ul>{filtered.map(i => <li key={i}>{i}</li>)}</ul>;
}

function Parent() {
  const [query, setQuery] = useState("");
  return (
    <>
      <input value={query} onChange={e => setQuery(e.target.value)} />
      <FilteredList items={hugeList} query={query} />
    </>
  );
}

输入立即更新。子组件延迟查询 prop,所以计算新结果时继续显示旧结果——打字保持流畅。

常见混淆

  • 容易混淆的对象: useTransition

    关键区别: useDeferredValue 延迟你接收的值(来自 props/state)——你不控制何时开始。useTransition 包装状态 setter——你显式启动转换。接收值用 useDeferredValue,触发更新用 useTransition。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表