菜单控制

为组件绑定弹出式菜单，弹出式菜单以垂直列表形式显示菜单项，可通过长按、点击或鼠标右键触发。

说明：
开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
CustomBuilder里不支持再使用bindMenu、bindContextMenu弹出菜单。多级菜单可使用[Menu组件])。

属性

名称	参数类型	描述
bindMenu	content: Array<[MenuItem]>	[CustomBuilder], options?: [MenuOptions]
bindContextMenu8+	content: [CustomBuilder], responseType: [ResponseType]options?: [ContextMenuOptions]	给组件绑定菜单，触发方式为长按或者右键点击，弹出菜单项需要自定义。 responseType: 菜单弹出条件，长按或者右键点击。 options: 配置弹出菜单的参数。

MenuItem

名称	类型	必填	描述
value	string	是	菜单项文本。
icon10+	[ResourceStr]	否	菜单项图标。
action	() => void	是	点击菜单项的事件回调。

MenuOptions10+

名称	类型	必填	描述
title	string	否	菜单标题。说明：仅在content设置为Array<[MenuItem]> 时生效。
offset	[Position]	否	菜单弹出位置的偏移量，不会导致菜单显示超出屏幕范围。说明：菜单类型为相对?组件区域弹出时，?动根据菜单位置属性 (placement)将区域的宽或?计?偏移量中。当菜单相对父组件出现在上侧时（placement设置为Placement.TopLeft，Placement.Top，Placement.TopRight），x为正值，菜单相对组件向右进行偏移，y为正值，菜单相对组件向上进行偏移。当菜单相对父组件出现在下侧时（placement设置为Placement.BottomLeft，Placement.Bottom，Placement.BottomRight），x为正值，菜单相对组件向右进行偏移，y为正值，菜单相对组件向下进行偏移。当菜单相对父组件出现在左侧时（placement设置为Placement.LeftTop，Placement.Left，Placement.LeftBottom），x为正值，菜单相对组件向左进行偏移，y为正值，菜单相对组件向下进行偏移。当菜单相对父组件出现在右侧时（placement设置为Placement.RightTop，Placement.Right，Placement.RightBottom），x为正值，菜单相对组件向右进行偏移，y为正值，菜单相对组件向下进行偏移。如果菜单调整了显示位置（与placement初始值主方向不?致），则偏移值 (offset) 失效。
placement	[Placement]	否	菜单组件优先显示的位置，当前位置显示不下时，会自动调整位置。说明：placement值设置为undefined、null或没有设置此选项时，按默认值[BottomLeft]处理，相对父组件区域弹出。
onAppear	() => void	否	菜单弹出时的事件回调。
onDisappear	() => void	否	菜单消失时的事件回调。

ContextMenuOptions10+

搜狗高速浏览器截图20240326151450.png

名称	类型	必填	描述`HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿`
offset	[Position]	否	菜单弹出位置的偏移量，不会导致菜单显示超出屏幕范围。说明：菜单类型为相对?组件区域弹出时，?动根据菜单位置属性 (placement)将区域的宽或?计?偏移量中。当菜单相对父组件出现在上侧时（placement设置为Placement.TopLeft，Placement.Top，Placement.TopRight），x为正值，菜单相对组件向右进行偏移，y为正值，菜单相对组件向上进行偏移。当菜单相对父组件出现在下侧时（placement设置为Placement.BottomLeft，Placement.Bottom，Placement.BottomRight），x为正值，菜单相对组件向右进行偏移，y为正值，菜单相对组件向下进行偏移。当菜单相对父组件出现在左侧时（placement设置为Placement.LeftTop，Placement.Left，Placement.LeftBottom），x为正值，菜单相对组件向左进行偏移，y为正值，菜单相对组件向下进行偏移。当菜单相对父组件出现在右侧时（placement设置为Placement.RightTop，Placement.Right，Placement.RightBottom），x为正值，菜单相对组件向右进行偏移，y为正值，菜单相对组件向下进行偏移。如果菜单调整了显示位置（与placement初始值主方向不?致），则偏移值 (offset) 失效。
placement	[Placement]	否	菜单组件优先显示的位置，当前位置显示不下时，会自动调整位置。说明：placement值设置为undefined、null或没有设置此选项时，按未设置placement处理，菜单跟随点击位置弹出。
arrowOffset	[Length]	否	箭头在菜单处的偏移。箭头在菜单水平方向时，偏移量为箭头至最左侧的距离，默认居中。箭头在菜单竖直方向时，偏移量为箭头至最上侧的距离，默认居中。偏移量必须合法且转换为具体数值时大于0才会生效，另外该值生效时不会导致箭头超出菜单四周的安全距离。根据配置的placement来计算是在水平还是竖直方向上偏移。
onAppear	() => void	否	菜单弹出时的事件回调。
onDisappear	() => void	否	菜单消失时的事件回调。

审核编辑黄宇

声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。举报投诉

鸿蒙

鸿蒙

+关注

关注
60

文章
2656

浏览量
44339

搜索历史

鸿蒙ArkTS声明式开发：跨平台支持列表【菜单控制】通用属性

菜单控制

属性

MenuItem

MenuOptions10+

ContextMenuOptions10+

评论

搜索历史

鸿蒙ArkTS声明式开发：跨平台支持列表【菜单控制】 通用属性

菜单控制

属性

MenuItem

MenuOptions10+

ContextMenuOptions10+

评论

鸿蒙ArkTS声明式开发：跨平台支持列表【菜单控制】通用属性