鸿蒙5.0开发进阶:UI框架-ArkTS组件(NavDestination)

鸿蒙ArkTS声明式组件:【NavDestination】 作为NavRouter组件的子组件,用于显示导航内容区。该组件从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


NavDestination

作为子页面的根容器,用于显示Navigation的内容区。

说明

  • 该组件从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

  • 该组件从API Version 11开始默认支持安全区避让特性(默认值为:expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM])),开发者可以重写该属性覆盖默认行为,API Version 11之前的版本需配合expandSafeArea属性实现安全区避让。

  • NavDestination组件必须配合Navigation使用,作为Navigation目的页面的根节点,单独使用只能作为普通容器组件,不具备路由相关属性能力。

  • 如果页面栈中间页面的生命周期发生变化,跳转之前的栈顶Destination的生命周期(onWillShow, onShown, onHidden, onWillDisappear)与跳转之后的栈顶Destination的生命周期(onWillShow, onShown, onHidden, onWillDisappear)均在最后触发。

  • NavDestination未设置主副标题并且没有返回键时,不显示标题栏。

子组件

说明

  • 子组件类型:系统组件和自定义组件,支持渲染控制类型(if/else、ForEach和LazyForEach)。
  • 子组件个数:多个。

接口

NavDestination()

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

属性

支持通用属性。

不推荐设置位置、大小等布局相关属性,可能会造成页面显示异常。

title

title(value: string | CustomBuilder | NavDestinationCommonTitle | NavDestinationCustomTitle, options?: NavigationTitleOptions)

设置页面标题。使用NavigationCustomTitle类型设置height高度时,titleMode属性不会生效。字符串超长时,如果不设置副标题,先缩小再换行2行后以...截断。如果设置副标题,先缩小后以...截断。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valuestring | CustomBuilder | NavDestinationCommonTitle | NavDestinationCustomTitle是页面标题。
options12+NavigationTitleOptions否标题栏选项。

hideTitleBar

hideTitleBar(value: boolean)

设置是否隐藏标题栏。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueboolean是

是否隐藏标题栏。

默认值:false

true: 隐藏标题栏。

false: 显示标题栏。

mode 11+

mode(value: NavDestinationMode)

设置NavDestination类型,不支持动态修改。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueNavDestinationMode是

NavDestination类型。

默认值: NavDestinationMode.STANDARD

backButtonIcon11+

backButtonIcon(value: ResourceStr | PixelMap | SymbolGlyphModifier)

说明

不支持通过SymbolGlyphModifier对象的fontSize属性修改图标大小、effectStrategy属性修改动效、symbolEffect属性修改动效类型。

设置标题栏返回键图标。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueResourceStr | PixelMap | SymbolGlyphModifier12+是标题栏返回键图标。

menus(value: Array<NavigationMenuItem> | CustomBuilder)

说明

不支持通过SymbolGlyphModifier对象的fontSize属性修改图标大小、effectStrategy属性修改动效、symbolEffect属性修改动效类型。

设置页面右上角菜单。不设置时不显示菜单项。使用Array<NavigationMenuItem> 写法时,竖屏最多支持显示3个图标,横屏最多支持显示5个图标,多余的图标会被放入自动生成的更多图标。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueArray<NavigationMenuItem> | CustomBuilder是页面右上角菜单。

ignoreLayoutSafeArea12+

ignoreLayoutSafeArea(types?: Array<LayoutSafeAreaType>, edges?: Array<LayoutSafeAreaEdge>)

控制组件的布局,使其扩展到非安全区域

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
typesArray <LayoutSafeAreaType>否

配置扩展安全区域的类型。

默认值:

[LayoutSafeAreaType.SYSTEM]

edgesArray <LayoutSafeAreaEdge>否

配置扩展安全区域的方向。

默认值:

[LayoutSafeAreaEdge.TOP, LayoutSafeAreaEdge.BOTTOM]。

说明

组件设置LayoutSafeArea之后生效的条件为:

设置LayoutSafeAreaType.SYSTEM时,组件的边界与非安全区域重合时组件能够延伸到非安全区域下。例如:设备顶部状态栏高度100,组件在屏幕中纵向方位的绝对偏移需要在0到100之间。

若组件延伸到非安全区域内,此时在非安全区域里触发的事件(例如:点击事件)等可能会被系统拦截,优先响应状态栏等系统组件。

systemBarStyle12+

systemBarStyle(style: Optional<SystemBarStyle>)

当Navigation中显示当前NavDestination时,设置对应系统状态栏的样式。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
styleOptional<SystemBarStyle>是系统状态栏样式。

说明

  1. 必须配合Navigation使用,作为其Navigation目的页面的根节点时才能生效。
  2. 其他使用限制请参考Navigation对应的systemBarStyle属性说明。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称描述
STANDARD标准模式的NavDestination。
DIALOG默认透明,进出页面栈不影响下层NavDestination的生命周期,不支持系统转场动画。

事件

除支持通用事件外,还支持如下事件:

onShown10+

onShown(callback: () => void)

当该NavDestination页面显示时触发此回调。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

onHidden10+

onHidden(callback: () => void)

当该NavDestination页面隐藏时触发此回调。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

onWillAppear12+

onWillAppear(callback: Callback<void>)

当该Destination挂载之前触发此回调。在该回调中允许修改页面栈,当前帧生效。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

onWillShow12+

onWillShow(callback: Callback<void>)

当该Destination显示之前触发此回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

onWillHide12+

onWillHide(callback: Callback<void>)

当该Destination隐藏之前触发此回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

onWillDisappear12+

onWillDisappear(callback: Callback<void>)

当该Destination卸载之前触发的生命周期(有转场动画时,在转场动画开始之前触发)。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

onBackPressed10+

onBackPressed(callback: () => boolean)

当与Navigation绑定的页面栈中存在内容时,此回调生效。当点击返回键时,触发该回调。

返回值为true时,表示重写返回键逻辑,返回值为false时,表示回退到上一个页面。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

onReady11+

onReady(callback: Callback<NavDestinationContext>)

当NavDestination即将构建子组件之前会触发此回调。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
mainstring是设置主标题。
substring是设置副标题。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
builderCustomBuilder是设置标题栏内容。
heightTitleHeight | Length是设置标题栏高度。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
pathInfoNavPathInfo是

跳转NavDestination时指定的参数。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

pathStackNavPathStack是

当前NavDestination所处的页面栈。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

navDestinationId12+string否

当前NavDestination的唯一ID,由系统自动生成,和组件通用属性id无关。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

getConfigInRouteMap12+

getConfigInRouteMap(): RouteMapConfig |undefined

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

返回值

类型说明
RouteMapConfig当前页面路由配置信息。
undefined当该页面不是通过路由表配置时返回undefined。

RouteMapConfig12+

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
namestring是页面名称。
pageSourceFilestring是页面在当前包中的路径。
dataobject是页面自定义字段信息。

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:NavDestination) ArkTS声明式开发(基础手势:NavDestination) 阅读详情

相关推荐

鸿蒙5.0版开发:ArkTS组件-NavDestination

作为子页面的根容器,用于显示Navigation的内容区。

m0_69424697的博客 1522

鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之NavDestination组件

鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之NavDestination组件。

weixin_47730343的博客 611

纯血鸿蒙APP实战开发——侧滑返回事件拦截案例

在编辑场景中,存在用户误触返回,导致内容未保存就退出编辑页的现象;本示例介绍使用NavDestination组件的onBackPressed回调对返回事件进行拦截,提示用户保存编辑内容,并使用preferences实例持久化保存内容。如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:关注小编,同时可以期待后续文章ing🚀,不定期分享原创知识。

m0_71524094的博客 1743

鸿蒙APP实战案例分析——NavDestination弹窗思路

本案例介绍了使用NavDestination组件的Dialog模式实现与前一个页面的联动的评论弹窗。

adaedwa187545的博客 816

鸿蒙(HarmonyOS)Navigation如何实现多场景UI适配?

在窄屏设备上,联系人和聊天区在多窗口中体现。在宽屏设备上,联系人和聊天区在同一窗口体现。要做好适配,往往需要开发者开发多套代码,以便运行在不同设备上。但是这样耗时耗力,于是ArkUI针对这种场景提供了分栏组件,可以通过一套代码完成不同设别的适配,本例简单介绍下如何使用分栏组件实现上述场景。

maniuT的博客 1930

OpenHarmony实战开发-Navigation如何实现多场景UI适配

应用在不同屏幕大小的设备上运行时,往往有不同的UI适配,以聊天应用举例:

m0_70749039的博客 1036

HarmonyOS6 ArkTS NavDestination

通过存储滚动组件的垂直偏移量,作为标题栏模式切换的判断依据;NavDestination作为HarmonyOS 6中构建页面体系的核心组件,其核心价值在于实现了页面的模块化封装与与Navigation、滚动组件的深度联动。通过简单的属性配置,即可实现标题自定义、返回按钮控制、安全区自适应等基础能力,结合Scroll/List的滚动监听,还能实现沉浸式的标题栏联动效果,是HarmonyOS 6 ArkTS开发中不可或缺的组件。

qq_37048082的博客 5585

老N卡福音:GT1030/GTX1050在MacOS Ventura 13.2上的完整驱动指南(附实测截图)

本文详细介绍了如何在MacOS Ventura 13.2上通过OCLP工具链驱动GT1030和GTX1050等老款NVIDIA显卡,涵盖硬件兼容性验证、BIOS设置、OpenCore配置、驱动安装及性能测试全流程。实测数据显示,这些基于Pascal和Maxwell架构的显卡在当代MacOS系统中仍能发挥实用价值,为老N卡用户提供完整解决方案。

weixin_30832143的博客 634

鸿蒙5.0进阶开发:UI开发-导航转场

导航转场是页面的路由转场方式,也就是一个界面消失,另外一个界面出现的动画效果。

AyomQAQ的博客 860

普通人也能看懂的Transformer源代码解释(PyTorch)

Transformer源代码解释之PyTorch篇 章节 词嵌入 位置编码 多头注意力 搭建Transformer 在这里插入图片描述 词嵌入 Transformer本质上是一种Encoder,以翻译任务为例,原始数据集是以两种语言组成一行的,在应用时,应是Encoder输入源语言序列,Decoder里面输入需要被转换的语言序列(训练时)。一个文本常有许多序列组成,常见操作为将序列进行一些预处理(如词切分等)变成列表,一个序列的列表的元素通常为词表中不可切分的最小词,整个文本就是一个大列表,元素为一个一

qq_50974223的博客 4171

【操作系统】实验楼操作系统实验三——系统调用

操作系统实验3——系统调用 环境配置 ​ 首先同样是配置环境 cd /home/shiyanlou/oslab tar -zxvf hit-oslab-linux-20110823.tar.gz -C /home/shiyanlou 实验步骤 添加函数声明 cd ~/oslab/linux-0.11/include/linux gedit sys.h //添加内容: extern int sys_whoami(); extern int sys_iam(); fn_ptr_sys_call_table

qq_46612803的博客 6359

HarmonyOS6 ArkTS Navigation

Navigation 是HarmonyOS6中实现页面导航的基础核心组件,其与NavDestination的组合是官方推荐的标准导航布局方式,具备布局规范、多端适配、配置灵活等特点。本示例通过状态管理+条件渲染的方式,实现了主/子页面的基础切换,代码简洁、可直接运行,符合HarmonyOS6 ArkTS的开发规范。

qq_37048082的博客 5838

Abaqus 单元与全局刚度矩阵导出实战指南:从INP修改到结果解析

本文提供了Abaqus中导出单元刚度矩阵和全局刚度矩阵的完整实战指南。通过详细步骤讲解INP文件修改、关键指令插入及结果文件解析,帮助工程师、研究人员和二次开发者深入理解有限元软件内核,实现理论验证、二次开发与深度问题调试。

k8s6orchestrator的博客 901

如何用 ECC 开发 HarmonyOS/ArkTS 应用?

当你用 ECC(面向 Claude Code、Codex、Cursor 等 agent harness 的工程化规则系统)辅助开发一个 HarmonyOS 应用时,需要先把 ECC 的 ArkTS 规则包和项目级 `CLAUDE.md` 配进项目,再调用 `harmonyos-app-resolver` agent 进行实现或评审。ECC 为 HarmonyOS/ArkTS 提供了一套硬性约束:状

gitblog_01095的博客 814

蓝鸟四轴飞控系统C程序V3.0(基础版本)深度解读

2. 解析遥控通道数据(油门 / 横滚 / 俯仰 / 偏航),转换为标准化值(-1000~+1000);3. 封装PID初始化(PID_Init,配置KP/KI/KD、输出限幅、积分限幅);,包含姿态角(Attitude_Data.Roll/Pitch/Yaw)、角速度(Gyro_Data.X/Y/Z)、遥控值(RC_Data[0~5])、电池电压(Bat_Volt)、电机PWM值(Motor_PWM[0~3])、系统状态(Sys_State),校验和通过Check_Sum()函数计算;

搏博的专栏 344

Go基础:Go语言详细介绍,环境搭建,及第一个程序详解

Go语言是Google开发的开源编程语言,具有高效、简洁、并发性强等特点。文章从Go语言的诞生背景、核心特性及应用领域展开介绍,并详细说明了Windows、Linux和macOS下的环境搭建步骤,包括安装、环境变量配置及测试方法。最后通过“Hello, World!”程序解析Go语言基本语法,并演示了编译发布和跨平台编译功能。全文涵盖了Go语言从入门到实践的完整流程,适合初学者快速上手。

数据知道的博客 6800

HarmonyOS 鸿蒙App开发不难:一个前端工程师的 ArkTS 上手实践

一个前端工程师的 HarmonyOS 上手实录,附一个已上架的真实应用。

liliang8164的博客 602

【DRAM存储器三十】DDR4介绍-DDR4 SDRAM的主要技术特性之bank group,为什么要搞个group出来?

详述DDR4 bank group的作用

highman110的博客 2139

鸿蒙开发5.0案例分析:应用内的生命周期流转

1.UIAbility组件生命周期。UIAbility组件是一种包含UI的应用组件,主要用于和用户交互。UIAbility组件是系统调度的基本单元,为应用提供绘制界面的窗口。一个应用可以包含一个或多个UIAbility组件。例如在支付应用中,可以将入口功能和收付款功能分别配置为独立的UIAbility。当用户打开,切换和返回到对应应用时,应用中的UIAbility实例会在其生命周期的不同状态之间转换。

2501_91726121的博客 772

滑模控制算法(SMC)讲解-案例(附C代码)

该文章介绍了滑模控制算法的原理实现步骤,特点及关键问题,最后以车辆控制案例来讲解滑模控制的整个步骤实现

heda3的博客 4112

visio安装包

Microsoft Office Visio 是一款专业的制图软件。利用经过更新的形状、协作工具和数据链接图表,创建专业级图表以简化复杂的信息。

鸿蒙开发(API12)通过组件导航Navigation配合NavPathStack实现页面路由

在跳转之前需要在app/entry/src/main/resources/base/profile中新建文件route_map.json文件名可以随意,在文件中对子页面进行注册,并在PageTwo文件中写一个builder方法,最后在app/entry/src/main/module.json5,module.json5中绑定route_map.json,最后可以完成tia。属性进行隐藏,导航页不存在页面栈中,导航页和子页,以及子页之间可以通过路由操作进行切换。在API Version 9上,需要配合。

2301_81830829的博客 1142

Data-Structures-and-Algorithm-Analysis-in-Java.pdf

作者: Weiss, Mark A. 出版社: Addison Wesley Data Structures and Algorithm Analysis in Java is an “advanced algorithms” book that fits between traditional CS2 and Algorithms Analysis courses. In the old ACM Curriculum Guidelines, this course was known as CS7. This text is for readers who want to learn good programming and algorithm analysis skills simultaneously so that they can develop such programs with the maximum amo...

HarmonyOS 应用项目 CLAUDE.md 编写指南:基于 ECC 的 ArkTS 开发规则落地方案

> **技术导读**:本文以 ECC 仓库中 [docs/ja-JP/examples/harmonyos-app-CLAUDE.md](https://link.gitcode.com/i/2a4fead1aa03832ee319b8a7691423e8) 为骨架,讲解如何为 HarmonyOS(ArkTS)项目编写一份项目级 CLAUDE.md 示例。文章涵盖技术栈约束(状态管理 V2、Nav

gitblog_00476的博客 831

lwip-2.0.3

lwip是瑞典计算机科学院(SICS)的Adam Dunkels 开发的一个小型开源的TCP/IP协议栈。实现的重点是在保持TCP协议主要功能的基础上减少对RAM 的占用。

精雕软件(JDpaint) 5.5 绿色版

精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版

HarmonyOS应用开发实战:萌宠日记 - 从看 HarmonyOS 应用开发最佳实践

本文总结了HarmonyOS应用"萌宠日记"的完整开发历程,系统梳理了100篇技术文章的核心内容。从架构设计、UI组件化、数据管理到性能优化,全面呈现了应用开发的最佳实践。 关键要点包括: 三层导航架构设计(Tabs+Navigation+NavPathStack) 组件化UI设计规范(卡片/标题/标签组件) 数据分层存储方案(Preferences/RDB/文件系统) 性能优化策略(懒加载/缓存/生命周期管理) 可扩展性设计(分类/语言/设备适配) 文章还提供了开发工具链推荐、系列内容回顾以及AI功能等未

b13053810049的博客 235

ECC 的 harmonyos-app-resolver 智能体实战:ArkTS/ArkUI 下 V2 状态管理、Navigation 路由与编译约束全指南

> 本指南以 [agents/harmonyos-app-resolver.md](https://link.gitcode.com/i/d0b46684d27c8feb41fd23e20e0d99f5) 为核心骨架,结合仓库内的 [rules/arkts/](https://link.gitcode.com/i/c9fd3a57668c98252f0011568fb7a4e4) 规则包(patt

gitblog_00263的博客 391

HarmonyOS应用开发实战:萌宠日记 - 整体架构设计与技术选型解析

摘要: 《萌宠日记》是一款基于HarmonyOS ArkTS开发的宠物生活管理应用,通过模块化架构整合日记记录、健康管理、成长追踪等功能。项目采用Stage模型与ArkUI声明式开发,核心技术包括: 分层导航:Tabs+Navigation实现多Tab独立页面栈管理 状态管理:@State与自定义回调完成跨页通信 数据持久化:Preferences+RDB混合存储方案 主题系统:动态资源适配多主题切换 工程结构:AppScope全局配置与entry主模块分离设计 后续系列文章将逐一拆解各功能模块的实现细节,

hdn616964738的专栏 165

OpenHarmony实战开发-侧滑返回事件拦截案例。

在编辑场景中,存在用户误触返回,导致内容未保存就退出编辑页的现象; 本示例介绍使用NavDestination组件的onBackPressed回调对返回事件进行拦截,提示用户保存编辑内容,并使用preferences实例持久化保存内容。

m0_70749039的博客 1326
上一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(NavRouter)
下一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(Navigator)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值