IT评测·应用市场-qidao123.com技术社区

标题: 鸿蒙5.0版开发：ArkTS组件-底子组件（Navigation） [打印本页]

作者: 张国伟 时间: 2025-3-29 06:48
标题: 鸿蒙5.0版开发：ArkTS组件-底子组件（Navigation）
往期鸿蒙全套实战文章必看：

鸿蒙开发核心知识点，看这篇文章就够了
最新版！鸿蒙HarmonyOS Next应用开发实战学习路线
鸿蒙HarmonyOS NEXT开发技术最全学习路线指南
鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

<hr> Navigation

Navigation组件是路由导航的根视图容器，一般作为Page页面的根容器使用，其内部默认包含了标题栏、内容区和工具栏，此中内容区默认首页显示导航内容（Navigation的子组件）或非首页显示（NavDestination的子组件），首页和非首页通过路由举行切换。
说明：
  该组件从API Version 8开始支持。后续版本如有新增内容，则接纳上角标单独标记该内容的起始版本。
  该组件从API Version 11开始默认支持安全区避让特性(默认值为：expandSafeArea([SafeAreaType.SYSTEM, SafeAreaType.KEYBOARD, SafeAreaType.CUTOUT], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]))，开发者可以重写该属性覆盖默认活动，API Version 11之前的版本需配合expandSafeArea属性实现安全区避让。
  子组件

可以包含子组件。
从API Version 9开始，保举与NavRouter组件搭配使用。
从API Version 10开始，保举使用NavPathStack配合navDestination属性举行页面路由。
接口

Navigation

Navigation()
Navigation10+

Navigation(pathInfos: NavPathStack)
绑定路由栈到Navigation组件。
原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。
参数：
参数名参数类型必填参数描述       pathInfos NavPathStack 否路由栈信息。属性

除支持通用属性外，还支持以部属性：
title

title(value: ResourceStr | CustomBuilder | NavigationCommonTitle | NavigationCustomTitle, options?: NavigationTitleOptions)
设置页面标题。
原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。
系统本领： SystemCapability.ArkUI.ArkUI.Full
参数：
参数名类型必填说明       value ResourceStr10+ | CustomBuilder | NavigationCommonTitle9+ | NavigationCustomTitle9+ 是页面标题，使用NavigationCustomTitle类型设置height高度时，titleMode属性不访问效。字符串超长时，假如不设置副标题，先缩小再换行（2行）末了…截断。假如设置副标题，先缩小末了…截断。    options NavigationTitleOptions11+ 否标题栏选项。 subTitle(deprecated)

subTitle(value: string)
设置页面副标题。
从API Version 9开始废弃，发起使用title代替。
系统本领： SystemCapability.ArkUI.ArkUI.Full
参数：
参数名类型必填说明       value string 是页面副标题。 menus

menus(value: Array<NavigationMenuItem> | CustomBuilder)
设置页面右上角菜单。不设置时不显示菜单项。使用Array<NavigationMenuItem> 写法时，竖屏最多支持显示3个图标，横屏最多支持显示5个图标，多余的图标会被放入自动生成的更多图标。
原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。
系统本领： SystemCapability.ArkUI.ArkUI.Full
参数：
参数名类型必填说明       value Array<NavigationMenuItem> | CustomBuilder 是页面右上角菜单。 titleMode

titleMode(value: NavigationTitleMode)
设置页面标题栏显示模式。
原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。
系统本领： SystemCapability.ArkUI.ArkUI.Full
参数：
参数名类型必填说明       value NavigationTitleMode 是页面标题栏显示模式。
默认值：NavigationTitleMode.Free toolBar(deprecated)

toolBar(value: object | CustomBuilder)
设置工具栏内容。不设置时不显示工具栏。items均分底部工具栏，在每个均分内容区布局文本和图标，文本超长时，逐级缩小，缩小之后换行，末了…截断。
从API version 10开始，该接口不再维护。
系统本领： SystemCapability.ArkUI.ArkUI.Full
参数：
参数名类型必填说明       value object | CustomBuilder 是工具栏内容。 object类型说明：
名称类型必填描述       value string 是工具栏单个选项的显示文本。    icon string 否工具栏单个选项的图标资源路径。    action () => void 否当前选项被选中的事件回调。 toolbarConfiguration10+

toolbarConfiguration(value: Array<ToolbarItem> | CustomBuilder, options?: NavigationToolbarOptions)
设置工具栏内容。不设置时不显示工具栏。
卡片本领： 从API version 10开始，该接口支持在ArkTS卡片中使用。
原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。
系统本领： SystemCapability.ArkUI.ArkUI.Full
参数：
参数名类型必填说明       value Array<ToolbarItem>  | CustomBuilder 是工具栏内容，使用Array<ToolbarItem>写法设置的工具栏有如下特性：
工具栏全部选项均分底部工具栏，在每个均分内容区布局文本和图标。
文本超长时，若工具栏选项个数小于5个，优先拓展选项的宽度，最大宽度与屏幕等宽，其次逐级缩小，缩小之后换行，末了…截断。
竖屏最多支持显示5个图标，多余的图标会被放入自动生成的更多图标。横屏下必须配合menus属性的Array<NavigationMenuItem>使用，底部工具栏会自动隐藏，同时底部工具栏全部选项移动至页面右上角菜单。
使用CustomBuilder写法为用户自界说工具栏选项，除均分底部工具栏外不具备以上功能。    options
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

欢迎光临 IT评测·应用市场-qidao123.com技术社区 (https://dis.qidao123.com/)