菜单控制
为组件绑定弹出式菜单,弹出式菜单以垂直列表形式显示菜单项,可通过长按、点击或鼠标右键触发。
说明:
开发前请熟悉鸿蒙开发指导文档 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
属性
名称 | 参数类型 | 描述 |
---|---|---|
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+
名称 | 类型 | 必填 | 描述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 | 否 | 菜单消失时的事件回调。 |
审核编辑 黄宇
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。
举报投诉
-
鸿蒙
+关注
关注
57文章
2346浏览量
42826
发布评论请先 登录
相关推荐
鸿蒙ArkTS声明式开发:跨平台支持列表【分布式迁移标识】 通用属性
组件的分布式迁移标识,指明了该组件在分布式迁移场景下可以将特定状态恢复到对端设备。
鸿蒙ArkTS声明式开发:跨平台支持列表【形状裁剪】 通用属性
参数为相应类型的组件,按指定的形状对当前组件进行裁剪;参数为boolean类型时,设置是否按照父容器边缘轮廓进行裁剪。 默认值:false 从API version 9开始,该接口支持在ArkTS卡片中使用。
鸿蒙ArkTS声明式开发:跨平台支持列表【显隐控制】 通用属性
控制当前组件显示或隐藏。注意,即使组件处于隐藏状态,在页面刷新时仍存在重新创建过程,因此当对性能有严格要求时建议使用[条件渲染]代替。 默认值:Visibility.Visible 从API version 9开始,该接口支持在ArkT
鸿蒙ArkTS声明式开发:跨平台支持列表【Flex布局】 通用属性
从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
> - 仅当父组件是 Flex、Column、Row 、GridRow时生效。
鸿蒙ArkTS声明式开发:跨平台支持列表【按键事件】
按键事件指组件与键盘、遥控器等按键设备交互时触发的事件,适用于所有可获焦组件,例如Button。对于Text,Image等默认不可获焦的组件,可以设置focusable属性为true后使用按键事件。
评论