菜单控制
为组件绑定弹出式菜单,弹出式菜单以垂直列表形式显示菜单项,可通过长按、点击或鼠标右键触发。
说明:
开发前请熟悉鸿蒙开发指导文档 :[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 | 否 | 菜单消失时的事件回调。 |
审核编辑 黄宇
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。
举报投诉
-
鸿蒙
+关注
关注
55文章
2090浏览量
42261
发布评论请先 登录
相关推荐
鸿蒙ArkTS声明式开发:跨平台支持列表【形状裁剪】 通用属性
参数为相应类型的组件,按指定的形状对当前组件进行裁剪;参数为boolean类型时,设置是否按照父容器边缘轮廓进行裁剪。 默认值:false 从API version 9开始,该接口支持在ArkTS卡片中使用。
鸿蒙ArkTS声明式开发:跨平台支持列表【显隐控制】 通用属性
控制当前组件显示或隐藏。注意,即使组件处于隐藏状态,在页面刷新时仍存在重新创建过程,因此当对性能有严格要求时建议使用[条件渲染]代替。 默认值:Visibility.Visible 从API version 9开始,该接口支持在ArkT
鸿蒙ArkTS声明式开发:跨平台支持列表【按键事件】
按键事件指组件与键盘、遥控器等按键设备交互时触发的事件,适用于所有可获焦组件,例如Button。对于Text,Image等默认不可获焦的组件,可以设置focusable属性为true后使用按键事件。
鸿蒙ArkTS的起源和简介
新的声明式开发范式,基于Skia的自绘制引擎构建可跨平台的独立的渲染能力。这是一种较为创新的方案,不过也有几点不足:
Dart语言生态。尽管
发表于 01-16 16:23
鸿蒙 OS 应用开发初体验
的操作系统平台和开发框架。HarmonyOS 的目标是实现跨设备的无缝协同和高性能。
DevEco Studio
对标 Android Studio,开发
发表于 11-02 19:38
OpenHarmony 应用开发SDK、API 与基础工具
一、整体说明
ArkTS 语言是鸿蒙系统主推的应用开发语言。因此鸿蒙系统提供给开发者的 API 绝大部分也是
发表于 09-19 15:45
评论