HarmonyOS 多设备短视频开发 : 16 — Tabs 组件与 MSVTabs 封装
16 — Tabs 组件与 MSVTabs 封装一、引言短视频应用的核心交互是多页签切换首页、朋友、发布、消息、我的。HarmonyOS 提供 Tabs/TabContent 组件承载这一能力但若每个页面各自维护一套 TabBar 样式必然导致视觉漂移与维护成本上升。本项目在 common 层封装了 MSVTabs 公共组件统一手机端底部页签与首页次级页签的样式交互同时为 TV 智慧屏单独实现 TvTabs。本文结合common/multishortvideobase/src/main/ets/components/MSVTabs.ets、products/tv/src/main/ets/components/TvTabs.ets讲解封装思路与多设备差异化。二、Tabs/TabContent 基础用法Tabs 由页签栏 内容区组成TabContent 承载页面内容通过 tabBar 属性自定义页签 UITabs({ index: this.activeIndex }) { TabContent() { HomePage() }.tabBar(this.MyTabBar(0)) TabContent() { MinePage() }.tabBar(this.MyTabBar(1)) } .barPosition(BarPosition.End) // 页签位于底部 .barOverlap(true) // 页签悬浮于内容之上 .onChange((index: number) { this.activeIndex index; })常用属性barPosition 控制页签栏位置本项目底部 End / 顶部 Start、barOverlap 控制页签是否悬浮true、barMode 控制 Fixed/ScrollableBarMode.Scrollable、barHeight 控制高度56vp。三、MSVTabs 公共组件封装MSVTabs 以数据驱动页签配置收敛在 MSVDataModel内容 Builder、文本、图标、是否仅图标export class MSVDataModel { public content?: BuilderCallback | null; // 页签内容 public text?: ResourceStr; // 页签文字 public iconOnly?: boolean; // 是否纯图标 public icon?: Resource; public iconDark?: Resource; // 深色图标 public iconSize?: Length; }组件对外参数MSVTabs.etsComponentV2 export struct MSVTabs { Require Param data: MSVDataModel[]; // 必传 Local activeIndex: number 0; // 内部选中态 Param useFloating: boolean true; // 悬浮 TabBar Param index: number 0; // 初始索引 Param showBarUnderline: boolean false; // 选中下划线 Param barPosition: BarPosition BarPosition.Start; Param onIndexChange: (index: number) void () {}; aboutToAppear(): void { this.activeIndex this.index; } }Require Param强制调用方传 dataLocal activeIndex内部维护选中态onIndexChange 把切换事件抛给外部如切到我的时切换深浅色。四、自定义 TabBar 构建MSVTabs 用 Builder 定义页签样式区分纯图标与图标文字支持选中下划线Builder MSVTabBar(params: MSVDataModel, currentIndex: number) { if (params.iconOnly) { Image(this.isDark ? params.iconDark : params.icon) .width(params.iconSize).aspectRatio(1) } else { Column() { Text(params.text) .fontColor(this.activeIndex currentIndex ? this.selectedLightColor : this.lightColor) } .border({ width: { bottom: this.showBarUnderline (this.activeIndex currentIndex) ? 1 : 0 } }) } }MainTabsViewModel中发布页签即纯图标形态加号this.mainTabsData.push(new MSVDataModel(home, $r(app.string.home_title))); this.mainTabsData.push(new MSVDataModel(add, , true, $r(app.media.ic_plus), $r(app.media.ic_plus_dark)));其余朋友、消息、我的为图文形态仅传文本与内容 Builder。五、HdsTabs 悬浮页签与降级策略大屏启用系统 HDS 悬浮页签小屏或不支持时降级为原生 Tabs用 canIUse 能力探测 useFloating 开关双轨控制if (canIUse(SystemCapability.UIDesign.HDSComponent.Core) this.useFloating) { HdsTabs({ index: this.activeIndex }) { this.MSVTabContent(this.data) } .barPosition(BarPosition.End) .barFloatingStyle({ barSideMargin: 16, barBottomMargin: this.barBottomMargin, ... }) .barHeight(44) } else { Tabs({ index: this.activeIndex }) { this.MSVTabContent(this.data) } .barPosition(this.barPosition) .barBackgroundBlurStyle(BlurStyle.NONE) .barHeight(56).barMode(BarMode.Scrollable, { margin: 8 }) }首页次级页签 SubTabsSubTabsComponent.ets关闭悬浮并开启下划线useFloating: false, index: 4, showBarUnderline: true数据来自 SubTabsViewModel商城、直播、关注、推荐等。六、TV 端 TvTabs 差异化TV 端无触摸TvTabs 用横向 List 构建页签选中态由全局 currentBottomIndex 驱动天然支持遥控器聚焦ComponentV2 export struct TVTabs { Consumer(currentBottomIndex) currentBottomIndex: number 2; Local btnList: ArrayResource [推荐, 关注, 朋友, 加号, 消息, 我的]; // 横向 List 渲染当前项高亮背景与文字色 }与 MSVTabs 的差异对比如下维度MSVTabs手机/平板TvTabs智慧屏容器Tabs / HdsTabs横向 List位置底部悬浮或顶部顶部居中胶囊交互点击、滑动遥控器方向键 点击状态Param LocalConsumer 全局索引七、总结与最佳实践用数据模型驱动页签新增页签只加一条数据内容与图标统一收敛。参数化 Builder 自定义 TabBar一套组件覆盖底部、顶部、纯图标、下划线多种形态。canIUse 探测 useFloating 开关实现 HDS 悬浮与原生 Tabs 双轨降级。设备差异收敛在产品层手机/平板复用 MSVTabsTV 独立实现 TvTabs。onIndexChange 只抛事件不写业务保证公共组件与业务解耦。

相关新闻

HarmonyOS 多设备短视频开发 : 12 — 基础组件 Text、Image、Button 实战

HarmonyOS 多设备短视频开发 : 12 — 基础组件 Text、Image、Button 实战

12 — 基础组件 Text、Image、Button 实战一、引言Text、Image、Button 是 ArkUI 中使用频率最高的三个基础组件:Text 承载文字、Image 承载图片、Button 承载交互。在短视频应用里,大到视频标题、作者昵称,小到点赞图标、发送按钮&#xff0…

2026/11/16 15:50:24 阅读更多 →
HarmonyOS 多设备短视频开发 : 11 — ArkUI 声明式开发范式

HarmonyOS 多设备短视频开发 : 11 — ArkUI 声明式开发范式

11 — ArkUI 声明式开发范式 一、引言HarmonyOS ArkUI 采用声明式开发范式,开发者只需要描述"界面长什么样、数据如何驱动界面",而无需关心"如何一步步把控件添加到屏幕上"。相比传统的命令式开发(如安卓 View 体系的 fi…

2026/11/8 3:57:53 阅读更多 →
Jetpack Compose ConstraintLayout:从约束关系理解到工程实践

Jetpack Compose ConstraintLayout:从约束关系理解到工程实践

Jetpack Compose 的 ConstraintLayout,是我见过最多安卓开发者上手时都会卡一下的组件。说它卡,不是 API 多难,而是很多人带着 XML 时代的使用惯性来理解它,结果发现在 Compose 里,ConstraintLayout 既不是默认布局&am…

2026/11/13 15:00:17 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/19 21:38:27 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/19 21:38:49 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/19 21:39:09 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/19 21:36:50 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/19 21:37:45 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/19 21:36:20 阅读更多 →

日新闻

周新闻

月新闻