跳到主要内容
版本:Next

🗑️ InteractionManager

已弃用

请避免长时间运行的工作,并改用 requestIdleCallback

InteractionManager 允许在任何交互/动画完成后调度长时间运行的工作。特别是,这使 JavaScript 动画能够平滑运行。

应用可以使用以下方式调度在交互结束后运行的任务:

React TSX
InteractionManager.runAfterInteractions(() => {
// ...长时间运行的同步任务...
});

将其与其他调度替代方案进行比较:

  • requestAnimationFrame() 用于随时间为视图添加动画的代码。
  • setImmediate/setTimeout() 会稍后运行代码,注意这可能会延迟动画。
  • runAfterInteractions() 会稍后运行代码,不会延迟正在进行的动画。

触摸处理系统会将一个或多个活动触摸视为一次“交互”,并会将 runAfterInteractions() 回调延迟到所有触摸都结束或被取消之后。

InteractionManager 还允许应用在动画开始时创建一个交互“句柄”来注册动画,并在动画完成后清除它:

React TSX
const handle = InteractionManager.createInteractionHandle();
// 运行动画...(`runAfterInteractions` 任务会被排队)
// 之后,在动画完成时:
InteractionManager.clearInteractionHandle(handle);
// 如果所有句柄都已清除,排队的任务就会运行

runAfterInteractions 接受普通回调函数,或者接受一个带有 gen 方法的 PromiseTask 对象,该方法返回一个 Promise。如果提供了 PromiseTask,那么在开始处理下一个可能更早已同步排队的任务之前,它会被完全解析(包括同样会通过 runAfterInteractions 再调度更多任务的异步依赖)。

默认情况下,排队任务会在一个 setImmediate 批次中循环一起执行。如果调用 setDeadline 并传入一个正数,那么任务只会执行到接近截止时间(按 js 事件循环运行时间计算)为止,此时执行会通过 setTimeout 让出控制权,从而允许诸如触摸之类的事件开始交互并阻止排队任务继续执行,使应用更具响应性。


示例

基础

高级

参考

方法

runAfterInteractions()

React TSX
static runAfterInteractions(task?: (() => any) | SimpleTask | PromiseTask);

安排一个函数在所有交互完成后运行。返回一个可取消的“promise”。


createInteractionHandle()

React TSX
static createInteractionHandle(): Handle;

通知管理器一个交互已经开始。


clearInteractionHandle()

React TSX
static clearInteractionHandle(handle: Handle);

通知管理器一个交互已经完成。


setDeadline()

React TSX
static setDeadline(deadline: number);

正数将使用 setTimeout 来安排任何任务,在 eventLoopRunningTime 达到截止值后执行;否则,所有任务都会在一个 setImmediate 批次中执行(默认)。