鸿蒙5.0开发进阶：UI框架-ArkTS组件（MenuItem）

往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

MenuItem

用来展示菜单Menu中具体的item菜单项。

说明

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

子组件

无

接口

MenuItem(value?: MenuItemOptions| CustomBuilder)

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

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

参数：

参数名	类型	必填	说明
value	MenuItemOptions | CustomBuilder	否	包含设置MenuItem的各项信息。

MenuItemOptions对象说明

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

名称	类型	必填	说明
startIcon	ResourceStr	否	item中显示在左侧的图标信息路径。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
content	ResourceStr	否	item的内容信息。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
endIcon	ResourceStr	否	item中显示在右侧的图标信息路径。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
labelInfo	ResourceStr	否	定义结束标签信息，如快捷方式Ctrl+C等。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
builder	CustomBuilder	否	用于构建二级菜单。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
symbolStartIcon12+	SymbolGlyphModifier	否	item中显示在左侧的HMSymbol图标信息路径。配置该项时，原先startIcon图标不显示。 元服务API： 从API version 12开始，该接口支持在元服务中使用。
symbolEndIcon12+	SymbolGlyphModifier	否	item中显示在右侧的HMSymbol图标信息路径。配置该项时，原先endIcon图标不显示。 元服务API： 从API version 12开始，该接口支持在元服务中使用。

属性

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

selected

selected(value: boolean)

设置菜单项是否选中。

从API version 10开始，该参数支持$$双向绑定变量。

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

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

参数：

参数名	类型	必填	说明
value	boolean	是	菜单项是否选中。 默认值：false

selectIcon

selectIcon(value: boolean | ResourceStr | SymbolGlyphModifier)

设置当菜单项被选中时，是否显示被选中的图标。

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

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

参数：

参数名	类型	必填	说明
value	boolean | ResourceStr10+| SymbolGlyphModifier12+	是	菜单项被选中时，是否显示被选中的图标。 默认值：false true: 菜单项被选中时，显示默认的对勾图标 false: 即使菜单项被选中也不显示图标 ResourceStr: 菜单项被选中时，显示指定的图标 SymbolGlyphModifier: 菜单项被选中时，显示指定的HMSymbol图标。

contentFont10+

contentFont(value: Font)

设置菜单项中内容信息的字体样式。

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

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

参数：

参数名	类型	必填	说明
value	Font	是	菜单项中内容信息的字体样式。

contentFontColor10+

contentFontColor(value: ResourceColor)

设置菜单项中内容信息的字体颜色。

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

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

参数：

参数名	类型	必填	说明
value	ResourceColor	是	菜单项中内容信息的字体颜色。 默认值：'#E5000000'

labelFont10+

labelFont(value: Font)

设置菜单项中标签信息的字体样式。

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

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

参数：

参数名	类型	必填	说明
value	Font	是	菜单项中标签信息的字体样式。

labelFontColor10+

labelFontColor(value: ResourceColor)

设置菜单项中标签信息的字体颜色。

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

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

参数：

参数名	类型	必填	说明
value	ResourceColor	是	菜单项中标签信息的字体颜色。 默认值：'#99000000'

事件

onChange

onChange(callback: (selected: boolean) => void)

当选中状态发生变化时，触发该回调。只有手动触发且MenuItem状态改变时才会触发onChange回调。

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

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

参数：

参数名	类型	必填	说明
selected	boolean	是	选中状态发生变化时，触发该回调。 返回值为true时，表示已选中，为false时，表示未选中。