鸿蒙应用开发从入门到入行 - 篇8:Tabs选项卡页签视图切换

简介: 在本篇文章里,您将掌握使用Tabs选项卡做栏目分类,这是未来应用开发中极为常用的组件

Tabs介绍

  • 你是否经常在移动端应用里见到如下菜单分类,例如下面两图

    image-20241206085145419

    image-20241206085448043

  • 像这样的不管是在上,还是在下的菜单分栏功能,在HarmonyOS应用开发中都是可以使用Tabs组件实现

  • 每当某个Tabs里的菜单切换后,页面内容也会跟着改变,如下图

    gif

  • 也即:Tabs组件可以在一个页面内快速实现视图内容的切换

  • 具体怎样使用呢?我们接着往下看

Tabs - 组件基本使用

  • 首先,Tabs里面只能放 TabContent子组件(放其他组件会报错),有多少个TabContent,就意味着有多少个切换视图。

gif

  • 如上图所示,这段代码里Tabs放了三个TabContent,因此有三个视图进行切换。但此时仅能实现左滑才能切换,根本没有显示出“导航栏”,所以一般情况下还会给TabContent设置tabBar属性,用来设置对应的导航栏

  • 如下代码,给每个TabContent都设置了tabBar属性

    
    
    struct Index {
         
      build() {
         
        Tabs() {
         
          TabContent() {
         
            Text('1')
          }.tabBar('首页')
    
          TabContent() {
         
            Text('2')
          }.tabBar('联系人')
    
          TabContent() {
         
            Text('3')
          }.tabBar('我的')
        }
      }
    }
    
  • 此时效果如下

    image-20241206092240968

  • 小结:

    1. Tabs里只能放TabContent
    2. TabContent有多少个就意味着有多少个视图切换
    3. TabContent配合tabBar属性,即可设置导航栏标题,tabBar传入字符串,字符串是什么,标题即为什么

修改导航栏位置到底部

  • 默认情况下,导航栏在页面上方,如果想把导航栏设置到页面底部显示,可以通过给Tabs传入参数barPosition来实现

  • 代码如下:

    Tabs({
          barPosition: BarPosition.End }) {
         
    
      // .... 省略里面的TabContent代码
    }
    
  • 此时界面效果如下图

    image-20241206093101358

  • 如上代码所示:barPosition参数,需要传入BarPosition的枚举,这个枚举仅有两个值:Start与End,默认即为Start,代表在顶部,设置为End即为底部

修改导航栏位置到侧边

  • 那么是不是只有顶部、底部两种位置呢?其实不然,还可以设置左侧或右侧,这里需要用到Tabs的一个属性,即为:vertical

  • 这个属性代表:是否垂直摆放导航栏,那换句话说即为是否竖着放(也即侧边放),默认为false即水平摆放。

  • 我们试着把这个属性改为true,如下代码

    Tabs({
          barPosition: BarPosition.Start }) {
         
        // 省略里面的TabContent代码
      }
      .vertical(true)
      .barWidth(80)
      .barBackgroundColor('#f00')
    
  • 效果如下图

    image-20241206093927822

  • 代码解释:

    • 因为vertical属性设置为true,必然是在侧边摆放导航栏,但为什么是左边呢?因为Tabs的barPosition参数设置为Start(默认值),即为在左侧,所以如果barPosition设置为BarPosition.End,即为在右侧。
    • barWidth是设置导航条的宽度(侧边方向是设置宽度)或高度(上下方向是设置高度)
    • barBackgroundColor是设置导航条背景颜色,这里加背景色主要是为了让大家能看到我们设置的宽度生效了
  • 小结:
    • 如果Tabs不设置vertical或者vertical设置为false,导航栏方向都是上下摆放,至于是上还是下跟barPosition有关,Start为上,End为下
    • 如果Tabs设置了vertical为true,导航栏方向都是侧边摆放,至于是左还是右跟barPosition有关,Start为左,End为右

Tabs嵌套使用

  • 很多时候我们的App应用场景其实需要顶部、底部都有导航栏,即整个App分为“首页”、“发现”、“推荐”
    、“我的”四个部分,但是在“首页”里,又分为:关注、视频、游戏、数码、科技四个板块,如下图所示

    img

  • 这时候就需要嵌套导航栏(在首页这个视图里再套一个Tabs),代码如下

    Tabs({
          barPosition: BarPosition.End }) {
         
        TabContent() {
         
          // 在首页这个视图里,又分为关注、视频、游戏、数码、科技四个切换分类
          Tabs() {
         
            TabContent() {
         
              Text('关注的内容')
            }.tabBar('关注')
    
            TabContent() {
         
              Text('视频的内容')
            }.tabBar('视频')
    
            TabContent() {
         
              Text('游戏的内容')
            }.tabBar('游戏')
    
            TabContent() {
         
              Text('数码的内容')
            }.tabBar('数码')
    
            TabContent() {
         
              Text('科技的内容')
            }.tabBar('科技')
          }
        }.tabBar('首页')
    
        TabContent() {
         
          Text('发现的内容')
        }.tabBar('发现')
    
        TabContent() {
         
          Text('推荐的内容')
        }.tabBar('推荐')
    
        TabContent() {
         
          Text('我的内容')
        }.tabBar('我的')
    }
    

限制导航栏滚动

  • 默认情况下所有的Tabs的导航都具备滚动的功能,但是当我们使用Tabs嵌套时,如上面的场景,会发现底部的导航栏有滚动,首页里嵌套的导航栏也有滚动。为了避免他们冲突,一般我们会让底部的大导航栏禁止滚动。

  • 如何禁止滚动呢?

    • 使用scrollable属性,设置为false即可
  • Tabs({
          barPosition: BarPosition.End }) {
         
        TabContent() {
         
          // 在首页这个视图里,又分为关注、视频、游戏、数码、科技四个切换分类
          Tabs() {
         
            // 省略这个嵌套的代码
          }
        }.tabBar('首页')
    
        TabContent() {
         
          Text('发现的内容')
        }.tabBar('发现')
    
        TabContent() {
         
          Text('推荐的内容')
        }.tabBar('推荐')
    
        TabContent() {
         
          Text('我的内容')
        }.tabBar('我的')
    }
    .scrollable(false)
    

自定义导航栏

  • 我们很多应用的底部导航栏,其实一般除了标题文字外,还会附带图标,例如下图

    img

  • 这时候需要我们使用@Builder装饰器自定义导航栏的布局后,再传递给tabBar

  • 如下代码

    tabBuilder(title: string, icon: ResourceStr) {
         
        Column({
          space: 2 }) {
         
          Image(icon)
            .width(30)
          Text(title)
        }
        .width('100%')
        .height(50)
        .justifyContent(FlexAlign.Center)
    }
    
    • 这个Builder声明一个垂直布局的UI,上为图标,下为文字(标题),但此时这个Builder跟每个tabBar还没有任何关联,因此需要做调用绑定
  • 代码如下

    Tabs({
          barPosition: BarPosition.End }) {
         
        TabContent() {
         
          // ...
        }.tabBar(this.tabBuilder('首页', $r('app.media.ic_public_home')))
    
        TabContent() {
         
          // ...
        }.tabBar(this.tabBuilder('信息', $r('app.media.ic_public_comments')))
    
        TabContent() {
         
          // ...
        }.tabBar(this.tabBuilder('相册', $r('app.media.ic_public_albums')))
    
        TabContent() {
         
          // ...
        }.tabBar(this.tabBuilder('我的', $r('app.media.ic_public_contacts')))
    }
    
  • 此时得到效果如下图

    image-20241206101841435

  • 我们会发现,不管点击哪一个,都不会有高亮效果。这是因为使用自定义导航栏后,需要自行在Builder里根据当前选中下标来判断显示不同的图标和颜色

  • 综上所述,我们应该先声明一个状态变量,记录当前选中的索引

    @State currentIndex: number = 0 // 默认为0,代表默认让第一个导航高亮
    
  • 修改Builder,代码如下

    
    tabBuilder(title: string, icon: ResourceStr, selectIcon: ResourceStr, index: number) {
         
      Column({
          space: 2 }) {
         
        Image(this.currentIndex === index ? selectIcon : icon)
          .width(30)
          .fillColor(this.currentIndex === index ? '#0094ff' : '#000')
        Text(title)
          .fontColor(this.currentIndex === index ? '#0094ff' : '#000')
      }
      .width('100%')
      .height(50)
      .justifyContent(FlexAlign.Center)
    }
    
  • 代码解释:

    • 首先参数上新增了selectIcon与index,分别代表选中时要显示的图片,以及当前的tabBar自身索引
    • 代码内根据我们记录的导航索引,与传入的当前tabBar自身索引做比较。相等就意味着当前tabBar被选中,所以让其使用选中的图片,以及设置选中的颜色。否则用默认的图片与颜色
  • 效果如下

    image-20241206102612263

切换指定页签

  • 此时我们发现,之前在不使用自定义导航栏时,默认的Tabs会实现切换逻辑,也即点谁谁高亮。但使用自定义导航栏后,发现点击导航栏没有切换高亮效果。

  • 原因:自定义导航栏是根据我们的自定义Builder来决定显示状态的,如果需要高亮随之改变,就需要把我们声明的记录索引的状态变量进行修改,也即上面声明的currentIndex。此时因为currentIndex一直是0,所以一直是第一个首页高亮。因此,我们需要页签改变时让currentIndex的值也跟着改变

  • 这是需要用到Tabs提供的onChange事件,监听索引变化,并将当前切换后的索引值赋值给currentIndex,代码如下

    Tabs({
          barPosition: BarPosition.End }) {
         
        // 省略中间代码
      }
      .onChange(index => {
         
        this.currentIndex = index
      })
    
  • 以上利用onChange可以实现以外,其实在Next加入$$双向绑定后也能实现,做法是,只要将currentIndex与Tabs的index参数做双向绑定即可实现,代码如下 ```dart Tabs({ barPosition: BarPosition.End, index: $$this.currentIndex }) {
    // 省略里面内容
    }
    ```

  • 使用双向绑定还有个好处是:如果将来需要用代码改变页签,只需要改currentIndex的值即可,例如:this.currentIndex = 2即会切换到页签索引为2的导航

总结

  • 今日主要讲解了Tabs的使用,Tabs是一种视图切换的组件。

  • 默认情况下,Tabs是在顶部显示,如果要改位置可以通过barPosition参数来修改

  • 如果需要展示在侧边,可以通过 vertical 属性设置为true来实现

  • 如果需要带图带标题的自定义导航栏,可以用@Builder进行封装并传入tabBar

课后练习

  • 判断题
    • 当设置vertical为true时,导航栏在右侧显示
    • 当Tabs的barPosition为End,vertical为false时,导航栏在右侧显示
  • 简单题
    • 请回答,直接设置Tabs的vertical为true,导航栏在哪显示?

预告:下一篇内容

  • 下一篇将做个鸿蒙官网的经典案例:新闻数据,即本页一开始的图如下,敬请期待

image-20241206085145419

相关文章
|
3天前
|
安全 数据安全/隐私保护 UED
HarmonyOS 5.0 (Next)应用开发实战:使用ArkTS构建开箱即用的登录页面【HarmonyOS 5.0(Next)】
### HarmonyOS 5.0(Next)应用开发实战:使用ArkTS构建开箱即用的登录页面 HarmonyOS 5.0(Next)融合了美学与科技,引入“光感美学”设计理念和多设备深度协同功能。本文通过 ArkTS 构建一个简单的登录页面,展示了模块化导入、状态管理、方法封装、声明式UI构建及事件处理等最佳实践。代码实现了一个包含用户名和密码输入框及登录按钮的界面,支持错误提示和页面跳转。
35 14
HarmonyOS 5.0 (Next)应用开发实战:使用ArkTS构建开箱即用的登录页面【HarmonyOS 5.0(Next)】
|
2天前
|
JavaScript 容器
鸿蒙应用开发从入门到入行 - 篇6:数据监听器、滚动、侧滑功能
在本篇文章里,您将掌握监听器、滚动、侧滑等相关内容,助力你开发出更具交互的案例。
22 9
鸿蒙应用开发从入门到入行 - 篇6:数据监听器、滚动、侧滑功能
|
3天前
|
自然语言处理 搜索推荐 数据安全/隐私保护
鸿蒙登录页面好看的样式设计-HarmonyOS应用开发实战与ArkTS代码解析【HarmonyOS 5.0(Next)】
鸿蒙登录页面设计展示了 HarmonyOS 5.0(Next)的未来美学理念,结合科技与艺术,为用户带来视觉盛宴。该页面使用 ArkTS 开发,支持个性化定制和无缝智能设备连接。代码解析涵盖了声明式 UI、状态管理、事件处理及路由导航等关键概念,帮助开发者快速上手 HarmonyOS 应用开发。通过这段代码,开发者可以了解如何构建交互式界面并实现跨设备协同工作,推动智能生态的发展。
27 10
鸿蒙登录页面好看的样式设计-HarmonyOS应用开发实战与ArkTS代码解析【HarmonyOS 5.0(Next)】
|
2天前
|
JavaScript Java 容器
鸿蒙应用开发从入门到入行 - 篇4:层叠布局、自定义组件、ForEach
导读:在本篇文章里,您将掌握层叠布局、自定义组件的用法,特别是自定义组件将来的开发中必然会用,其中应该特别关注自定义组件的一些规范与装饰器。
21 7
鸿蒙应用开发从入门到入行 - 篇4:层叠布局、自定义组件、ForEach
|
2天前
|
人工智能 小程序 Android开发
鸿蒙应用开发从入门到入行 - 篇1:HarmonyOS介绍——带你深入理解鸿蒙特性
本文介绍了华为的HarmonyOS(鸿蒙系统),这是一个面向全场景的分布式操作系统,不仅适用于手机和平板,还支持电脑、车机、手表、电视等多种设备。文章详细解析了鸿蒙系统的三大特性:一次开发多端部署、可分可合自由流转、统一生态原生智能,并分析了鸿蒙系统为何能蚕食安卓市场份额的原因。猫林老师认为,鸿蒙凭借其先进的技术和国内政策支持,有望在未来的市场中占据重要地位。最后,文章提供了学习鸿蒙系统的建议和一些课后练习,帮助读者更好地理解和掌握这一系统。
28 7
鸿蒙应用开发从入门到入行 - 篇1:HarmonyOS介绍——带你深入理解鸿蒙特性
|
2天前
|
JSON Dart 前端开发
鸿蒙应用开发从入门到入行 - 篇7:http网络请求
在本篇文章里,您将掌握鸿蒙开发工具DevEco的基本使用、ArkUI里的基础组件,并通过制作一个简单界面掌握使用
21 8
|
存储 XML JSON
HarmonyOS(鸿蒙)——全面入门,始于而不止于HelloWorld
HarmonyOS(鸿蒙)——全面入门,始于而不止于HelloWorld
335 0
HarmonyOS(鸿蒙)——全面入门,始于而不止于HelloWorld
|
1天前
|
安全 数据安全/隐私保护
鸿蒙开发:一文了解软键盘相关
软键盘最主要的就是合理的进行避让,不能遮挡可输入组件,再有多个输入框的时候,需要动态的进行设置高度,这一点需要注意。
鸿蒙开发:一文了解软键盘相关
|
1天前
【HarmonyOS Next开发】:ListItemGroup使用
通过使用ListItemGroup和AlphabetIndexer两种类型组件,实现带标题分类和右侧导航栏的页面
80 61

热门文章

最新文章