鸿蒙ArkTS声明式组件：MenuItem

MenuItem

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

说明：
开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
该组件从API Version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

子组件

无

接口

MenuItem(value?: MenuItemOptions| CustomBuilder)

参数：

参数	类型	必填	参数描述
value	[MenuItemOptions]	[CustomBuilder]	否

MenuItemOptions类型说明

名称	类型	必填	描述
startIcon	[ResourceStr]	否	item中显示在左侧的图标信息路径。
content	[ResourceStr]	否	item的内容信息。
endIcon	[ResourceStr]	否	item中显示在右侧的图标信息路径。
labelInfo	[ResourceStr]	否	定义结束标签信息，如快捷方式Ctrl+C等。
builder	[CustomBuilder]	否	用于构建二级菜单。

属性

除支持[通用属性]外，还支持以下属性:

名称	参数类型	描述
selected	boolean	设置菜单项是否选中。 默认值：false 从API version 10开始，该参数支持[$$]双向绑定变量。
selectIcon	boolean	[ResourceStr]10+
contentFont10+	[Font]	设置菜单项中内容信息的字体样式。
contentFontColor10+	[ResourceColor]	设置菜单项中内容信息的字体颜色。
labelFont10+	[Font]	设置菜单项中标签信息的字体样式。
labelFontColor10+	[ResourceColor]	设置菜单项中标签信息的字体颜色。

事件

名称	参数类型	描述
onChange	(selected: boolean) => void	当选中状态发生变化时，触发该回调。只有手动触发且MenuItem状态改变时才会触发onChange回调。 - value为true时，表示已选中。 - value为false时，表示未选中。

示例

Menu

以垂直列表形式显示的菜单。

说明：

• 该组件从API Version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
• Menu组件需和[bindMenu]或[bindContextMenu]方法配合使用，不支持作为普通组件单独使用。

子组件

包含[MenuItem]、[MenuItemGroup]子组件。

接口

Menu()

作为菜单的固定容器，无参数。

说明: 菜单和菜单项宽度计算规则：

布局过程中，期望每个菜单项的宽度一致。若子组件设置了宽度，则以[尺寸计算规则]为准。

不设置宽度的情况：菜单组件会对子组件MenuItem、MenuItemGroup设置默认2栅格的宽度，若菜单项内容区比2栅格宽，则会自适应撑开。

设置宽度的情况：菜单组件会对子组件MenuItem、MenuItemGroup设置减去padding后的固定宽度。

属性

除支持[通用属性]外，还支持以下属性:

名称	参数类型HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿	描述
font10+	[Font]	统一设置Menu中所有文本的字体样式。
fontColor10+	[ResourceColor]	统一设置Menu中所有文本的颜色。
radius10+	[Dimension]	[BorderRadiuses]
width10+	[Length]	菜单的宽度 默认值：64 单位vp

审核编辑 黄宇