目录

如何解决Tabs页签切换时的常见问题

问题现象

在使用Tabs组件时,常见的高频场景是内容视图的切换。但在实际使用中,可能会遇到以下问题:

问题现象效果图如下:

场景一

场景二

场景三

场景四

背景知识

解决方案

场景

方案

场景一

关闭点击TabBar页签时切换TabContent的动画,设置animationMode属性入参为AnimationMode.NO_ANIMATION。

场景二

在onAnimationStart或者onSelected事件中改变控制页签变化的状态变量。

场景三

设置CustomBuilder中根组件的宽高为100%或者在onTabBarClick事件中执行页签切换逻辑。

场景四

在onAnimationStart或者onSelected事件中改变控制页签变化的状态变量。

  1. 场景一:点击TabBar切换页面时,页面会从当前页滑动到目标页,导致中间页面也被提前加载,影响性能与用户体验。
    • 原因:TabContent子组件在UI上初次显示时,会触发aboutToAppear生命周期函数。点击页签的默认动画会导致中间页面在UI上滑过,中间页面若处于初始渲染状态,则会触发其aboutToAppear函数。
    • 解决方案:关闭点击TabBar页签时切换TabContent的动画,设置animationMode属性入参为AnimationMode.NO_ANIMATION。
      @Entry
      @Component
      struct SceneOneSolution {
        private tabsController: TabsController = new TabsController();
      
        build() {
          Column() {
            Tabs({ controller: this.tabsController }) {
              TabContent() {
                MyComponent({ color: '#00CB87' });
              }.tabBar(SubTabBarStyle.of('green'));
      
              TabContent() {
                MyComponent({ color: '#007DFF' });
              }.tabBar(SubTabBarStyle.of('blue'));
      
              TabContent() {
                MyComponent({ color: '#FFBF00' });
              }.tabBar(SubTabBarStyle.of('yellow'));
      
              TabContent() {
                MyComponent({ color: '#E67C92' });
              }.tabBar(SubTabBarStyle.of('pink'));
            }
            .animationMode(AnimationMode.NO_ANIMATION)
            .width('100%')
            .height(296);
          };
        }
      }
      
      @Component
      struct MyComponent {
        private color: string = '';
      
        aboutToAppear(): void {
          console.info(`aboutToAppear backgroundColor: ${this.color}`); // 通过打印日志可以观察到没有加载中间页面
        }
      
        aboutToDisappear(): void {
          console.info(`aboutToDisappear backgroundColor: ${this.color}`);
        }
      
        build() {
          Column() {
            Text(this.color)
              .width('90%')
              .height(200)
              .borderRadius(10)
              .backgroundColor('#F1F3F5')
              .textAlign(TextAlign.Center)
              .fontSize(30);
          };
        }
      }
  2. 场景二:TabBar的高亮状态切换存在延迟,视觉反馈不及时,让用户难以判断当前选中的是哪个页签。
    • 原因:页签的高亮效果通常依赖状态变量的更新来触发。使用自定义页签时,在onChange事件中联动可能会导致滑动页面切换后才执行页签联动,引起自定义页签切换效果延迟。
    • 解决方案:在onAnimationStart或者onSelected事件中改变控制页签变化的状态变量。
  3. 场景三:使用tabBar(CustomBuilder)自定义页签栏时,点击页签文字区域以外的区域(如空白处)无法触发切换,但TabContent却能正常切换,交互不一致。
    • 原因:点击在文字区域时,触发CustomBuilder中根组件的onClick事件,执行了页签高亮切换的逻辑。点击文字旁的空白区域时,触发Tabs组件自带的切换逻辑,切换了内容视图,但由于页签的高亮是通过状态变量控制,此时并未更新状态变量,所以UI现象为页签未切换。
    • 解决方案:设置CustomBuilder中根组件的宽高为100%或者在onTabBarClick事件中执行页签切换逻辑。
      在onTabBarClick事件中执行页签切换逻辑的示例代码如下:
      @Entry
      @Component
      struct SceneThreeSolution2 {
        @State currentIndex: number = 0;
        tabArr: string[] = ['新闻', '国际', '国内', '个人'];
      
        build() {
          Tabs({ index: this.currentIndex }) {
            ForEach(this.tabArr, (item: string, index: number) => {
              TabContent() {
                this.isOnlyShow(item);
              }.tabBar(this.tabBuilder(item, index));
            }, (item: string) => item);
          }
          .onTabBarClick((data: number) => {
            this.currentIndex = data;
          })
          .barPosition(BarPosition.End)
          .animationDuration(0)
          .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.BOTTOM]);
        }
      
        @Builder
        tabBuilder(text: string, index: number): void {
          Column() {
            Text(text)
              .fontSize(20)
              .fontWeight(FontWeight.Medium)
              .fontColor(this.currentIndex === index ? '#0A59F7' : '#161E26')
              .textAlign(TextAlign.Center)
              .height(12);
          }
          .justifyContent(FlexAlign.Start);
        }
      
        @Builder
        isOnlyShow(text: string): void {
          Text(`${text} :仅展示`)
            .fontSize(26)
            .fontWeight(FontWeight.Bold);
        }
      }
  4. 场景四:在自定义页签栏并支持手势滑动切换时,页签的切换动作滞后于内容区域的滑动,造成内容与页签状态不同步,影响视觉一致性。
    • 原因:类似场景二,使用自定义页签时,在onChange事件中改变控制页签栏变化的状态变量,导致状态更新滞后于用户操作,从而出现视觉延迟。
    • 解决方案:参考自定义页签切换联动或Tabs与TabBar同步切换。

常见FAQ

Q:切换至某个TabContent时,如何设置页面中的TextInput默认获焦并拉起软键盘?

A:按以下步骤设置TextInput属性即可。

  1. 设置TextInput的defaultFocus为true。
  2. 设置TextInput的id,如id('input')。
  3. 在TextInput的onAppear事件中通过requestFocus获焦,如this.getUIContext().getFocusController().requestFocus('input')。

Q:点击页签切换,无法在onTabBarClick通过return拦截切换,如何解决?

A:可以参考Tabs如何禁止点击切换,以及禁止滑动内容页切换TabContent。

Q:Tabs组件自滚动效果如何实现?

A:定时器setInterval能实现每隔固定时间重复调用一个函数,可以在函数中通过changeIndex控制Tabs切换到指定页签,实现滚动展示的效果。

Q:TabContent切换后onWillShow,onWillHide回调了两次,如何处理?

A:Tabs组件点击页签后即可切换TabContent并触发对应的onWillShow,onWillHide,在onTabBarClick中使用changeIndex方法后使得TabContent跳转了两次,因而触发了两次onWillShow或onWillHide方法。

Q:TabContent左右切换,页签没有跟随滑动。自定义Tabbar如何和TabContent联动?

A:参考自定义页签切换联动和自定义Tabs样式,TabBar底部指示器如何对齐的实现方式。