openharmony 鸿蒙 ts-basic-components-menuitem

2025-06-12 浏览 (1)

MenuItem

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

说明:

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

子组件

接口

MenuItem(value?: MenuItemOptions|CustomBuilder)

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

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

参数:

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

MenuItemOptions对象说明

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

名称类型必填说明
startIconResourceStritem中显示在左侧的图标信息路径。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
contentResourceStritem的内容信息。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
endIconResourceStritem中显示在右侧的图标信息路径。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
labelInfoResourceStr定义结束标签信息,如快捷方式Ctrl+C等。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
builderCustomBuilder用于构建二级菜单。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
symbolStartIcon12+SymbolGlyphModifieritem中显示在左侧的HMSymbol图标信息路径。配置该项时,原先startIcon图标不显示。
原子化服务API: 从API version 12开始,该接口支持在原子化服务中使用。
symbolEndIcon12+SymbolGlyphModifieritem中显示在右侧的HMSymbol图标信息路径。配置该项时,原先endIcon图标不显示。
原子化服务API: 从API version 12开始,该接口支持在原子化服务中使用。

属性

除支持通用属性外,还支持以下属性:

selected

selected(value: boolean)

设置菜单项是否选中。

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

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

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

参数:

参数名类型必填说明
valueboolean菜单项是否选中。
默认值:false
值为true时,菜单项被选中。值为false时,菜单项不被选中。

selectIcon

selectIcon(value: boolean|ResourceStr|SymbolGlyphModifier)

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

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

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

参数:

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

contentFont10+

contentFont(value: Font)

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

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

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

参数:

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

contentFontColor10+

contentFontColor(value: ResourceColor)

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

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

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

参数:

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

labelFont10+

labelFont(value: Font)

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

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

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

参数:

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

labelFontColor10+

labelFontColor(value: ResourceColor)

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

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

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

参数:

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

事件

onChange

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

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

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

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

参数:

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

示例

详见Menu组件示例

你可能感兴趣的鸿蒙文章

harmony 鸿蒙图像AI分析错误码

harmony 鸿蒙ArcButton

harmony 鸿蒙ArcSlider

harmony 鸿蒙Chip

harmony 鸿蒙ChipGroup

harmony 鸿蒙ComposeListItem

harmony 鸿蒙ComposeTitleBar

harmony 鸿蒙advanced.Counter

harmony 鸿蒙弹出框 (Dialog)

harmony 鸿蒙DialogV2

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/SyCRAP