VirtualView 🧪

实验性 🧪

此 API 处于实验阶段。 实验性 API 可能包含错误，并且很可能在 React Native 的未来版本中发生变化。请勿在生产环境中使用它们。

VirtualView 是一个核心组件，其行为类似于 View。

当它是 ScrollView 的后代时，它会获得额外的虚拟化能力，以便在被滚动视口遮挡时减少内存占用。

React TSX

<ScrollView>
  <VirtualView>
    <Text>Hello world!</Text>
  </VirtualView>
</ScrollView>

没有祖先 ScrollView 的 VirtualView 不具备任何虚拟化能力。

虚拟化

当 VirtualView 离开 ScrollView 的可见区域时，它会变为隐藏状态。当隐藏时，VirtualView 将缓存其最近的布局，并可能卸载其子组件——这个过程称为虚拟化。

当 VirtualView 返回 ScrollView 的可见区域时，它会变为可见状态。当可见时，其子组件_保证_会被渲染。通过阻塞主线程渲染下一帧（直到其子组件可以渲染为止，该帧才会显示 VirtualView），来维持这一保证。

备注

在未来的开发中，隐藏的 VirtualView 可能会改为在 <Activity mode="hidden"> 中渲染其子组件，以便在平衡内存开销的同时尽可能长时间地保留状态。

阻塞主线程

这是 React Native 功能集中首次出现渲染 React 组件可以阻塞主线程的情况。这是由 新架构 启用的一项新功能！

阻塞主线程可以通过防止使用诸如 FlatList 等组件时有时出现的空白帧闪烁来提供更好的用户体验。它还可以通过使用主线程优先级（通常也在更高性能的核上运行）来实现更好的性能。

然而，阻塞主线程也带来了一些权衡。如果更新操作（例如挂载 VirtualView 的子组件）花费太长时间才能完成，现在可能会导致丢帧。丢帧超过几帧可能会导致用户体验变差，使应用感觉迟钝且无响应。丢帧过多可能会导致操作系统显示一个模态框，指示应用无响应，甚至可能终止你的应用！

注意

DevTools 目前不支持在主线程上调试 JavaScript。这意味着如果你使用断点来调试从 onModeChange 调用的代码（该代码在主线程上执行），你的调试器可能会冻结。

调试所有其他部分的 JavaScript 代码应该按预期工作。我们正在努力在将 VirtualView 发布到 React Native 的稳定渠道之前弥补这一差距。

预渲染

VirtualView 使你能够通过在必需之前更早地渲染来受益于主线程渲染，同时减轻丢帧的缺点。这称为“预渲染”。

默认情况下，每个 VirtualView 将在接近 ScrollView 的可见区域时预渲染其子组件。当这种情况发生时，其子组件将在后台线程上以较低优先级渲染（使用 transition）。这确保主线程和 React 可用于以更高优先级处理其他关键用户交互。

备注

VirtualView 的预渲染逻辑目前不可配置。确定此逻辑的算法正在进行积极的设计迭代，并可能在未来的版本中更改。

---

属性

children

在此 VirtualView 内部渲染的内容。

类型
React Node

---

onModeChange

当 VirtualView 更改其子组件的渲染方式时调用。

如果提供了回调，它可能会根据内部状态更改从不同的线程和优先级调用。可以通过检查事件上的 mode 属性来检测这一点：

• 如果 mode 是 VirtualViewMode.Visible，则回调是从主线程以即时优先级调用的。
• 如果 mode 是 VirtualViewMode.Prerender 或 VirtualViewMode.Hidden，则回调是从后台线程以过渡优先级调用的。

回调永远不会连续使用相同的 mode 值调用。但是，关于事件序列的保证很少。此外，即使子组件成功预渲染，即使它变为可见，回调也可能永远不会使用 VirtualViewMode.Visible 调用。

类型
(ModeChangeEvent) => void

---

nativeID

用于从原生类定位此视图的标识符。

类型
string

---

style

类型
View Style

---

类型定义

ModeChangeEvent

提供给 onModeChange 的参数。

类型
object

属性：

名称	类型	描述
mode	VirtualViewMode	VirtualView 的新模式。
target	element	发出此事件的 VirtualView。
targetRect	Rect	target 相对于最近的祖先 ScrollView 的布局。
thresholdRect	Rect	触发此事件的阈值相对于最近的祖先 ScrollView 的布局。

备注

例如，如果 VirtualView 进入 ScrollView 的可见区域...

• mode 将是 VirtualViewMode.Visible
• thresholdRect 将描述最近的祖先 ScrollView 的可见视口
• targetRect 将是 target 与 thresholdRect 重叠的布局（即它位于 ScrollView 的可见区域内）

VirtualViewMode

VirtualView 的可能模式。

名称	值	描述
Visible	0	目标视图可见。
Prerender	1	目标视图隐藏，但可以预渲染。
Hidden	2	目标视图隐藏。

---

静态方法

createHiddenVirtualView()

React TSX

static createHiddenVirtualView(height: number): typeof VirtualView;

VirtualView 最初将其子组件渲染为可见，即使它最初被祖先 ScrollView 遮挡。这是因为当组件最初渲染时，祖先 ScrollView 的存在——更不用说其大小和滚动位置——是未知的。

对于高级用例，createHiddenVirtualView() 创建一个组件，该组件渲染具有提供的估计布局的初始隐藏 VirtualView。

React TSX

const HiddenVirtualView = createHiddenVirtualView(100);

<ScrollView>
  <HiddenVirtualView>
    <Text>Hello world!</Text>
  </HiddenVirtualView>
</ScrollView>;

参数：

名称	类型	描述
height 必需	number	初始渲染 VirtualView 的估计高度。