Lzh on GitHub

VirtualItem 对象代表了虚拟器返回的单个项目。它包含了你在虚拟器滚动元素坐标空间内渲染项目所需的信息,以及其他有用的属性/函数。

export interface VirtualItem {
  key: string | number | bigint
  index: number
  start: number
  end: number
  size: number
}

每个 VirtualItem 对象都具备以下属性和方法:

key

key: string | number | bigint

项目的唯一键。默认情况下,这是项目的索引,但应该通过 getItemKey 虚拟器选项进行配置。

index

index: number

项目的索引。

start

start: number

项目的起始像素偏移量。这通常映射到 CSS 属性或 transform,例如 top/lefttranslateX/translateY

end

end: number

项目的结束像素偏移量。这个值对于大多数布局来说并非必需,但我们仍然提供了它,以备不时之需。

size

size: number

项目的尺寸。这通常映射到 CSS 属性,例如 width/height。在使用 VirtualItem.measureElement 方法测量项目之前,这将是 estimateSize 虚拟器选项返回的估计尺寸。在测量项目之后(如果你选择测量),这个值将是你的 measureElement 虚拟器选项返回的数字(默认配置为使用 getBoundingClientRect() 测量元素)。

lane

lane: number

项目的车道索引。在常规列表中,它将始终设置为 0,但在瀑布流布局中会变得很有用(详情请参阅变量示例)。