我们在开发时,会有突发奇想或者看到好的设计,希望能够模仿,但是会有处于毫无头绪的时候,不知道该如何下手,这就相当于一个考试,给你一个题目叫你作答,但不同于校园考试,他并不是在给定你范围并且复习的情况下进行作答。它是未知的,并不是顺藤摸瓜,总会遇到你所不清楚的内容,我希望能够通过案例顺瓜摸藤进行学习,通过“瓜”来推出是什么“藤”。
这些案例都是现有APP的形式进行推论,因本人能力有限,可能不会是最优方案,如果您有更优方案,欢迎指出并讨论。
该系列的代码全部开源
在github
https://github.com/JinnyWang-Space/HMOS_Space
或者gitee
https://gitee.com/jinnywang/HMOS_Space上均可查看,下载使用
文章也可在个人网站查看
https://www.jinnyspace.online
3. 案例
应用的自定义页签导航(底部页签)
自定义页签导航只是底部页签导航的一种,后续会持续更新其他类型页签导航,以其他APP为案例。
案例分析
1.应用底部的每个页签都对应一个视图,但其中一个页签并没有对应视图,而是呼出一个自定义弹窗。
2. 每个页签视图之间不可通过滑动切换。注意,这个中间按钮并不会重置当前显示的页签视图,而是基于当前视图上显示。
https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-tabs
https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-tabcontent
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-rendering-control-foreach
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-layout-development-stack-layout
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-new-binding
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-builder
https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-promptaction#promptactionopentoast18
https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-expand-safe-area#expandsafearea
// V1 版代码(基础)@Componentexport struct TabsRedBookV1Base {// TabBar 栏名称@State tabsName: string[] = ['首页', '市集', '', '消息', '我'];// 当前页签对应的索引值@State tabSelectedIndex: number = 0;// Tabs 控制器private tabsController: TabsController = new TabsController();// TabBar 栏@BuildertabBuilder() {Row() {// 循环渲染ForEach(this.tabsName, (item: string, index: number) => {Column() {// TabBar标题if (item !== '') {Text(item).width('100%').layoutWeight(1).textAlign(TextAlign.Center)// .fontColor(this.tabSelectedIndex === index ? TabsColor.selectedFontColor : TabsColor.fontColor).fontColor(this.tabSelectedIndex === index ? '#DADADA' : '#6C6C6E').onClick(() => {// 更新页签对应的索引值this.tabSelectedIndex = index;// 控制 Tabs 容器切换到指定页签this.tabsController.changeIndex(index);})}// 中间的添加按钮else {SymbolGlyph($r('sys.symbol.plus')).fontSize(20).fontColor([Color.White]).fontWeight(FontWeight.Bolder).borderRadius(8).padding({top: 8,bottom: 8,left: 12,right: 12})// .backgroundColor(TabsColor.addButtonColor).backgroundColor('#FF2742').onClick(() => {promptAction.openToast({ message: '发布' });})}}.layoutWeight(1).height(44).justifyContent(FlexAlign.Center)}, (item: string) => JSON.stringify(item))}.width('100%')// .backgroundColor(TabsColor.barColor).backgroundColor('#1A191E').position({ bottom: 0 }).zIndex(1)// 拓展安全区.expandSafeArea([SafeAreaType.SYSTEM])}build() {Stack({ alignContent: Alignment.Bottom }) {// TabBar栏this.tabBuilder();// Tab容器Tabs({ barPosition: BarPosition.End, controller: this.tabsController, index: this.tabSelectedIndex!! }) {// 循环渲染ForEach(this.tabsName, (item: string) => {TabContent() {Text(item).fontSize(24).fontColor(Color.White).fontWeight(FontWeight.Bold)}}, (item: string) => JSON.stringify(item))}// 控制页签视图滑动.scrollable(false)// 将 Tabs 组件自带的页签栏设置为0(即不显示),配合自定义导航栏.barHeight(0)}.width('100%').height('100%')}}
// V2 版代码(基础)@ComponentV2export struct TabsRedBookV2Base {// TabBar 栏名称@Local tabsName: string[] = ['首页', '市集', '', '消息', '我'];// 当前页签对应的索引值@Local tabSelectedIndex: number = 0;// Tabs 控制器private tabsController: TabsController = new TabsController();// TabBar 栏@BuildertabBuilder() {Row() {// 循环渲染ForEach(this.tabsName, (item: string, index: number) => {Column() {// TabBar标题if (item !== '') {Text(item).width('100%').layoutWeight(1).textAlign(TextAlign.Center)// .fontColor(this.tabSelectedIndex === index ? TabsColor.selectedFontColor : TabsColor.fontColor).fontColor(this.tabSelectedIndex === index ? '#DADADA' : '#6C6C6E').onClick(() => {// 更新页签对应的索引值this.tabSelectedIndex = index;// 控制 Tabs 容器切换到指定页签this.tabsController.changeIndex(index);})}// 中间的添加按钮else {SymbolGlyph($r('sys.symbol.plus')).fontSize(20).fontColor([Color.White]).fontWeight(FontWeight.Bolder).borderRadius(8).padding({top: 8,bottom: 8,left: 12,right: 12})// .backgroundColor(TabsColor.addButtonColor).backgroundColor('#FF2742').onClick(() => {promptAction.openToast({ message: '发布' });})}}.layoutWeight(1).height(44).justifyContent(FlexAlign.Center)}, (item: string) => JSON.stringify(item))}.width('100%')// .backgroundColor(TabsColor.barColor).backgroundColor('#1A191E').position({ bottom: 0 }).zIndex(1)// 拓展安全区.expandSafeArea([SafeAreaType.SYSTEM])}build() {Stack({ alignContent: Alignment.Bottom }) {// TabBar栏this.tabBuilder();// Tab容器Tabs({ barPosition: BarPosition.End, controller: this.tabsController, index: this.tabSelectedIndex!! }) {// 循环渲染ForEach(this.tabsName, (item: string) => {TabContent() {Text(item).fontSize(24).fontColor(Color.White).fontWeight(FontWeight.Bold)}}, (item: string) => JSON.stringify(item))}// 控制页签视图滑动.scrollable(false)// 将 Tabs 组件自带的页签栏设置为0(即不显示),配合自定义导航栏.barHeight(0)}.width('100%').height('100%')}}
采用 MVVM模式 思想,将其 数据 与 视图 独立出来,降低耦合,在Model层 负责数据结构的定义 ,在ViewModel层 管理UI状态与业务逻辑 ,鸿蒙的装饰器对于这种思想有着天然的优势。
对于页签栏,我们可以发现,其中每个页签其实类型(除了添加按钮)相同,因此我们可以将其封装为类,负责其数据结构定义,这就是Model层。
对于页签栏其中的数据,我们希望单独管理数据,不要在视图层中进行更改,有利于维护以及后续的更改,只改数据,视图就会自动更新,这就是我们为什么要引入ViewModel层。我们封装为类,进行数据管理,在其中可以创建方法来实现我们的目的。
对于刚入门,进阶模式可能会比较抽象,可以先通过 注 里面的提示进行知识补充或者暂时只了解基础版代码,但 注 里面的内容最终是一定要掌握的
如果为入门,需先了解什么是 MVVM模式 ,关于什么是MVVM模式请查看这篇文档:
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-mvvm#mvvm%E6%A8%A1%E5%BC%8F%E4%BB%8B%E7%BB%8D
我们在颜色定义上运用了枚举,对于刚入门,需先了解什么是 枚举类型 ,关于什么是枚举类型请查看文档:
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/introduction-to-arkts#%E7%B1%BB%E5%9E%8B
枚举类型是类型中的一个,需要手动去翻进行查看
如果需要UI占满全屏,因为刚入门开发的人会发现开发时预览图会出现 设备的上部分与下部分会出现空白 ,这就需要引入 拓展安全区 的概念,关于安全区在 4. 知识点中有链接
最重要的,关于状态管理V1与V2版的使用 ,对于还未开发任何应用的人,这里我更倾向于使用V2版本,因为它相比于V1版,更加强大,使用更加方便,也是华为官方更推荐的,对于想了解V1与V2具体差别的查看这篇文档:
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-v1-v2-update-difference
// Tabs组件数据模型export class TabsModel {id: number;title?: string;constructor(id: number, title: string | undefined) {this.id = id;this.title = title;}}
import { TabsModel } from "../model/TabsModel";// Tabs组件数据export class TabsViewModel {private tabsViewModel: TabsModel[] = [new TabsModel(0, '首页'),new TabsModel(1, '市集'),new TabsModel(2, undefined),new TabsModel(3, '消息'),new TabsModel(4, '我')];// 获取数据getTabs(): TabsModel[] {// [...array],防御性编程,防止内部数据被外部修改return [...this.tabsViewModel];}}// Tabs组件中的颜色枚举export enum TabsColor {// TabBar栏背景颜色barColor = '#1A191E',// TabBar栏字体默认颜色fontColor = '#6C6C6E',// TabBar栏选中字体颜色selectedFontColor = '#DADADA',// TabBar栏添加按钮颜色addButtonColor = '#FF2742'}
import { promptAction } from "@kit.ArkUI";import { TabsModel } from "../model/TabsModel";import { TabsColor, TabsViewModel } from "../viewmodel/TabsViewModel";// V1 版代码(进阶)@Componentexport struct TabsRedBookV1High {// 创建 Tabs 容器实例@State tabsVM: TabsModel[] = new TabsViewModel().getTabs();// 当前页签对应的索引值@State tabSelectedIndex: number = 0;// Tabs 控制器private tabsController: TabsController = new TabsController();// TabBar 栏@BuildertabBuilder() {Row() {// 循环渲染ForEach(this.tabsVM, (item: TabsModel) => {Column() {// TabBar标题if (item.title) {Text(item.title).width('100%').layoutWeight(1).textAlign(TextAlign.Center).fontColor(this.tabSelectedIndex === item.id ? TabsColor.selectedFontColor : TabsColor.fontColor).onClick(() => {// 更新页签对应的索引值this.tabSelectedIndex = item.id;// 控制 Tabs 容器切换到指定页签this.tabsController.changeIndex(item.id);})}// 中间的添加按钮else {SymbolGlyph($r('sys.symbol.plus')).fontSize(20).fontColor([Color.White]).fontWeight(FontWeight.Bolder).borderRadius(8).padding({top: 8,bottom: 8,left: 12,right: 12}).backgroundColor(TabsColor.addButtonColor).onClick(() => {promptAction.openToast({ message: '发布' });})}}.layoutWeight(1).height(44).justifyContent(FlexAlign.Center)}, (item: TabsModel) => JSON.stringify(item))}.width('100%').backgroundColor(TabsColor.barColor).position({ bottom: 0 }).zIndex(1)// 拓展安全区.expandSafeArea([SafeAreaType.SYSTEM])}build() {Stack({ alignContent: Alignment.Bottom }) {// TabBar栏this.tabBuilder();// Tab容器Tabs({ barPosition: BarPosition.End, controller: this.tabsController, index: this.tabSelectedIndex!! }) {// 循环渲染ForEach(this.tabsVM, (item: TabsModel) => {TabContent() {Text(item.title).fontSize(24).fontColor(Color.White).fontWeight(FontWeight.Bold)}}, (item: TabsModel) => JSON.stringify(item))}// 控制页签视图滑动.scrollable(false)// 将 Tabs 组件自带的页签栏设置为0(即不显示),配合自定义导航栏.barHeight(0)}.width('100%').height('100%')}}
import { promptAction } from "@kit.ArkUI";import { TabsModel } from "../model/TabsModel";import { TabsColor, TabsViewModel } from "../viewmodel/TabsViewModel";// V2 版代码(进阶)@ComponentV2export struct TabsRedBookV2High {// 创建 Tabs 容器实例@Local tabsVM: TabsModel[] = new TabsViewModel().getTabs();// 当前页签对应的索引值@Local tabSelectedIndex: number = 0;// Tabs 控制器private tabsController: TabsController = new TabsController();// TabBar 栏@BuildertabBuilder() {Row() {// 循环渲染ForEach(this.tabsVM, (item: TabsModel) => {Column() {// TabBar标题if (item.title) {Text(item.title).width('100%').layoutWeight(1).textAlign(TextAlign.Center).fontColor(this.tabSelectedIndex === item.id ? TabsColor.selectedFontColor : TabsColor.fontColor).onClick(() => {// 更新页签对应的索引值this.tabSelectedIndex = item.id;// 控制 Tabs 容器切换到指定页签this.tabsController.changeIndex(item.id);})}// 中间的添加按钮else {SymbolGlyph($r('sys.symbol.plus')).fontSize(20).fontColor([Color.White]).fontWeight(FontWeight.Bolder).borderRadius(8).padding({top: 8,bottom: 8,left: 12,right: 12}).backgroundColor(TabsColor.addButtonColor).onClick(() => {promptAction.openToast({ message: '发布' });})}}.layoutWeight(1).height(44).justifyContent(FlexAlign.Center)}, (item: TabsModel) => JSON.stringify(item))}.width('100%').backgroundColor(TabsColor.barColor).position({ bottom: 0 }).zIndex(1)// 拓展安全区.expandSafeArea([SafeAreaType.SYSTEM])}build() {Stack({ alignContent: Alignment.Bottom }) {// TabBar栏this.tabBuilder();// Tab容器Tabs({ barPosition: BarPosition.End, controller: this.tabsController, index: this.tabSelectedIndex!! }) {// 循环渲染ForEach(this.tabsVM, (item: TabsModel) => {TabContent() {Text(item.title).fontSize(24).fontColor(Color.White).fontWeight(FontWeight.Bold)}}, (item: TabsModel) => JSON.stringify(item))}// 控制页签视图滑动.scrollable(false)// 将 Tabs 组件自带的页签栏设置为0(即不显示),配合自定义导航栏.barHeight(0)}.width('100%').height('100%')}}
🎉 恭喜你!完成鸿蒙开发案例中的应用的自定义页签导航