harmony 鸿蒙MenuItem

  • 2025-06-12
  • 浏览 (3)

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 version 18开始,该参数支持!!双向绑定变量。

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

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

参数:

参数名 类型 必填 说明
value boolean 菜单项是否选中。
默认值:false
值为true时,菜单项被选中。值为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时,表示未选中。

示例

详见Menu组件示例

你可能感兴趣的鸿蒙文章

harmony 鸿蒙图像AI分析错误码

harmony 鸿蒙ArcButton

harmony 鸿蒙ArcSlider

harmony 鸿蒙Chip

harmony 鸿蒙ChipGroup

harmony 鸿蒙ComposeListItem

harmony 鸿蒙ComposeTitleBar

harmony 鸿蒙advanced.Counter

harmony 鸿蒙弹出框 (Dialog)

harmony 鸿蒙DialogV2

0  赞