目录

MenuItem

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

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

  • 该组件从API版本26.0.0开始支持WithTheme。

子组件

无

接口

MenuItem(value?: MenuItemOptions | CustomBuilder)

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

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

参数:

参数名 类型 必填 说明
value MenuItemOptions | CustomBuilder 否 包含设置MenuItem的各项信息。需要使用标准菜单项配置(如起始图标、内容、标签等)时选择MenuItemOptions;需要自定义菜单项的显示内容和布局时选择CustomBuilder。如果不传该参数,则创建空的MenuItem对象。

属性

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

[h2]selected

selected(value: boolean)

设置菜单项是否选中。

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

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

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

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

参数:

参数名 类型 必填 说明
value boolean 是

菜单项是否选中。

true:菜单项被选中;false:菜单项不被选中。

默认值:false

[h2]selectIcon

selectIcon(value: boolean | ResourceStr | SymbolGlyphModifier)

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

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

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

参数:

参数名 类型 必填 说明
value boolean | ResourceStr10+| SymbolGlyphModifier12+ 是

菜单项被选中时的图标显示方式。

true:显示默认的对勾图标;false:不显示图标。

ResourceStr:显示指定的图标。

SymbolGlyphModifier:显示指定的HMSymbol图标。

默认值:false

[h2]contentFont10+

contentFont(value: Font)

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

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

模型约束: 此接口仅可在Stage模型下使用。

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

参数:

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

[h2]contentFontColor10+

contentFontColor(value: ResourceColor)

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

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

模型约束: 此接口仅可在Stage模型下使用。

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

参数:

参数名 类型 必填 说明
value ResourceColor 是

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

默认值:'#E5000000'

[h2]labelFont10+

labelFont(value: Font)

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

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

模型约束: 此接口仅可在Stage模型下使用。

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

参数:

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

[h2]labelFontColor10+

labelFontColor(value: ResourceColor)

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

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

模型约束: 此接口仅可在Stage模型下使用。

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

参数:

参数名 类型 必填 说明
value ResourceColor 是

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

默认值:'#99000000'

事件

[h2]onChange

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

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

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

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

参数:

参数名 类型 必填 说明
selected boolean 是

当前菜单项是否被选中。

true:当前菜单项已选中;false:当前菜单项未选中。

示例

详见Menu组件示例。