尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
HarmonyOS应用开发实战:猫猫大作战-NavDestination 的结构组成、自定义标题栏、菜单栏和工具栏以及生命周期管理
前言NavDestination是 Navigation 路由体系中每个“页面“的容器——它提供标题栏、工具栏、菜单栏、返回按钮等页面级 UI 结构同时管理页面内容的渲染。每个通过pushPath进入的“页面“实际上都是一个 NavDestination 实例。本文以「猫猫大作战」中排行榜详情页和游戏结束页为锚点讲解 NavDestination 的结构组成、自定义标题栏、菜单栏和工具栏以及生命周期管理。提示本系列不讲 ArkTS 基础语法与环境搭建假设你已跟完第 1–83 篇。本篇是阶段三第 84 篇。一、NavDestination 基本结构1.1 最简实现Component struct LeaderboardPage { build() { NavDestination() { // 页面内容 Column() { Text(排行榜内容区) .fontSize(20) } .padding(16) } .title(排行榜) // 标题栏 } }1.2 核心属性属性说明示例.title()标题栏.title(排行榜).menu()菜单栏右上角.menu(this.MenuBuilder).toolBar()底部工具栏.toolBar(this.ToolBarBuilder).backButtonIcon()自定义返回图标.backButtonIcon($r(sys.media.ohos_ic_back)).hideTitleBar()隐藏标题栏.hideTitleBar(true).hideBackButton()隐藏返回按钮.hideBackButton().mode()导航栏显示模式.mode(NavDestinationMode.STANDARD)二、标题栏配置2.1 标准标题NavDestination() { // 页面内容 } .title(排行榜) // 纯文本标题 .title({ text: 排行榜, textColor: #2C3E50, fontSize: 18 }) // 自定义样式标题2.2 自定义标题栏Component struct LeaderboardPage { Builder CustomTitle() { Row() { Text() .fontSize(24) Text(排行榜) .fontSize(20) .fontWeight(FontWeight.Bold) .margin({ left: 8 }) Text(TOP 100) .fontSize(12) .fontColor(#999) .margin({ left: 8 }) } } build() { NavDestination() { List() { /* 排行榜列表 */ } } .title(this.CustomTitle()) // 自定义标题 } }三、菜单栏与工具栏3.1 菜单栏右上角Component struct LeaderboardPage { Builder MenuArea() { Row() { Image($r(app.media.icon_search)) .width(24) .height(24) .margin({ right: 12 }) .onClick(() { console.info(搜索) }) Image($r(app.media.icon_filter)) .width(24) .height(24) .onClick(() { console.info(筛选) }) } } build() { NavDestination() { List() { /* 排行榜列表 */ } } .title(排行榜) .menu(this.MenuArea) } }3.2 工具栏底部Component struct GameOverPage { Builder ToolBarArea() { Row() { Button(再来一局) .width(45%) .backgroundColor(#2ECC71) .onClick(() { console.info(重新开始) }) Blank().width(10%) Button(返回主页) .width(45%) .backgroundColor(#95A5A6) .onClick(() { console.info(返回主页) }) } .padding(12) .width(100%) } build() { NavDestination() { Column() { Text(游戏结束) .fontSize(28) Text(得分: 88888) .fontSize(20) } .padding(24) } .title(游戏结束) .hideBackButton(true) // 游戏结束页隐藏返回 .toolBar(this.ToolBarArea) } }四、返回按钮控制4.1 隐藏/显示返回按钮// 隐藏返回按钮适用于首页、登录页等 NavDestination() .hideBackButton(true) // 自定义返回图标 NavDestination() .backButtonIcon($r(sys.media.ohos_ic_back)) // 拦截返回事件 NavDestination() .onBackPressed(() { console.info(返回被拦截) return true // true拦截不返回false放行返回 })4.2 返回确认Component struct GameBoardPage { State showConfirm: boolean false; build() { NavDestination() { // 游戏棋盘内容 } .title(游戏中) .onBackPressed(() { // 游戏进行中时阻止返回弹出确认框 if (this.isPlaying) { AlertDialog.show({ message: 确定要退出游戏吗, primaryButton: { value: 继续游戏, action: () {} }, secondaryButton: { value: 退出, action: () { this.navStack.pop() }} }); return true // 拦截返回显示确认框 } return false // 放行返回 }) } }五、生命周期5.1 NavDestination 生命周期NavDestination 的生命周期与页面栈操作一一对应pushPath(pages/Leaderboard) ↓ Leaderboard 的 NavDestination 创建 ↓ aboutToAppear() ↓ build() ↓ onDidBuild() ↓ onPageShow() ← 页面可见 pop() ↓ onPageHide() ← 页面隐藏 aboutToDisappear() ← 页面销毁5.2 生命周期回调Component struct LeaderboardPage { aboutToAppear() { console.info(排行榜页即将出现) } onPageShow() { console.info(排行榜页可见) // 刷新数据 } onPageHide() { console.info(排行榜页隐藏) // 暂停视频等 } aboutToDisappear() { console.info(排行榜页销毁) // 释放资源 } }六、总结NavDestination 是 Navigation 体系中的页面容器提供了标题栏、菜单栏、工具栏等页面级 UI 组件支持自定义样式和返回控制。核心要点NavDestination是 Navigation 中每个“页面“的容器.title()标题栏支持文本和Builder自定义.menu()右上角菜单栏.toolBar()底部工具栏.hideBackButton()隐藏返回按钮.onBackPressed()拦截返回事件生命周期aboutToAppear → build → onPageShow → onPageHide → aboutToDisappear下一篇预告第 85 篇将深入 navDestination Builder 注册式跳转讲解严格模式下的页面注册要求。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源NavDestination 组件参考Navigation 跳转Navigation 架构介绍开源鸿蒙跨平台社区第 83 篇NavPathStack第 85 篇navDestination Builder
RELATED

相关推荐

HarmonyOS应用开发实战:猫猫大作战-Ability 注册规则、skills 意图过滤、deviceTypes 多设备适配,以及与 app.json

HarmonyOS应用开发实战:猫猫大作战-Ability 注册规则、skills 意图过滤、deviceTypes 多设备适配,以及与 app.json

前言 在 HarmonyOS 应用中,module.json5 是每个模块下必不可少的配置文件——它定义了模块的名称、类型、支持的设备、Ability 注册、页面路径、权限声明等关键信息。不理解这个文件,就无法理解应用是如何被系统识别和启动的。 本文以「猫猫大作战」的…

📅 2026/11/22 2:18:49
2026年视频转文字工具推荐:手机、电脑、在线全覆盖,免费付费怎么选

2026年视频转文字工具推荐:手机、电脑、在线全覆盖,免费付费怎么选

这两年视频内容越来越多,不管是学生整理网课笔记、职场人转录会议录音,还是自媒体创作者做字幕、提取文案,把视频里的语音转成文字都已经成了日常刚需。我自己前阵子整理了一堆手机录的培训视频,试了七八个工具才摸清楚门道——有…

📅 2026/11/22 2:18:49
HarmonyOS应用开发实战:猫猫大作战-relationalStore 建库建表、增删改查 SQL、事务批量插入、与 Preference 键值取

HarmonyOS应用开发实战:猫猫大作战-relationalStore 建库建表、增删改查 SQL、事务批量插入、与 Preference 键值取

前言 前面我们用 HTTP 拉排行榜、上报得分——但应用关闭后本地数据全没了,下次开要重新拉。战绩历史、玩家昵称、皮肤解锁这种结构化持久数据要存本地数据库。HarmonyOS 提供 ohos.data.relationalStore(SQLite 封装)做关系型存储——建表、…

📅 2026/10/6 16:10:00
MORE NEWS

更多资讯

📰

西安电工作业证查询全流程办理指南:在哪考不迷路,一次通过不踩坑

西安电工作业证查询全流程办理指南:在哪考不迷路,一次通过不踩坑 怕考不过白交培训费?西安电工作业证查询流程和报考细节,你一定要搞清楚,别等到报名费交了才慌。今天我就从一个干过多年现场工作的老电工角度,告诉你怎么 在哪考 、怎么 查证…

📰

池州电工作业证怎么考?学历不高怕报不上名?2026河南最新政策来了

池州电工作业证怎么考?学历不高怕报不上名?2026河南最新政策来了 学历不高怕报不上名?别急,2026河南最新政策对池州电工作业证报考有了明确说明,很多人以为学历是硬门槛,其实只要满足基本条件,一样能顺利报名。今天我们就从池州电工作业证入手…

📰

乐从电工证培训机构:学历不高怕报不上名?2026河南最新政策你得知道

乐从电工证培训机构:学历不高怕报不上名?2026河南最新政策你得知道 学历不高怕报不上名?2026河南最新政策你得知道,否则错过报名窗口,后悔都来不及。最近不少学员找我咨询,说他们高中毕业,连中专都没有,担心自己能不能报考电工证,是不是必须…

📰

草堂电工证内部消息:实操考试心里没底怕挂科?看看这起洛阳电工事故

草堂电工证内部消息:实操考试心里没底怕挂科?看看这起洛阳电工事故 你是不是也在为【草堂电工证】的实操考试发愁?担心操作不熟练、怕挂科,甚至不知道考试流程和内容?其实,这些问题都可能在你真正遇到突发状况时,变成致命的风险。就像去年洛阳某市政工…

📰

安丘特种工报名怎么避开中介坑?官方报名入口全解析

安丘特种工报名怎么避开中介坑?官方报名入口全解析 不知道去哪报名怕被中介坑?安丘特种工报名真的靠谱吗?如果你是刚毕业的工程类学生,正在考虑考取特种作业操作证,那这篇文章你一定要看完。我来给你讲讲,安丘这边 官方报名入口…

📰

工器具属于特种设备吗?千万别踩坑,周口建筑工人都该知道的真相

工器具属于特种设备吗?千万别踩坑,周口建筑工人都该知道的真相 怕考不过白交培训费?别急,这事儿我见过太多人因为不懂流程、选错机构、走错路,最后钱花了证没拿到,干着急。今天就给你讲个真实案例,讲讲 工器具属于特种设备吗…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬