从6.0.0(20)版本开始,导航组件新增了对文本型与图片型图标类型的支持。
当应用开发者需要配置图片型图标,或者使用普通文字型图标、单字图标时,可通过设置titleBar图标内容配置中的type属性实现该功能。
图片型图标(IconStyleMode.LARGE):适用于需要展示完整图像的场景,例如应用的Logo、用户头像、宣传图或自定义图形按钮。
普通文字型图标(TextStyleMode.NORMAL):常规的文本按钮,适用于功能选项、操作按钮等需要清晰表达文本含义的场景。
单字图标(TextStyleMode.SINGLE_CHARACTER):适用于需要节省空间的紧凑布局,常用于快速操作入口,建议仅在单个文字或字母的场景使用。

导入相关模块。
// 从6.0.2(22)版本开始,无需手动导入HdsNavigationAttribute。具体请参考HdsNavigation的导入模块说明。
import { TextStyleMode, IconStyleMode, HdsNavigation, HdsNavigationAttribute, HdsNavigationTitleMode } from '@kit.UIDesignKit'; 创建一级导航组件,通过配置titleBar中的menu上的type属性,实现文字型图标以及图片型图标大小设置。
@Entry
@Component
struct Index {
build() {
HdsNavigation() { // 创建HdsNavigation组件
}
.titleBar({
content: {
title: { mainTitle: '标题' },
subIcon: {
content: {
// 设置用户头像,图片型图标类型
icon: $r('app.media.contacts'), // contacts为自定义资源,开发者需替换本地资源
type: IconStyleMode.LARGE,
label: 'subIcon', // 无障碍播报内容
isEnabled: true,
action: () => {
}
}
},
menu: {
// 设置菜单内容
value: [{
content: {
// 设置第一个菜单项内容,设置为普通文本按钮
label: '文本',
type: TextStyleMode.NORMAL,
isEnabled: true,
componentId: 'menu_1',
action: () => {
}
}
}, {
content: {
// 设置第二个菜单项内容,设置为单字按钮
label: '单',
type: TextStyleMode.SINGLE_CHARACTER,
isEnabled: true,
componentId: 'menu_2',
action: () => {
}
}
}, {
content: {
// 设置第三个菜单项内容,设置为通用图标按钮
label: 'largeIcon',
icon: $r('sys.symbol.AI_search'),
type: IconStyleMode.NORMAL,
isEnabled: true,
componentId: 'menu_3',
action: () => {
}
}
}],
maxCount: 3 // 最大菜单显示个数配置
}
}
})
.titleMode(HdsNavigationTitleMode.MINI)
.hideBackButton(true)
}
}