解决 Angular CDK 虚拟滚动与 CSS 滚动吸附冲突导致的闪烁问题

理解问题根源

angular cdk 的虚拟滚动（cdk-virtual-scroll）通过仅渲染可见区域及其附近少量元素来优化大量列表的性能。它依赖于 itemsize 属性来精确计算每个元素的高度和位置，从而决定何时加载和卸载元素。

与此同时，CSS 的 scroll-snap-type 属性用于创建平滑的滚动吸附效果，它会强制滚动容器在滚动结束时“吸附”到特定子元素的起始或结束位置。

当这两个特性结合使用时，如果 cdk-virtual-scroll 的 itemSize 属性所定义的高度与实际通过 CSS 渲染的元素高度不一致（例如，CSS 使用 100vh 这样的相对单位，而 itemSize 是一个固定像素值），就会产生冲突。虚拟滚动器会根据其内部的 itemSize 进行布局计算，但浏览器实际渲染的元素却有着不同的高度。这种不匹配会导致以下问题：

1. 布局计算错误： 虚拟滚动器认为元素占据的空间与实际不同，导致滚动位置的计算偏差。
2. 内容错位： 在滚动过程中，由于计算错误，虚拟滚动器可能会过早或过晚地加载/卸载元素，造成视觉上的跳动或闪烁。
3. 滚动吸附冲突： scroll-snap-type 尝试将滚动位置强制吸附到实际元素的位置，而虚拟滚动器则基于其内部计算来调整内容，两者之间的拉扯进一步加剧了闪烁。

解决方案：精确的尺寸定义

解决此问题的关键在于确保虚拟滚动器所依赖的 itemSize 属性与实际渲染的元素高度完全一致，并且推荐使用固定像素值来消除不确定性。

1. HTML 结构调整

在 cdk-virtual-scroll-viewport 标签中，除了设置 itemSize，还可以调整 minBufferPx 和 maxBufferPx 来优化滚动体验。

立即学习“前端免费学习笔记（深入）”；

<cdk-virtual-scroll-viewport
  itemSize="500"          <!-- 关键：确保与CSS中.example-item的高度一致 -->
  class="example-viewport"
  minBufferPx="1000"      <!-- 最小预加载缓冲区（向上滚动时） -->
  maxBufferPx="5000"      <!-- 最大预加载缓冲区（向下滚动时） -->
>
  <div *cdkVirtualFor="let item of ds" class="example-item">
    <div class="info">{{item}}</div>
    <img
      src="https://images.pexels.com/photos/7913028/pexels-photo-7913028.jpeg?auto=compress&cs=tinysrgb&w=1600&lazy=load"
      alt="Girl in a jacket"
    />
  </div>
</cdk-virtual-scroll-viewport>

说明：

百度虚拟主播

百度智能云平台的一站式、灵活化的虚拟主播直播解决方案

36

查看详情

• itemSize="500": 这是最关键的改动。它明确告诉虚拟滚动器每个项目的高度是 500 像素。这个值必须与 CSS 中 .example-item 的实际高度严格匹配。
• minBufferPx 和 maxBufferPx: 这些属性定义了在当前可见区域之外预渲染和保留的元素数量（以像素为单位）。适当调整它们可以减少滚动时的空白区域或内容突然出现的情况，从而提供更流畅的感知。minBufferPx 适用于向上滚动，maxBufferPx 适用于向下滚动。

2. CSS 样式优化

为了确保 itemSize 的准确性，需要将 cdk-virtual-scroll-viewport 容器及其子项 (.example-item) 的高度设置为固定的像素值，而不是使用 vh（视口高度百分比）等响应式单位，因为 vh 可能会在不同设备或窗口大小下导致实际高度变化。

.example-viewport {
  overflow-y: scroll;
  scroll-snap-type: y mandatory; /* 保持滚动吸附特性 */
  width: 100%;
  height: 500px; /* 关键：固定容器高度，与itemSize保持一致 */
}

.example-item {
  height: 500px; /* 关键：固定项目高度，与itemSize保持一致 */
  scroll-snap-align: start; /* 保持滚动吸附对齐方式 */
  margin: 0 !important;
  padding: 0 10px !important;
  position: relative;
}

/* 其他辅助样式，确保图片和信息块在固定高度内正常显示 */
.info {
  position: absolute;
  top: 10px;
  left: 10px;
  display: flex;
  align-items: center;
  justify-content: flex-start;
  background-color: #0000008a;
  height: 25px;
  border-radius: 50px;
  padding: 0 10px;
  width: -webkit-fit-content;
  width: -moz-fit-content;
  width: fit-content;
  margin: 0 0 0 12px;
}

img {
  height: 500px; /* 确保图片填充项目高度 */
  -o-object-fit: cover;
  object-fit: cover;
  -o-object-position: center center;
  object-position: center center;
}

说明：

• .example-viewport 的 height: 500px: 将虚拟滚动容器的高度设置为固定值。
• .example-item 的 height: 500px: 将每个虚拟化项目的高度设置为固定值。这个值必须与 cdk-virtual-scroll-viewport 的 itemSize 属性值完全一致。
• scroll-snap-type: y mandatory; 和 scroll-snap-align: start; 保持不变，因为它们是实现滚动吸附效果的关键。

通过这些调整，cdk-virtual-scroll 将基于 500px 的 itemSize 进行精确计算，而浏览器也会将每个项目渲染为 500px 高。这种一致性消除了布局计算的误差，从而解决了闪烁问题，并使 scroll-snap-type 能够无缝地工作。

注意事项

• 响应式设计挑战： 如果您的设计要求虚拟化项目的高度必须是响应式的（例如，根据视口大小动态调整），那么直接使用 cdk-virtual-scroll 结合 scroll-snap-type 可能会变得复杂。在这种情况下，您可能需要：
  • 在运行时动态计算并更新 itemSize，但这会增加复杂性。
  • 重新考虑是否必须同时使用这两个特性，或者寻找替代方案。
  • 对于大多数滚动吸附场景，固定高度的项目通常是更简单且推荐的做法。
• 内容溢出： 确保您的项目内容在设定的固定高度内能够良好显示，避免内容溢出或被截断。
• 性能优化： minBufferPx 和 maxBufferPx 的值需要根据实际应用场景进行调整。过小可能导致滚动不流畅，过大则可能预渲染过多元素，增加内存消耗。

总结

当 Angular CDK 虚拟滚动与 CSS scroll-snap-type 结合使用时出现闪烁，其根本原因在于虚拟滚动器的 itemSize 属性与实际渲染的元素高度不一致。通过为 cdk-virtual-scroll-viewport 容器及其内部项目定义精确的固定像素高度，并确保 itemSize 与项目实际高度严格匹配，可以有效解决这一问题。这种方法保证了虚拟滚动器内部计算的准确性，从而实现流畅、无闪烁的虚拟化滚动体验。

以上就是解决 Angular CDK 虚拟滚动与 CSS 滚动吸附冲突导致的闪烁问题的详细内容，更多请关注php中文网其它相关文章！