HarmonyOS 多设备短视频开发 : 17 — Navigation 路由与 NavPathStack
17 — Navigation 路由与 NavPathStack一、引言短视频应用中视频页 → 评论区 / 个人主页的跳转高频且要求无闪烁。HarmonyOS 的 Navigation 配合 NavPathStack 提供声明式路由能力。本项目在 default 产品层把 Navigation 作为导航根容器通过 Provider 下发全局导航栈实现 Stack/Split 双模式切换与左右手持布局自适应。本文基于products/default/src/main/ets/view/Index.ets、features/multishortvideoindividual/src/main/ets/view/IndividualByRouter.ets与 route_map.json 展开。二、Navigation 容器与全局导航栈NavPathStack 在根组件创建通过 Provider 向子树共享子组件用 Consumer 拿到同一个栈对象Entry ComponentV2 struct Index { Provider(pathStack) pathStack: NavPathStack new NavPathStack(); Provider(showSideComment) showSideComment: boolean false; Provider(showSideIndividual) showSideIndividual: boolean false; build() { Navigation(this.pathStack) { MSVTabs({ data: this.data, ... }) } .navBarWidthRange([new WidthBreakpointTypenumber(410, 410, 700, 700).getValue(this.windowInfo.widthBp), 100%]) .navBarWidth(new WidthBreakpointTypenumber(410, 410, 700, 700).getValue(this.windowInfo.widthBp)) .hideBackButton(true) .hideTitleBar(true) .divider(null) .navBarPosition(this.holdingHandStatus motion.HoldingHandStatus.RIGHT_HAND_HELD ? NavBarPosition.Start : NavBarPosition.End) .mode(this.showSideComment || this.showSideIndividual ? NavigationMode.Split : NavigationMode.Stack) .enableModeChangeAnimation(false) } }要点navBarWidth 随断点变化XS/SM 用 410vpMD/LG 用 700vpnavBarPosition 跟随持握状态mode 由侧面板开关动态决定enableModeChangeAnimation(false) 防闪跳。三、NavDestination 与路由注册路由目标用 NavDestination 声明IndividualByRouter.etsBuilder export function IndividualByRouterBuilder() { IndividualByRouter() } ComponentV2 export struct IndividualByRouter { Consumer(pathStack) pathStack: NavPathStack new NavPathStack(); Consumer(showSideIndividual) showSideIndividual: boolean false; aboutToAppear(): void { this.pathStack.disableAnimation(this.windowInfo.widthBp WidthBreakpoint.WIDTH_MD ? false : true); } build() { NavDestination() { Individual() } .hideTitleBar(true) .hideBackButton(true) .onReady((context: NavDestinationContext) { this.pathStack context.pathStack; // 绑定页面级导航上下文 }) } }路由映射在模块resources/base/profile/route_map.json注册buildFunction 与导出的 Builder 同名{ routerMap: [ { name: IndividualByRouter, pageSourceFile: src/main/ets/view/IndividualByRouter.ets, buildFunction: IndividualByRouterBuilder } ] }default 产品层另注册了 SplitComment各产品模块各自维护 route_map.json路由互不干扰。四、入栈、出栈与参数传递视频页AdaptiveVideo.ets按断点选择跳转形态if (this.windowInfo.widthBp WidthBreakpoint.WIDTH_SM) { this.showSideComment true; // 大屏分栏侧开 this.pathStack.pushPathByName(SplitComment, null); // 入栈可携带参数 } else { this.showComment true; // 小屏半模态 } // 关闭侧面板 this.pathStack.pop(); this.showSideComment false;pushPathByName 的第二参可传任意对象目标页在 aboutToAppear/onReady 中读取onReady 回调返回 NavDestinationContext其中的 pathStack 支持页面内返回与结果回传。五、Stack/Split 双模式与多设备差异NavigationMode.Stack 全屏压栈Split 分栏时主内容区保持显示NavDestination 作为右侧面板展开。四种产品差异如下产品容器navBarWidth分栏策略defaultNavigation MSVTabs410/700vp 按断点评论、个人主页 SplitpcSideBarContainer 内嵌 Navigation66%同上tvNavigation TvTabs880vp同上wearableNavigation 精简 Tabs全宽始终 StackTV 端products/tv/src/main/ets/view/Index.ets同样以 Navigation 为根容器区别是页签用 TvTabs、navBarWidth 固定 880vp、无navBarPosition切换其余 Stack/Split 逻辑与 default 一致。六、点击主区关闭侧面板侧面板打开时主内容区拦截点击在 onGestureRecognizerJudgeBegin 中收起REJECT 吞掉点击防止误触播放.gesture(TapGesture()) .onGestureRecognizerJudgeBegin((event, current) { if (current (current.getType() GestureControl.GestureType.TAP_GESTURE || current.getType() GestureControl.GestureType.CLICK)) { if (this.showSideComment || this.showSideIndividual) { this.pathStack.pop(); this.showSideComment false; this.showSideIndividual false; return GestureJudgeResult.REJECT; } } return GestureJudgeResult.CONTINUE; })配合hitTestBehavior(HitTestMode.Block)被拦截的点击不会透传给视频播放层。七、总结与最佳实践NavPathStack 全局唯一用 Provider/Consumer 传递避免层层透传页面内导航用 onReady 的页面级栈。路由统一注册到 route_map.jsonbuildFunction 与导出 Builder 同名保证映射可维护。模式切换由业务开关驱动配合 enableModeChangeAnimation(false) 防止闪烁。大屏用 Split 分栏、小屏用半模态/Stack断点驱动形态统一收敛在跳转处。navBarPosition 跟随持握状态让折叠屏/平板单手场景更友好。

相关新闻

多厂商网络设备配置手册:华为思科H3C锐捷交换机路由器防火墙命令实战

多厂商网络设备配置手册:华为思科H3C锐捷交换机路由器防火墙命令实战

这次我们来看一个很实在的网工学习资料:全B站最全多厂商配置手册。它不是某个开源软件,也不是厂商官方文档的搬运,而是一套按场景整理好的交换机、防火墙、路由器配置命令合集,核心价值在于“多厂商对照”和“按需查询”。对刚入行…

2026/11/3 15:42:58 阅读更多 →
京东数据分析岗笔试题全解析:考点、题型与避坑指南

京东数据分析岗笔试题全解析:考点、题型与避坑指南

1. 这套试卷到底考什么:先把底牌摊开看 先说结论:京东2019春招数据分析岗的笔试,本质上不是考“你会不会用Excel”,而是考“你有没有数据分析师的脑子”。我当年拿到这套卷子的时候,第一反应是“怎么没有考SQL”&#…

2026/11/19 2:49:25 阅读更多 →
CEF 90.5.9 集成指南:版本解析、依赖文件与踩坑笔记

CEF 90.5.9 集成指南:版本解析、依赖文件与踩坑笔记

简介:本资源是面向C桌面应用开发者的CEF(Chromium Embedded Framework)二进制开发包,专为在Windows 64位平台嵌入现代Web渲染能力而设计,适用于需集成HTML5、CSS3、JavaScript及H.264视频播放能力的客户端项目。压缩包…

2026/10/26 13:07:37 阅读更多 →

最新新闻

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 阅读更多 →

日新闻

周新闻

月新闻