鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(菜单控制)

鸿蒙5.0版开发:ArkTS高级组件-@ohos.arkui.advanced.SelectionMenu (文本选择菜单) 文本选择菜单,适用于富文本组件通过bindSelectionMenu绑定自定义文本选择菜单....... 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


菜单控制

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

说明

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

  • CustomBuilder里不支持再使用bindMenu、bindContextMenu弹出菜单。

  • 弹出菜单的文本内容不支持长按选中。

  • 当窗口大小发生变化时,菜单自动隐藏。

  • 动效曲线使用弹簧曲线,在动效退出时,由于弹簧曲线的回弹震荡,菜单消失后有较长的拖尾,使得其他事件无法响应。

  • 若组件是可拖动节点,绑定bindContextMenu未指定preview时,菜单弹出会浮起拖拽预览图且菜单选项和预览图不会发生避让。对此,开发者可根据使用场景设置preview或者将目标节点设置成不可拖动节点。

  • 从API Version 12开始,菜单支持长按500ms弹出子菜单,支持按压态跟随手指移动。

    1. 仅支持使用Menu组件且子组件包含MenuItem或MenuItemGroup的场景。

    2. 仅支持MenuPreviewMode为NONE的菜单。

bindMenu

bindMenu(content: Array<MenuElement> | CustomBuilder, options?: MenuOptions)

给组件绑定菜单,点击后弹出菜单。弹出菜单项支持图标+文本排列和自定义两种功能。

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

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

参数:

参数名类型必填说明
contentArray<MenuElement> | CustomBuilder是配置菜单项图标和文本的数组,或者自定义组件。
optionsMenuOptions否配置弹出菜单的参数。

bindMenu11+

bindMenu(isShow: boolean, content: Array<MenuElement> | CustomBuilder, options?: MenuOptions)

给组件绑定菜单,点击后弹出菜单。弹出菜单项支持图标+文本排列和自定义两种功能。

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

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

参数:

参数名类型必填说明
isShow11+boolean是支持开发者通过状态变量控制显隐,默认值为false,menu弹窗必须等待页面全部构建才能展示,因此不能在页面构建中设置为true,否则会导致显示位置及形状错误,当前不支持双向绑定。
contentArray<MenuElement> | CustomBuilder是配置菜单项图标和文本的数组,或者自定义组件。
optionsMenuOptions否配置弹出菜单的参数。

bindContextMenu8+

bindContextMenu(content: CustomBuilder, responseType: ResponseType, options?: ContextMenuOptions)

给组件绑定菜单,触发方式为长按或者右键点击,弹出菜单项需要自定义。

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

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

参数:

参数名类型必填说明
contentCustomBuilder是自定义菜单内容构造器。
responseTypeResponseType是菜单弹出条件,长按或者右键点击。不支持鼠标长按。
optionsContextMenuOptions否配置弹出菜单的参数。

bindContextMenu12+

bindContextMenu(isShown: boolean, content: CustomBuilder, options?: ContextMenuOptions)

给组件绑定菜单,触发方式为控制绑定的isShown。

isShown为true,弹出菜单。isShown为false,隐藏菜单。弹出菜单项需要自定义。

菜单弹出不跟随点击位置,只与placement设置有关。

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

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

参数:

参数名类型必填说明
isShownboolean是支持开发者通过状态变量控制显隐,默认值为false。menu需要在页面全部构建完成后才能弹窗展示,如果在页面构建前或构建中设置为true,可能导致显示位置及形状错误、无法正常弹出显示等问题。当前不支持双向绑定,不支持长按触发拖拽。
contentCustomBuilder是自定义菜单内容构造器。
optionsContextMenuOptions否配置弹出菜单的参数。
名称类型必填描述
valueResourceStr是

菜单项文本。

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

icon10+ResourceStr否

菜单项图标。

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

enabled11+boolean否

菜单条目是否可进行交互。

默认值:true, 菜单条目可以进行交互。

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

action() => void是

点击菜单项的事件回调。

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

symbolIcon12+SymbolGlyphModifier否

设置菜单项图标。通过Modifier配置菜单项图标,配置该项时,原icon图标不显示。

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

继承自ContextMenuOptions。

名称类型必填描述
titleResourceStr否

菜单标题。

说明:

仅在content设置为Array<MenuElement> 时生效。

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

showInSubWindow11+boolean否

是否在子窗口显示菜单。

默认值:2in1设备为true,其他设备为false。

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

ContextMenuOptions10+

名称类型必填描述
offsetPosition否

菜单弹出位置的偏移量,不会导致菜单显示超出屏幕范围。

默认值:{ x: 0, y: 0 }

说明:

菜单类型为相对⽗组件区域弹出时,⾃动根据菜单位置属性 (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) 失效。

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

placementPlacement否

菜单组件优先显示的位置,当前位置显示不下时,会自动调整位置。

说明:

placement值设置为undefined、null或没有设置此选项时,按未设置placement处理,当使用bindMenu,按默认值:Placement.BottomLeft设置,当使用bindContextMenu8+,菜单跟随点击位置弹出;当使用bindContextMenu12+,按默认值:Placement.BottomLeft设置。

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

enableArrowboolean否

是否显示箭头。如果菜单的大小和位置不足以放置箭头时,不会显示箭头。

默认值:false, 不显示箭头。

说明:

enableArrow为true时,placement未设置或者值为非法值,默认在目标物上方显示,否则按照placement的位置优先显示。当前位置显示不下时,会自动调整位置,enableArrow为undefined时,不显示箭头。bindContextMenu从API version 10开始支持该属性;bindMenu从API version 12开始支持该属性。

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

arrowOffsetLength否

箭头在菜单处的偏移。偏移量必须合法且转换为具体数值时大于0才会生效,另外该值生效时不会导致箭头超出菜单四周的安全距离。

默认值:0

单位:vp

说明:

箭头距菜单四周的安全距离为菜单圆角大小与箭头宽度的一半之和。

根据配置的placement来计算是在水平还是垂直方向上偏移。

箭头在菜单水平方向时,偏移量为箭头至最左侧箭头安全距离处的距离。箭头在菜单垂直方向时,偏移量为箭头至最上侧箭头安全距离处的距离。

根据配置的placement的不同,箭头展示的默认位置不同:

在菜单不发生避让的情况下,placement设置为Placement.Top、Placement.Bottom时,箭头显示在水平方向且默认居中;

placement设置为Placement.Left、Placement.Right时,箭头显示在垂直方向且默认居中;

placement设置为Placement.TopLeft、Placement.BottomLeft时,箭头默认显示在水平方向,且距离菜单左侧边缘距离为箭头安全距离;

placement设置为Placement.TopRight、Placement.BottomRight时,箭头默认显示在水平方向,且距离菜单右侧距离为箭头安全距离;

placement设置为Placement.LeftTop、Placement.RightTop时,箭头默认显示在垂直方向,且距离菜单上侧距离为箭头安全距离;

placement设置为Placement.LeftBottom、Placement.RightBottom时,箭头默认显示在垂直方向,且距离菜单下侧距离为箭头安全距离;

bindContextMenu从API version 10开始支持该属性;bindMenu从API version 12开始支持该属性。

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

preview11+MenuPreviewMode| CustomBuilder否

长按悬浮菜单或使用bindContextMenu12+显示菜单的预览内容样式,可以为目标组件的截图,也可以为用户自定义的内容。

默认值:MenuPreviewMode.NONE, 无预览内容。

说明:

- 不支持responseType为ResponseType.RightClick时触发,如果responseType为ResponseType.RightClick,则不会显示预览内容。

- 当未设置preview参数或preview参数设置为MenuPreviewMode.NONE时,enableArrow参数生效。

- 当preview参数设置为MenuPreviewMode.IMAGE或CustomBuilder时,enableArrow为true时也不显示箭头。

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

previewAnimationOptions11+ContextMenuAnimationOptions否

控制长按预览显示动画开始倍率和结束倍率(相对预览原图比例)。

默认值:{ scale: [0.95, 1.1], transition: undefined, hoverScale: undefined }。

说明:

倍率设置参数小于等于0时,不生效。

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

onAppear() => void否

菜单弹出时的事件回调。

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

onDisappear() => void否

菜单消失时的事件回调。

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

aboutToAppear() => void否

菜单显示动效前的事件回调。

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

aboutToDisappear() => void否

菜单退出动效前的事件回调。

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

backgroundColor11+ResourceColor否

弹窗背板颜色。

默认值:Color.Transparent。

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

backgroundBlurStyle11+BlurStyle否

弹窗背板模糊材质。

默认值:BlurStyle.COMPONENT_ULTRA_THICK。

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

transition12+TransitionEffect否

设置菜单显示和退出的过渡效果。

说明:

菜单退出动效过程中,进行横竖屏切换,菜单会避让。二级菜单不继承自定义动效。弹出过程可以点击二级菜单,退出动效执行过程不允许点击二级菜单。

详细描述见TransitionEffect对象说明。

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

borderRadius12+Length | BorderRadiuses | LocalizedBorderRadiuses否

设置菜单的边框圆角半径。

默认值:2in1设备上默认值8vp,其他设备上默认值20vp。

说明:

支持百分比。

当水平方向两个圆角半径之和的最大值超出菜单宽度或垂直方向两个圆角半径之和的最大值超出菜单高度时,采用菜单默认圆角半径值。

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

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

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

名称描述
NONE不显示预览内容。
IMAGE预览内容为触发长按悬浮菜单组件的截图。

ContextMenuAnimationOptions11+

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

名称类型必填描述
scaleAnimationRange<number>否

动画开始和结束时相对预览原图缩放比例。

说明:

缩放比例需要根据实际开发场景设置,建议设置值为小于预览图宽度或布局的最大限制。

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

transition12+TransitionEffect否

设置菜单显示和退出的过渡效果。

说明:

菜单退出动效过程中,进行横竖屏切换,菜单会避让。二级菜单不继承自定义动效。弹出过程可以点击二级菜单,退出动效执行过程不允许点击二级菜单。

详细描述见TransitionEffect对象说明。

hoverScale12+AnimationRange<number>否

设置预览自定义长按场景下,浮起原组件截图的缩放动画开始和结束时相对预览原图缩放比例,且有与预览图的切换的过渡动效。

说明:

倍率设置参数小于等于0时,不生效。

bindContextMenu12+场景下,不生效。

设置transition接口时,不生效。

使用此接口且同时使用scale接口时,scale接口起始值不生效。

为保障最佳体验,最终预览图尺寸不建议小于原组件截图尺寸。当前预览动效宽高会受组件截图和自定义预览大小影响,请根据实际使用情况自行保障展示效果。

AnimationRange11+

表示动画开始和结束时相对预览原图缩放比例。

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

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

取值范围说明
[from: T, to: T]from表示动画开始时相对预览原图缩放比例,to表示动画结束时相对预览原图缩放比例。

示例

示例1(弹出普通菜单)

该示例为bindMenu通过配置MenuElement弹出普通菜单。

// xxx.ets
@Entry
@Component
struct MenuExample {
  build() {
    Column() {
      Text('click for Menu')
        .bindMenu([
          {
            value: 'Menu1',
            action: () => {
              console.info('handle Menu1 select')
            }
          },
          {
            value: 'Menu2',
            action: () => {
              console.info('handle Menu2 select')
            }
          },
        ])
    }
    .width('100%')
    .margin({ top: 5 })
  }
}

示例2(弹出自定义菜单)

该示例为bindMenu通过配置CustomBuilder弹出自定义菜单。

@Entry
@Component
struct MenuExample {
@State listData: number[] = [0, 0, 0]

@Builder MenuBuilder() {
Flex({ direction: FlexDirection.Column, justifyContent: FlexAlign.Center, alignItems: ItemAlign.Center }) {
ForEach(this.listData, (item:number, index) => {
Column() {
Row() {
Image($r("app.media.icon")).width(20).height(20).margin({ right: 5 })
Text(`Menu${index as number + 1}`).fontSize(20)
}
.width('100%')
.height(30)
.justifyContent(FlexAlign.Center)
.align(Alignment.Center)
.onClick(() => {
console.info(`Menu${index as number + 1} Clicked!`)
})

if (index != this.listData.length - 1) {
Divider().height(10).width('80%').color('#ccc')
}
}.padding(5).height(40)
})
}.width(100)
}

build() {
Column() {
Text('click for menu')
.fontSize(20)
.margin({ top: 20 })
.bindMenu(this.MenuBuilder)
}
.height('100%')
.width('100%')
.backgroundColor('#f0f0f0')
}
}

示例3(长按弹出菜单)

该示例为bindContextMenu通过配置responseType.LongPress弹出菜单。

// xxx.ets
@Entry
@Component
struct ContextMenuExample {
  @Builder MenuBuilder() {
    Flex({ direction: FlexDirection.Column, justifyContent: FlexAlign.Center, alignItems: ItemAlign.Center }) {
      Text('Test menu item 1')
        .fontSize(20)
        .width(100)
        .height(50)
        .textAlign(TextAlign.Center)
      Divider().height(10)
      Text('Test menu item 2')
        .fontSize(20)
        .width(100)
        .height(50)
        .textAlign(TextAlign.Center)
    }.width(100)
  }

  build() {
    Column() {
      Text('LongPress for menu')
    }
    .width('100%')
    .margin({ top: 5 })
    .bindContextMenu(this.MenuBuilder, ResponseType.LongPress)
  }
}

示例4(右键弹出指向型菜单)

该示例为bindContextMenu通过配置responseType.RightClick、enableArrow弹出指向型菜单。

// xxx.ets
@Entry
@Component
struct DirectiveMenuExample {
  @Builder MenuBuilder() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Text('Options')
      Divider().strokeWidth(2).margin(5).color('#F0F0F0')
      Text('Hide')
      Divider().strokeWidth(2).margin(5).color('#F0F0F0')
      Text('Exit')
    }
    .width(200)
  }

  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Column() {
        Text("DirectiveMenuExample")
          .fontSize(20)
          .width('100%')
          .height("25%")
          .backgroundColor('#F0F0F0')
          .textAlign(TextAlign.Center)
          .bindContextMenu(this.MenuBuilder, ResponseType.RightClick, {
            enableArrow: true,
            placement: Placement.Bottom
          })
      }
    }
    .width('100%')
    .height('100%')
  }
}

示例5(长按弹出菜单的截图预览样式)

该示例为bindContextMenu通过配置responseType.LongPress、preview的MenuPreviewMode类型弹出菜单预览样式。

// xxx.ets
@Entry
@Component
struct Index {
  private iconStr: ResourceStr = $r("app.media.icon")

  @Builder
  MyMenu() {
    Menu() {
      MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
      MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
      MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
    }
  }

  build() {
    Column({ space: 50 }) {
      Column() {
        Column() {
          Text('preview-image')
            .width(200)
            .height(100)
            .textAlign(TextAlign.Center)
            .margin(100)
            .fontSize(30)
            .bindContextMenu(this.MyMenu, ResponseType.LongPress,
              { preview: MenuPreviewMode.IMAGE,
                previewAnimationOptions: {scale: [0.8, 1.0]},
              })
            .backgroundColor("#ff3df2f5")
        }
      }.width('100%')
    }
  }
}

示例6(长按弹出菜单的自定义预览样式)

该示例为bindContextMenu通过配置responseType.LongPress、preview的CustomBuilder类型弹出菜单自定义预览样式。

// xxx.ets
@Entry
@Component
struct Index {
  private iconStr: ResourceStr = $r("app.media.icon")

  @Builder
  MyMenu() {
    Menu() {
      MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
      MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
      MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
    }
  }

  @Builder
  MyPreview() {
    Column() {
      Image($r('app.media.icon'))
        .width(200)
        .height(200)
    }
  }

  build() {
    Column({ space: 50 }) {
      Column() {
        Column() {
          Text('preview-builder')
            .width(200)
            .height(100)
            .textAlign(TextAlign.Center)
            .margin(100)
            .fontSize(30)
            .bindContextMenu(this.MyMenu, ResponseType.LongPress,
              {
                preview: this.MyPreview
              })
        }
      }.width('100%')
    }
  }
}

示例7(设置状态变量弹出菜单)

该示例为bindContextMenu通过配置isShown弹出菜单预览样式。

// xxx.ets
@Entry
@Component
struct Index {
private iconStr: ResourceStr = $r("app.media.icon")
@State isShown: boolean = false

@Builder
MyMenu() {
Menu() {
MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
}
}

@Builder
MyPreview() {
Column() {
Image($r('app.media.icon'))
.width(200)
.height(200)
}
}

build() {
Column({ space: 50 }) {
Column() {
Column() {
Text('preview-builder')
.width(200)
.height(100)
.textAlign(TextAlign.Center)
.margin(100)
.fontSize(30)
.bindContextMenu(this.isShown, this.MyMenu,
{
preview: this.MyPreview,
onDisappear: ()=>{
this.isShown = false;
}
})
Button('click')
.onClick(()=>{
this.isShown = true;
})
}
}.width('100%')
}
}
}

示例8(设置菜单和预览的动效)

该示例为bindContextMenu通过配置transition,实现自定义菜单以及菜单预览时的显示和退出动效。

// xxx.ets
@Entry
@Component
struct MenuExample {
  @Builder MenuBuilder() {
    Flex({ direction: FlexDirection.Column, justifyContent: FlexAlign.Center, alignItems: ItemAlign.Center }) {
      Text('Test menu item 1')
        .fontSize(12)
        .width(200)
        .height(30)
        .textAlign(TextAlign.Center)
      Divider().height(10)
      Text('Test menu item 2')
        .fontSize(12)
        .width(100)
        .height(30)
        .textAlign(TextAlign.Center)
    }.width(100)
  }
  @Builder
  MyPreview() {
    Column() {
      Image($r('app.media.icon'))
        .width(50)
        .height(50)
    }
  }
  @State isShow:boolean = false
  private iconStr: ResourceStr = $r("app.media.icon")

  @Builder
  MyMenu() {
    Menu() {
      MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
      MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
      MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
    }
  }
  build() {
    Column() {
      Button('LongPress bindContextMenu')
        .margin({ top: 15 })
        .bindContextMenu(
          this.MenuBuilder,
          ResponseType.LongPress,{
          transition: TransitionEffect.OPACITY.animation({ duration: 4000, curve: Curve.Ease }).combine(
            TransitionEffect.rotate({ z: 1, angle: 180 })),
          preview: this.MyPreview,
          previewAnimationOptions: {
            scale: [0.8, 1.0],
            transition: TransitionEffect.OPACITY.animation({ duration: 4000, curve: Curve.Ease }).combine(
              TransitionEffect.rotate({ z: 1, angle: 180 }))
          }
        })
    }
    .width('100%')
    .margin({ top: 5 })
  }
}

示例9(设置symbol类型图标)

该示例为bindMenu通过配置MenuElement的symbolIcon弹出菜单。

// xxx.ets
import { SymbolGlyphModifier } from '@kit.ArkUI';
@Entry
@Component
struct MenuExample {
  @State symbolIconModifier1: SymbolGlyphModifier = new SymbolGlyphModifier($r('sys.symbol.ohos_photo')).fontSize('24vp');
  @State symbolIconModifier2: SymbolGlyphModifier = new SymbolGlyphModifier($r('sys.symbol.ohos_photo')).fontSize('24vp');
  build() {
    Column() {
      Text('click for Menu')
    }
    .width('100%')
    .margin({ top: 5 })
    .bindMenu([
      {
        value: 'Menu1',
        symbolIcon:this.symbolIconModifier1,
        action: () => {
          console.info('handle Menu1 select')
        }
      },
      {
        value: 'Menu2',
        symbolIcon:this.symbolIconModifier2,
        action: () => {
          console.info('handle Menu2 select')
        }
      },
    ])
  }
}

示例10(设置一镜到底动效)

该示例为bindContextMenu通过配置preview中hoverScale,实现组件截图到自定义预览图的一镜到底过渡动效。

// xxx.ets
@Entry
@Component
struct Index {
  private iconStr: ResourceStr = $r("app.media.app_icon")

  @Builder
  MyMenu() {
    Menu() {
      MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
      MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
      MenuItem({ startIcon: this.iconStr, content: "菜单选项" })
    }
  }

  @Builder
  MyPreview() {
    Column() {
      Image($r('app.media.example'))
        .width(200)
        .height(200)
    }
  }

  build() {
    Column({ space: 50 }) {
      Column() {
        Column() {
          Image($r('app.media.example'))
            .width(100)
            .height(100)
            .margin(100)
            .bindContextMenu(this.MyMenu, ResponseType.LongPress,
              {
                preview: this.MyPreview,
                previewAnimationOptions: {
                  hoverScale: [1.0, 0.95]
                }
              })
        }
      }.width('100%')
    }
  }
}

鸿蒙5.0版开发:ArkTS组件-SelectionMenu 文本选择菜单,适用于富文本组件通过bindSelectionMenu绑定自定义文本选择菜单 阅读详情

相关推荐

【鸿蒙基于API 13实战开发】—— ArkUI 组件:模态弹窗 (ModelDialog)

模态(Modal)是UI组件或视图的一种状态。其在消失之前,用户只能对处于模态的组件或视图进行响应,不能操作其他非模态的组件或视图,干扰性比较强。ArkUI中可通过使用 AlertDialog 、 CustomDialog 、 ActionSheet 、 Popup 、 Menu 、 ContextMenu 等组件实现模态类弹窗能力。名称使用场景通常用来展示用户当前需要或必须关注的信息或操作。如用户操作一个敏感行为时响应一个二次确认的弹窗。当需要用户关注或确认的信息存在列表选择时使用。

shangkangba的博客 768

鸿蒙开发0基础【菜单控制(Menu)】ArkUI

当默认样式不满足开发需求时,可使用[@Builder]自定义菜单内容,通过bindMenu接口进行菜单的自定义。@Entry@Component@BuilderMenu() {MenuItem({ content: "复制", labelInfo: "Ctrl+C" })MenuItem({ content: "粘贴", labelInfo: "Ctrl+V" })@BuilderMyMenu() {Menu() {

zhenggaoxiao232的博客 349

鸿蒙HarmonyOS NEXT开发入门:从ArkUI到分布式应用实战

操作系统作为智能设备的核心软件,其架构设计决定了应用开发范式和用户体验。现代操作系统通过微内核、分布式架构等技术创新,实现了跨设备协同与性能优化,为万物互联场景提供基础支撑。在移动与物联网领域,鸿蒙HarmonyOS以其独特的分布式能力和声明式UI框架,为开发者提供了构建跨终端应用的新方案。本文聚焦HarmonyOS NEXT生态,详解ArkUI框架的声明式开发模式与组件化实践,并深入探讨分布式软总线、设备发现与数据同步等核心技术。通过实操演示环境搭建、Ability生命周期管理及跨设备迁移流程,帮助开发者

weixin_30470643的博客 617

【鸿蒙next开发】ArkUI框架:ArkTS组件-菜单控制

本文详细介绍了鸿蒙5.0开发中的菜单控制功能,包括如何为组件绑定弹出式菜单、多级菜单的使用、以及不同API版本下的新增特性。

m0_73088370的博客 834

鸿蒙基于ArkUI动画/交互事件开发常见问题(ArkTS)

问题现象一个页面底部默认显示自定义组件A,点击自定义组件A,则A消失,自定义组件B从底部出现;点击自定义组件B,则组件B消失,A从底部出现。这个效果要如何实现?解决措施可以使用transition产生组件转场动画,其参数type用来设置组件变化场景,包括新增和删除;参数translate用来设置转场时的平移效果。注意transition需要配合animateTo才能生效,动效时长、曲线、延时跟随animateTo中的配置。代码示例@Entry@Componentbuild() {if (!

2401_82546228的博客 1952

鸿蒙(HarmonyOS)性能优化实战-页面布局检查器ArkUI Inspector使用教程

DevEco Studio内置ArkUI Inspector工具,开发者可以使用ArkUI Inspector,在DevEco Studio上查看应用在真机上的UI显示效果。利用ArkUI Inspector工具,开发者可以快速定位布局问题或其他UI相关问题,同时也可以观察和了解不同组件之间的布局关系和属性,学习如何通过布局属性来控制组件的显示方式。

maniuT的博客 2128

【鸿蒙next开发】ArkUI框架:ArkTS组件-SelectionMenu

本文介绍了鸿蒙HarmonyOS 5.0中的SelectionMenu组件,用于为富文本组件提供自定义文本选择菜单功能。

m0_73088370的博客 721

电脑蓝牙与ESP32蓝牙连接,让电脑发现ESP32

让PC发现ESP32蓝牙

injre! injre~ 5451

【鸿蒙next开发】ArkUI框架:ArkTS组件-拖拽事件

本文详细介绍了鸿蒙5.0开发中的拖拽事件及其应用。

m0_73088370的博客 889

Moveit Servo学习

MoveIt Servo功能与配置指南 摘要:本文介绍了MoveIt Servo的功能特性,包括支持关节速度、末端执行器速度和位置控制,以及安全功能如奇点检查、碰撞检测等。通过示例展示了如何运行伺服控制demo,详细解析了关键节点和话题。最后以睿尔曼rml_63机器人为例,讲解了如何自定义伺服配置文件,包括环境设置、输入输出参数配置、平滑滤波器和规划场景监控等关键配置项。文章提供了从基础使用到自定义机器人配置的完整指导,帮助开发者实现高效的实时运动控制。

Fisher的博客 1179

保姆级教程:用Python脚本一键把选股结果导入通达信自选股(附完整代码)

本文提供了一份详细的Python自动化教程,教你如何将选股结果一键导入通达信自选股。通过解析通达信文件结构、编写Python脚本实现股票代码转换和批量导入,大幅提升量化交易效率。教程包含完整代码示例,特别适合使用通达信(TDX)的投资者和量化交易开发者。

weixin_30915951的博客 361

【精通篇】打造React Native鸿蒙跨平台开发高级复合组件库开发系列:基于HarmonyOS API 24 DropdownMenu 下拉菜单(向下弹出的菜单列表)

Fetch API 是WHATWG 的一个“活标准”(living standard),用规范原文说,就是“Fetch 标准定义请求、Fetch API 能够执行XMLHttpRequest 对象的所有任务,但更容易使用,接口也更现代化,能够在。Fetch API 本身是使用JavaScript 请求资源的优秀工具,同时这个API 也能够应用在服务线程。fetch()方法是暴露在全局作用域中的,包括主页面执行线程、模块和工作线程。响应,以及绑定二者的流程:获取(fetch)”。

wanmeijuhao的博客 426

基于STM32的工业I/O模块硬件电路实现

深入解析基于STM32的工业I/O模块硬件电路实现,涵盖关键电路设计与信号处理,突出硬件电路稳定性和工业级可靠性,适合嵌入式开发者参考。

weixin_35835018的博客 460

HarmonyOS 6.0+ PC端原生应用开发实战:ArkUI高阶适配与性能优化全解析

本文系统阐述了HarmonyOS 6.0+在PC端应用开发的核心技术方案。重点介绍了ArkUI框架针对PC端的三大增强特性:窗口管理能力升级(主窗样式定制、子窗协同控制、多屏坐标转换)、组件交互优化(Scroll缩放、Swiper拖拽、Text动画)以及性能提升机制(组件级diff更新、ArkTS编译优化)。

qq_58538927的博客 1273

【如何学习CAN总线测试】——AUTOSAR网络管理自动化测试(CAPL源码)

上一章介绍的是AUTOSAR网络管理如何测试、用例设计,对于不满足手工测试的同学,本章就介绍AUTOSAR网络管理自动化测试。

测试领域技术分享 6242

Arduino、ESP32驱动AS3935数字闪电传感器(闪电传感器)

闪电传感器采用AMS独具创新的AS3935数字闪电传感芯片与Coilcraft的MA5532-AE专用天线,可在室内或室外,安全地检测方圆40km范围内发生闪电的距离,闪电相对强度与统计闪电发生次数。

不脱发的程序猿 2017

深入鸿蒙OS开发:从环境搭建到真机调试全攻略,创建运行第一个鸿蒙项目

HarmonyOS,中文称鸿蒙系统或鸿蒙OS。鸿蒙系统是华为推出的面向全场景的分布式操作系统。所谓面向全场景是指它将来不光是给予手机、平板搭载,而是会对诸如电脑、车机、手表、电视、音响、眼镜及各种家电家居等等多设备都能搭载的操作系统。这就是华为所宣导的全场景智慧生活战略1+8+N(手机+8种常用设备+万物,共同协作共同参与)。

前端开发工程师 3079

2023 ICRA《Visual Language Maps for Robot Navigation》阅读笔记

视觉语言导航可以使用预先训练的现有的视觉语言模型来将图像与对象目标的自然语言描述相匹配,但它与绘制环境的过程仍然脱节,缺乏经典几何地图的空间精度。为了解决这个问题,我们提出了VLMaps,这是一种空间地图表示,它将预训练的视觉语言特征与物理世界的3D重建直接融合在一起。VLMaps可以使用标准探索方法从机器人上的视频馈送中自主构建,并在没有额外标记数据的情况下实现地图的自然语言索引。具体来说,当与大型语言模型(LLM)相结合时,VLMaps可以用于。

qq_44100524的博客 1992

React Native鸿蒙跨平台 HarmonyOS ArkTS API 24 如何实现了宠物个人资料展示、宠物管理和功能菜单等核心功能

个人中心应用(PersonalCenterApp)基于 React Native 构建,采用组件化架构设计,实现了个人资料展示、宠物管理和功能菜单等核心功能。该应用通过 React Native 的跨端映射机制,能够在鸿蒙系统上无缝运行,保持一致的用户体验。

2401_86113894的博客 1188

Dify智能体开发:Dify文件上传

相较于聊天文本,文档文件能够承载大量的信息,例如学术报告、法律合同。受限于 LLM 自身仅能够支持文件或图片,难以获取文件内更加丰富的上下文信息,应用的使用者不得不手动复制粘贴大量信息与 LLM 对话,增加了许多不必要的使用成本。

王国平的博客 2592

NTscan扫描工具

ntscan是一个扫描器,可以扫描没有密码和弱密码的共享,先到配置文件中填写猜测的用户名和密码,扫描过程中右侧出现的是扫描日志。

从零打造鸿蒙原生 Python IDE:ArkTS + N-API + PTY + CPython 全链路解析

鸿蒙原生Python IDE技术解析 项目概述 鸿蟒工坊(HongMian Workshop)是一款运行在HarmonyOS PC上的Python集成开发环境,填补了鸿蒙PC生态的开发工具空白。项目将Thonny IDE的核心功能移植到鸿蒙平台,提供代码编辑、Shell交互和完整CPython解释器支持。 技术架构 UI层:基于ArkTS/ArkUI实现编辑器界面 桥接层:使用C++/N-API实现JS与C++的通信 运行时层:嵌入CPython 3.12解释器 系统层:利用HarmonyOS内核

一键难忘的博客 3万+

C# WinForm 基于DirectShow.dll编写的程序,可边预览边保存视频,音频和图片

基于微软的DirectShow.dll的二次开发1.自动识别连接的摄像头跟麦克风且可以对其进行选择(默认选中第一个)2.可录制wmv和avi两种格式的视频并且都带有音频,avi可以录制的分辨率和帧数进行选择,wmv默认进行了淸晰度优化如不喜欢可去除代码中有相关提示3.可在预览点开之后进行拍照,也可边录制视频边拍照4.添加了视频和音频的压缩功能(酌情使用)这次二次开发发现C#对DirectShow的相关信息太少,这次做完也不敢藏私共享出来,还望大家指正

React Native鸿蒙跨平台基于HarmonyOS API 24 如何实现了宠物个人资料展示、宠物管理和功能菜单等核心功能

属性来为指定的类设置一个静态属性列表,并在类的每个实例中跳过__dict__字典的创建过程。不幸的是,这个问题不能用第 2 章“(4)保存内省的装饰器”一节介绍的方法(使用额外。Python 中的混入类是一种不应被初始化的类,而是用来向其他现有类提供某种可复用。虽然有这样的警告,但类装饰器仍然是对流行的混入(mixin)类模式的一种简单又轻。在类装饰器中这样使用闭包的主要缺点是,生成的对象不再是被装饰的类的实例,而是在。这种模式的框架之一。当然,上面的代码片段并不是很好的代码示例,因为其含义过于模糊。

2401_86113894的博客 531

IDEA的使用指南

IDEA基于java的使用手册,可以最快速的上手,在使用中不断的丰富自己的使用技巧.

jdk-8u144-linux-x64.tar.gz.

该资源为搭建Linux系统Java环境用,资源的后缀为tar.gz格式的压缩包

harmony 鸿蒙ArkUI动画/交互事件开发常见问题(ArkTS)

问题现象一个页面底部默认显示自定义组件A,点击自定义组件A,则A消失,自定义组件B从底部出现;点击自定义组件B,则组件B消失,A从底部出现。这个效果要如何实现?解决措施可以使用transition产生组件转场动画,其参数type用来设置组件变化场景,包括新增和删除;参数translate用来设置转场时的平移效果。注意transition需要配合animateTo才能生效,动效时长、曲线、延时跟随animateTo中的配置。代码示例@Entry@Componentbuild() {if (!

m0_68271787的博客 1537

【精通篇】打造React Native鸿蒙跨平台开发高级复合组件库开发系列:基于HarmonyOS API 24 Overlay 遮罩层(创建一个遮罩层)

response 在通过构造函数初始化Response 对象时激活不允许修改禁止修改的响应头部(参见MDN 文。Headers 实例中还不存在的头部上调用append()方法相当于调用set()。在初始化Headers 对象时,也可以使用键/值对形式的对象,Headers 实例会因来源不同而展现不同的行为,它们的行为由护卫来控制。不同的护卫设置会改变set()、append()和delete()的行为。一个HTTP 头部字段可以有多个值,而Headers 对象通过append()方法支持添加多个值。

wanmeijuhao的博客 281

【精通篇】打造React Native鸿蒙基于HarmonyOS API 24跨平台开发高级复合组件库开发系列:ActionSheet 动作面板(底部弹起的模态面板)

制定了JavaScript 对象简谱(JSON,JavaScript Object Notation)标准,即RFC 4627。JSON 是JavaScript 的严格子集,利用JavaScript 中的几种模式来表示结构。JavaScript 字符串与JSON 字符串的主要区别是,JSON 字符串必须使用双引号(单引号会导致语法。与JavaScript 不同,JSON 中的对象属性名必须始终带双引号。虽然这对JavaScript 开发者来说是标准的对象字面量,但JSON 中的对象必须使用双引号把属性名。

wanmeijuhao的博客 406

鸿蒙系统开发飞机大战:设计思路、技术选型与关键挑战深度剖析

清晰的架构设计、对性能瓶颈的预判、以及对鸿蒙特有能力的创造性运用,是项目成功的关键。选择跨端框架是当前降低风险的务实之举,而深耕原生开发则是为未来鸿蒙游戏生态铺路的前瞻性投资。在鸿蒙系统(HarmonyOS)上开发“飞机大战”这类2D射击游戏,其核心逻辑与传统平台类似,但开发范式、架构约束和性能特点存在显著差异。本文将聚焦鸿蒙特性,对比不同开发路径,并深入分析鸿蒙生态当前存在的关键问题与挑战,旨在提供一套以设计思路和架构决策为核心的开发指南。无论选择哪条路径,以下核心系统的设计思路需要适应鸿蒙的特点。

热爱技术与前沿创新,深耕科技领域,在科创中精进自我;探索技术乐趣,分享技术干货与成长心得,以技术为伴,热爱生活,在科创与生活中双向成长。 730
上一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(Popup控制)
下一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(焦点控制)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值