目录

如何解决Swiper组件未显示页面无法截图的问题

问题现象

通过getComponentSnapshot.get接口识别组件id进行截图时,Swiper第一个页面能正常截图,后续的页面会截图失败。

问题代码示例参考如下:

@Builder
buildPreviewContent() {
  RelativeContainer() {
    Swiper() {
      LazyForEach(this.timeRecordTextPreviewVM.lazyTextList, (item: string, index: number) => {
        this.buildPreviewContentItem(item, index) // 需要截图的组件
      }, (item: TimeTextPictureTemplateModel) => JSON.stringify(item))
    }

    .id('swiperShot')
  }
  .width('100%')
  .height(this.timeRecordTextPreviewVM.imageHeight + 22)
}

// 预览样式内容item
@Builder
buildPreviewContentItem(item: string, index: number) {
  RelativeContainer() {
    Stack() {
      // ...
    }
    .id('containerShot' + index)
  }
  .width('100%')
  .height(this.timeRecordTextPreviewVM.imageHeight)
  .borderRadius(20)
  .backgroundColor('#FFFFFFFF')
}

效果预览

背景知识

解决方案

由于Swiper后续页面未加载渲染,导致componentSnapshot.get方法无法获取到未加载的组件,所以第一个页面截图成功,后续页面截图失败,可以考虑以下两种方案实现Swiper后续页面截图:

常见FAQ

Q:如何解决LazyForEach渲染的List列表,超出屏幕外ListItem截图失败的问题?

A:LazyForEach渲染数据时也是按需加载,未加载的Item无法采用componentSnapshot.get截图,采取的解决方案与Swiper一致,上述两种方案均可实现。

总结

由上述方案及FAQ可知Swiper组件由于本身是按需加载的,与LazyForEach渲染的其它滚动与滑动组件一样,都存在未显示的Item无法截图的问题,都可以采用方案一和方案二解决,其区别如下:

方案

优缺点

方案一

  1. builder中的组件不支持设置动画相关的属性,如transition等。
  2. 部分执行耗时任务的组件可能无法及时在截图前加载完成,因此会截取不到加载成功后的图像。例如:加载网络图片的Image组件、Web组件。

方案二

  1. 只是适用于List、Swiper、Grid等有cachedCount属性的滑动与滚动组件,适用范围较小。
  2. 当需要截图的组件在列表的靠后组件时,由于cachedCount同时预加载过多组件会消耗更多性能。
  3. API15的cachedCount属性支持componentSnapshot.get在动画过程中截图,若截图的组件有动画,该方案可以实现动画属性过程中截图,该优点能保证截图与当前页面截图效果一致。