startTransition

startTransition(action)

• 参考
  • startTransition(action)
• 使用方法
  • 将 state 更新标记为非阻塞 Transition

参考

startTransition(action)

startTransition 函数可以将 state 更新标记为 transition。

import { startTransition } from 'react';

function TabContainer() {
  const [tab, setTab] = useState('about');

  function selectTab(nextTab) {
    startTransition(() => {
      setTab(nextTab);
    });
  }
  // ...
}

请看下面的更多例子。

参数

• action:调用一个或多个 set 函数来更新 state 的函数。React 会立即调用没有参数的 action，并将在 action 函数调用期间，调度所有的 state，并将同步更新标记为 transition。任何在 action 中等待的异步调用都将包含在 transition 中，但是目前需要将 await 之后的任何 set 函数包装在 startTransition 中 (查看 故障排除 了解更多)。被标记为 Transitions 的状态更新是 非阻塞的，并且 不会显示不想要的加载提示。

返回值

startTransition 不返回任何内容。

注意事项

• startTransition 没有提供一种跟踪 Transition 是否处于待定状态的方法。为了在 Transition 进行时显示一个待定状态的指示器，你需要使用 useTransition。

• 只有当你能访问某个 state 的 set 函数时，你才能将它的更新包裹到 Transition 中。如果你想根据 props 或自定义 Hook 的返回值来启动一个 transition，请尝试使用 useDeferredValue。

• 你传递给 startTransition 的函数会立即被调用，并将其执行时发生的所有状态更新标记为 Transitions。如果你试图在 setTimeout 中进行状态更新，它们将不会被标记为 Transitions。

• You must wrap any state updates after any async requests in another startTransition to mark them as Transitions. This is a known limitation that we will fix in the future (see Troubleshooting).

• 一个被标记为 Transition 的 state 更新时将会被其他 state 更新打断。例如，如果你在 Transition 内部更新图表组件，但在图表重新渲染时在输入框中打字，则 React 将先处理输入 state 更新，之后才会重新启动对图表组件的渲染工作。

• Transition 更新不能用于控制文本输入。

• 如果有多个正在进行的 transition，目前 React 会将它们集中在一起处理。这是一个限制，在未来的版本中可能会被移除。

使用方法

将 state 更新标记为非阻塞 Transition

你可以通过将一个 state 包裹在 startTransition 回调中，将其更新标记为一个 transition：

import { startTransition } from 'react';

function TabContainer() {
  const [tab, setTab] = useState('about');

  function selectTab(nextTab) {
    startTransition(() => {
      setTab(nextTab);
    });
  }
  // ...
}

transition 可以让用户界面在慢速设备上保持更新响应。

通过 transition，你的 UI 在重新渲染过程中保持响应。例如，如果用户单击一个选项卡后又改变主意并单击另一个选项卡，则可以在第一次重新渲染完成之前执行此操作而无需等待。