harmony 鸿蒙MenuItem
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组件示例。
你可能感兴趣的鸿蒙文章
- 所属分类: 后端技术
- 本文标签:
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦