目录

Tabs预加载的实现方式及常见问题

问题现象

使用Tabs组件承载内容视图时,为了优化页面加载速度、提高用户体验,通常会考虑对子页内容预加载。在实现预加载的过程中,可能会遇到以下问题场景:

背景知识

解决方案

问题场景

问题描述

解决方案

场景一

在aboutToAppear生命周期中使用preloadItems方法预加载TabContent未生效。

确保预加载在Tabs和TabsController绑定后执行,如在onAppear中执行预加载逻辑。

场景二

当TabContent数量较多时,一次性预加载全部TabContent对性能压力大,如何分批加载子节点。

和页签切换事件绑定,切换至某页签时,预加载当前页签的前后N项子页内容。

场景三

使用preloadItems预加载时,tabBar使用@Builder自定义构建导致组件闪烁。

使用BottomTabBarStyle、SubTabBarStyle或ComponentContent替代CustomBuilder实现tabBar。

说明:下述方案中使用的MyComponent代码附在文章末尾。

场景一:在aboutToAppear生命周期中使用preloadItems方法预加载TabContent未生效。

以在onAppear中预加载为例:PreloadOnAppear.ets文件代码如下,@Entry页面需在resources/base/profile/main_pages.json配置,参考pages标签。

import { BusinessError } from '@kit.BasicServicesKit';
import { MyComponent } from './MyComponent';

@Entry
@Component
struct PreloadOnAppear {
  @State currentIndex: number = 1;
  private tabsController: TabsController = new TabsController();
  contentList: string[] = ['飞机', '铁路', '自驾', '地铁'];

  build() {
    Column() {
      Tabs({ index: this.currentIndex, controller: this.tabsController }) {
        ForEach(this.contentList, (item: string, index: number) => {
          TabContent() {
            MyComponent({ info: item });
          }.tabBar(SubTabBarStyle.of(`页签${index}`));
        });
      }
      .onAppear(() => {
        // 预加载第0、2、3个子节点,提高滑动或点击切换至这些节点时的性能
        this.tabsController.preloadItems([0, 2, 3])
          .then(() => {
            console.info('preloadItems success.');
          })
          .catch((error: BusinessError) => {
            console.error(`preloadItems failed, error code: ${error.code}, error message: ${error.message}`);
          });
      })
      .onChange((index: number) => {
        this.currentIndex = index;
      });
    }.width('100%').height('100%');
  }
}

场景二:当TabContent数量较多时,一次性预加载全部TabContent对性能压力大,如何分批加载子节点。

以加载当前页签前后1项子节点为例:PreloadByBatches.ets文件代码如下,@Entry页面需在resources/base/profile/main_pages.json配置,参考pages标签。

import { BusinessError } from '@kit.BasicServicesKit';
import { MyComponent } from './MyComponent';

@Entry
@Component
struct PreloadByBatches {
  @State currentIndex: number = 0;
  private tabsController: TabsController = new TabsController();
  contentList: string[] = ['飞机', '铁路', '自驾', '地铁', '公交', '骑行', '跑步', '轮船'];

  build() {
    Column() {
      Tabs({ index: this.currentIndex, controller: this.tabsController }) {
        ForEach(this.contentList, (item: string, index: number) => {
          TabContent() {
            MyComponent({ info: item });
          }.tabBar(SubTabBarStyle.of(`页签${index}`));
        });
      }
      .barMode(BarMode.Scrollable)
      .onChange((index: number) => {
        this.currentIndex = index;
        let arr: number[] = [];
        if (index > 0) {
          arr.push(index - 1);
        }
        if (index < this.contentList.length - 1) {
          arr.push(index + 1);
        }
        // 预加载当前页签的前一项和后一项,边界页签除外
        this.tabsController.preloadItems(arr)
          .then(() => {
            console.info('preloadItems success.');
          })
          .catch((error: BusinessError) => {
            console.error(`preloadItems failed, error code: ${error.code}, error message: ${error.message}`);
          });
      });
    }.width('100%').height('100%');
  }
}

场景三:使用preloadItems预加载Tabs子节点时,tabBar使用@Builder自定义构建导致组件闪烁。

上述方案使用的MyComponent.ets文件代码如下:

@Component
export struct MyComponent {
  private info: string = '';

  // 预加载组件的aboutToAppear函数会被调用
  aboutToAppear(): void {
    console.info(`aboutToAppear: ${this.info}`);
  }

  aboutToDisappear(): void {
    console.info(`aboutToDisappear: ${this.info}`);
  }

  build() {
    Column() {
      Text(this.info);
    }.justifyContent(FlexAlign.Center)
    .width('100%')
    .height('100%');
  }
}

常见FAQ

Q:Tabs预加载的适用场景?

A:TabContent加载数据较多时,或者有网络请求等,通过预加载可以避免切换卡顿、子页加载缓慢等问题。

Q:在Tabs组件中添加多个TabContent时,节点树中TabBar的子节点数量始终比实际TabContent的数量多两个,但TabContent的数量是正确的。这种现象的原因是什么?

A:当使用ForEach动态生成TabBar时,框架会默认创建2个额外的缓存节点用于预加载优化,额外节点不会影响功能逻辑和性能。

Q:Tabs组件预加载生效之后会调用子组件的aboutToAppear方法吗?

A:被预加载的TabContent中的对应控件的aboutToAppear方法会被调用,可以添加日志来验证。

Q:为什么页面组件在TabContent加载的时候只调用aboutToAppear,不调用onPageShow?

A:onPageShow是@Entry页面的生命周期,Tabs切换触发的是组件级的生命周期aboutToAppear。