鸿蒙API13开发【列表选择弹窗 (ActionSheet)】ArkTS组件

最新推荐文章于 2025-02-12 15:49:10 发布
最新推荐文章于 2025-02-12 15:49:10 发布
阅读量840 收藏 10
点赞数 20
分类专栏： 鸿蒙开发 文章标签： harmonyos 华为 鸿蒙系统 鸿蒙 组件
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_70748845/article/details/145516373
版权

列表弹窗。

ActionSheet

show

static show(value: ActionSheetOptions)

定义列表弹窗并弹出。

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

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

参数：

参数名类型必填说明
value[ActionSheetOptions]是配置列表选择弹窗的参数。

ActionSheetOptions对象说明

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

名称类型必填说明
titlestring[Resource]是
subtitle10+[ResourceStr]否弹窗副标题。元服务API： 从API version 11开始，该接口支持在元服务中使用。
messagestring[Resource]是
autoCancelboolean否点击遮障层时，是否关闭弹窗。默认值：true值为true时，点击遮障层关闭弹窗，值为false时，点击遮障层不关闭弹窗。元服务API： 从API version 11开始，该接口支持在元服务中使用。
confirm{enabled10+?: boolean,defaultFocus10+?: boolean,style10+?: [DialogButtonStyle],value: string[Resource],action: () => void}否
cancel() => void否点击遮障层关闭dialog时的回调。元服务API： 从API version 11开始，该接口支持在元服务中使用。
alignment[DialogAlignment]否弹窗在竖直方向上的对齐方式。默认值：DialogAlignment.Bottom元服务API： 从API version 11开始，该接口支持在元服务中使用。说明：若在UIExtension中设置showInSubWindow为true, 弹窗将基于UIExtension的宿主窗口对齐。
offset{dx: numberstring[Resource],dy: number
sheetsArray<[SheetInfo]>是设置选项内容，每个选择项支持设置图片、文本和选中的回调。元服务API： 从API version 11开始，该接口支持在元服务中使用。
maskRect10+[Rectangle]否弹窗遮蔽层区域，在遮蔽层区域内的事件不透传，在遮蔽层区域外的事件透传。默认值：{ x: 0, y: 0, width: ‘100%’, height: ‘100%’ }**说明：**showInSubWindow为true时，maskRect不生效。元服务API： 从API version 11开始，该接口支持在元服务中使用。
showInSubWindow11+boolean否某弹框需要显示在主窗口之外时，是否在子窗口显示此弹窗。默认值：false，弹窗显示在应用内，而非独立子窗口。说明：showInSubWindow为true的弹窗无法触发显示另一个showInSubWindow为true的弹窗。元服务API： 从API version 12开始，该接口支持在元服务中使用。
isModal11+boolean否弹窗是否为模态窗口，模态窗口有蒙层，非模态窗口无蒙层。默认值：true，此时弹窗有蒙层。元服务API： 从API version 12开始，该接口支持在元服务中使用。
backgroundColor11+[ResourceColor]否弹窗背板颜色。默认值：Color.Transparent**说明：**当设置了backgroundColor为非透明色时，backgroundBlurStyle需要设置为BlurStyle.NONE，否则颜色显示将不符合预期效果。元服务API： 从API version 12开始，该接口支持在元服务中使用。
backgroundBlurStyle11+[BlurStyle]否弹窗背板模糊材质。默认值：BlurStyle.COMPONENT_ULTRA_THICK**说明：**设置为BlurStyle.NONE即可关闭背景虚化。当设置了backgroundBlurStyle为非NONE值时，则不要设置backgroundColor，否则颜色显示将不符合预期效果。元服务API： 从API version 12开始，该接口支持在元服务中使用。
onWillDismiss12+Callback<[DismissDialogAction]>否交互式关闭回调函数。**说明：**1.当用户执行点击遮障层关闭、左滑/右滑、三键back、键盘ESC关闭交互操作时，如果注册该回调函数，则不会立刻关闭弹窗。在回调函数中可以通过reason得到阻拦关闭弹窗的操作类型，从而根据原因选择是否能关闭弹窗。当前组件返回的reason中，暂不支持CLOSE_BUTTON的枚举值。2.在onWillDismiss回调中，不能再做onWillDismiss拦截。元服务API： 从API version 12开始，该接口支持在元服务中使用。
cornerRadius12+[Dimension][BorderRadiuses][LocalizedBorderRadiuses]
borderWidth12+[Dimension][EdgeWidths][LocalizedEdgeWidths]
borderColor12+[ResourceColor][EdgeColors][LocalizedEdgeColors]
borderStyle12+[BorderStyle][EdgeStyles]否
width12+[Dimension]否设置弹窗背板的宽度。说明：- 弹窗宽度默认最大值：400vp。- 百分比参数方式：弹窗参考宽度为所在窗口的宽度，在此基础上调小或调大。元服务API： 从API version 12开始，该接口支持在元服务中使用。
height12+[Dimension]否设置弹窗背板的高度。说明：- 弹窗高度默认最大值：0.9 *（窗口高度 - 安全区域）。- 百分比参数方式：弹窗参考高度为（窗口高度 - 安全区域），在此基础上调小或调大。元服务API： 从API version 12开始，该接口支持在元服务中使用。
shadow12+[ShadowOptions][ShadowStyle]否
transition12+[TransitionEffect]否设置弹窗显示和退出的过渡效果。**说明：**1.如果不设置，则使用默认的显示/退出动效。2.显示动效中按back键，打断显示动效，执行退出动效，动画效果为显示动效与退出动效的曲线叠加后的效果。3.退出动效中按back键，不会打断退出动效，退出动效继续执行，继续按back键退出应用。元服务API： 从API version 12开始，该接口支持在元服务中使用。
enableHoverMode14+boolean否是否响应悬停态。默认值：false，默认不响应。元服务API： 从API version 14开始，该接口支持在元服务中使用。
hoverModeArea14+[HoverModeAreaType]否悬停态下弹窗默认展示区域。默认值：HoverModeAreaType.BOTTOM_SCREEN。元服务API： 从API version 14开始，该接口支持在元服务中使用。

SheetInfo对象说明

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

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

名称类型必填说明
titlestring[Resource]是
iconstring[Resource]否
action()=>void是选项选中的回调。

DismissDialogAction12+

Dialog关闭的信息。

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

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

属性

名称类型可读可写说明
dismissCallback否否Dialog关闭回调函数。开发者需要退出时调用，不需要退出时无需调用。
reason[DismissReason]否否Dialog无法关闭原因。根据开发者需要选择不同操作下，Dialog是否需要关闭。

示例

示例1（弹出列表选择弹窗）

该示例通过点击按钮弹窗列表选择弹窗。

@Entry
@Component
struct ActionSheetExample {
  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Button('Click to Show ActionSheet')
        .onClick(() => {
          ActionSheet.show({ // 建议使用 this.getUIContext().showActionSheet()接口
            title: 'ActionSheet title',
            subtitle: 'ActionSheet subtitle',
            message: 'message',
            autoCancel: true,
            confirm: {
              defaultFocus: true,
              value: 'Confirm button',
              action: () => {
                console.log('Get Alert Dialog handled')
              }
            },
            cancel: () => {
              console.log('actionSheet canceled')
            },
              onWillDismiss:(dismissDialogAction: DismissDialogAction)=> {
                console.info("reason=" + JSON.stringify(dismissDialogAction.reason))
                console.log("dialog onWillDismiss")
                if (dismissDialogAction.reason == DismissReason.PRESS_BACK) {
                  dismissDialogAction.dismiss()
                }
                if (dismissDialogAction.reason == DismissReason.TOUCH_OUTSIDE) {
                  dismissDialogAction.dismiss()
                }
              },
            alignment: DialogAlignment.Bottom,
            offset: { dx: 0, dy: -10 },
            sheets: [
              {
                title: 'apples',
                action: () => {
                  console.log('apples')
                }
              },
              {
                title: 'bananas',
                action: () => {
                  console.log('bananas')
                }
              },
              {
                title: 'pears',
                action: () => {
                  console.log('pears')
                }
              }
            ]
          })
        })
    }.width('100%')
    .height('100%')
  }
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

示例2（可在主窗外弹出的弹窗）

该示例通过配置showInSubWindow为true弹出可以在主窗外显示的弹窗。

@Entry
@Component
struct ActionSheetExample {
  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Button('Click to Show ActionSheet')
        .onClick(() => {
          ActionSheet.show({
            title: 'ActionSheet title',
            subtitle: 'ActionSheet subtitle',
            message: 'message',
            autoCancel: true,
            showInSubWindow: true,
            isModal: true,
            confirm: {
              defaultFocus: true,
              value: 'Confirm button',
              action: () => {
                console.log('Get Alert Dialog handled')
              }
            },
            cancel: () => {
              console.log('actionSheet canceled')
            },
              onWillDismiss:(dismissDialogAction: DismissDialogAction)=> {
                console.info("reason=" + JSON.stringify(dismissDialogAction.reason))
                console.log("dialog onWillDismiss")
                if (dismissDialogAction.reason == DismissReason.PRESS_BACK) {
                  dismissDialogAction.dismiss()
                }
                if (dismissDialogAction.reason == DismissReason.TOUCH_OUTSIDE) {
                  dismissDialogAction.dismiss()
                }
              },
            alignment: DialogAlignment.Center,
            offset: { dx: 0, dy: -10 },
            sheets: [
              {
                title: 'apples',
                action: () => {
                  console.log('apples')
                }
              },
              {
                title: 'bananas',
                action: () => {
                  console.log('bananas')
                }
              },
              {
                title: 'pears',
                action: () => {
                  console.log('pears')
                }
              }
            ]
          })
        })
    }.width('100%')
    .height('100%')
  }
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

示例3（设置弹窗的动画）

该示例通过配置transition实现弹窗的显示和消失动画。

@Entry
@Component
struct ActionSheetExample {
  build() {
    Column({ space: 5 }) {
      Button('ActionSheet Set Duration')
        .onClick(() => {
            ActionSheet.show({
              title: 'ActionSheet 1',
              message: 'Set Animation Duration open 3 second, close 100 ms',
              autoCancel: true,
              alignment: DialogAlignment.Top,
              transition:TransitionEffect.asymmetric(TransitionEffect.OPACITY
                .animation({ duration: 3000, curve: Curve.Sharp }).combine(TransitionEffect.scale({x: 1.5, y: 1.5}).animation({duration: 3000, curve: Curve.Sharp})),
                TransitionEffect.OPACITY.animation({ duration: 100, curve: Curve.Smooth })
                  .combine(TransitionEffect.scale({x: 0.5, y: 0.5}).animation({duration: 100, curve: Curve.Smooth}))),
              offset: { dx: 0, dy: -20 },
              confirm: {
                value: 'button',
                action: () => {
                  console.info('Button-clicking callback')
                }
              },
              cancel: () => {
                console.info('Closed callbacks')
              },
              sheets: [
                {
                  title: 'apples',
                  action: () => {
                    console.log('apples')
                  }
                },
                {
                  title: 'bananas',
                  action: () => {
                    console.log('bananas')
                  }
                },
                {
                  title: 'pears',
                  action: () => {
                    console.log('pears')
                  }
                }
              ]
            })
        }).backgroundColor(0x317aff).height("88px")
    }.width('100%').margin({ top: 5 })
  }
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

示例4（设置弹窗的样式）

该示例定义了ActionSheet的样式，如宽度、高度、背景色、阴影等等。

@Entry
@Component
struct ActionSheetExample {
  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center }) {
      Button('Click to Show ActionSheet')
        .onClick(() => {
          ActionSheet.show({
            title: 'ActionSheet title',
            subtitle: 'ActionSheet subtitle',
            message: 'message',
            autoCancel: true,
            width: 300,
            height: 350,
            cornerRadius: 20,
            borderWidth: 1,
            borderStyle: BorderStyle.Solid,//使用borderStyle属性，需要和borderWidth属性一起使用
            borderColor: Color.Blue,//使用borderColor属性，需要和borderWidth属性一起使用
            backgroundColor: Color.White,
            shadow: ({ radius: 20, color: Color.Grey, offsetX: 50, offsetY: 0}),
            confirm: {
              defaultFocus: true,
              value: 'Confirm button',
              action: () => {
                console.log('Get Alert Dialog handled')
              }
            },
            cancel: () => {
              console.log('actionSheet canceled')
            },
            onWillDismiss:(dismissDialogAction: DismissDialogAction)=> {
              console.info("reason=" + JSON.stringify(dismissDialogAction.reason))
              console.log("dialog onWillDismiss")
              if (dismissDialogAction.reason == DismissReason.PRESS_BACK) {
                dismissDialogAction.dismiss()
              }
              if (dismissDialogAction.reason == DismissReason.TOUCH_OUTSIDE) {
                dismissDialogAction.dismiss()
              }
            },
            alignment: DialogAlignment.Bottom,
            offset: { dx: 0, dy: -10 },
            sheets: [
              {
                title: 'apples',
                action: () => {
                  console.log('apples')
                }
              },
              {
                title: 'bananas',
                action: () => {
                  console.log('bananas')
                }
              },
              {
                title: 'pears',
                action: () => {
                  console.log('pears')
                }
              }
            ]
          })
        })
    }.width('100%')
  }
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

示例5（悬停态弹窗）

该示例展示了在折叠屏悬停态下设置dialog布局区域的效果。

@Entry
@Component
struct ActionSheetExample {
  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Button('Click to Show ActionSheet')
        .onClick(() => {
          ActionSheet.show({ // 建议使用 this.getUIContext().showActionSheet()接口
            title: 'ActionSheet title',
            subtitle: 'ActionSheet subtitle',
            message: 'message',
            autoCancel: true,
            confirm: {
              defaultFocus: true,
              value: 'Confirm button',
              action: () => {
                console.log('Get Alert Dialog handled')
              }
            },
            cancel: () => {
              console.log('actionSheet canceled')
            },
            onWillDismiss:(dismissDialogAction: DismissDialogAction)=> {
              console.info("reason=" + JSON.stringify(dismissDialogAction.reason))
              console.log("dialog onWillDismiss")
              if (dismissDialogAction.reason == DismissReason.PRESS_BACK) {
                dismissDialogAction.dismiss()
              }
              if (dismissDialogAction.reason == DismissReason.TOUCH_OUTSIDE) {
                dismissDialogAction.dismiss()
              }
            },
            alignment: DialogAlignment.Bottom,
            offset: { dx: 0, dy: -10 },
            enableHoverMode: true,
            hoverModeArea: HoverModeAreaType.TOP_SCREEN,
            sheets: [
              {
                title: 'apples',
                action: () => {
                  console.log('apples')
                }
              },
              {
                title: 'bananas',
                action: () => {
                  console.log('bananas')
                }
              },
              {
                title: 'pears',
                action: () => {
                  console.log('pears')
                }
              }
            ]
          })
        })
    }.width('100%')
    .height('100%')
  }
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细鸿蒙（OpenHarmony ）手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门视频，帮助大家在技术的道路上更进一步。

  • 《鸿蒙 (OpenHarmony)开发学习视频》
  • 《鸿蒙生态应用开发V2.0白皮书》
  • 《鸿蒙 (OpenHarmony)开发基础到实战手册》
  • OpenHarmony北向、南向开发环境搭建
  • 《鸿蒙开发基础》
  • 《鸿蒙开发进阶》
  • 《鸿蒙开发实战》

在这里插入图片描述

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。

并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！ 自↓↓↓拿
1

鸿蒙OpenHarmony【列表选择弹窗 (ActionSheet)】弹窗
hhhhhh2323的博客
11-21 982
定义列表弹窗并弹出。
HarmonyOS NEXT鸿蒙开发入门，列表选择弹窗 (ActionSheet)
商城app+新闻app+备忘录记事本app视频教程在某站【浩宇软件开发】
08-12 1479
更多使用方法请查看官方API文档。
自学鸿蒙HarmonyOS的ArkTS语言＜六＞警告弹窗AlertDialog和列表选择弹窗ActionSheet
hanchengmei的博客
07-11 553
1、这两种弹窗都没有找到设置标题内容居中的属性。2、警告弹窗按钮中间的线没有办法去掉。3、选择列表弹窗按钮只能一个。
鸿蒙5.0版开发：ArkTS组件-警告弹窗 (AlertDialog)
m0_69424697的博客
11-29 723
显示警告弹窗组件，可设置文本内容与响应回调。
鸿蒙5.0开发进阶：ArkTS组件-警告弹窗 (AlertDialog)
Androidbye的博客
02-11 655
显示警告弹窗组件，可设置文本内容与响应回调。
鸿蒙5.0版开发：ArkTS组件-列表选择弹窗 (ActionSheet)
m0_69424697的博客
11-29 914
列表弹窗。
鸿蒙5.0开发进阶：ArkTS组件-列表选择弹窗 (ActionSheet)
最新发布
Androidbye的博客
02-12 760
列表弹窗。
鸿蒙Harmony应用开发—ArkTS-全局UI方法（列表选择弹窗）
m0_64420071的博客
03-21 1206
列表弹窗
【鸿蒙基于API 13实战开发】—— ArkUI 组件:模态弹窗 (ModelDialog)
shangkangba的博客
12-04 620
模态（Modal）是UI组件或视图的一种状态。其在消失之前，用户只能对处于模态的组件或视图进行响应，不能操作其他非模态的组件或视图，干扰性比较强。ArkUI中可通过使用 AlertDialog 、 CustomDialog 、 ActionSheet 、 Popup 、 Menu 、 ContextMenu 等组件实现模态类弹窗能力。名称使用场景通常用来展示用户当前需要或必须关注的信息或操作。如用户操作一个敏感行为时响应一个二次确认的弹窗。当需要用户关注或确认的信息存在列表选择时使用。
【HarmonyOS实战开发】鸿蒙内置组件详解
HarmonyOS_002的博客
07-09 1594
这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。
鸿蒙Harmony应用开发—ArkTS-全局UI方法（警告弹窗）
m0_64420071的博客
03-21 1489
使用弹窗组件时，可优先考虑自定义弹窗，便于自定义弹窗的样式与内容。
【鸿蒙开发】弹窗组件AlertDialog，ActionSheet，DatePickerDialog，TimePickerDialog，TextPickerDialog
d312697510的博客
04-08 3599
鸿蒙开发arkts，AlertDialog警告弹窗，ActionSheet列表选择弹窗，DatePickerDialog日期选择弹窗，TimePickerDialog时间选择弹窗，TextPickerDialog文本选择弹窗
鸿蒙：警告弹窗
baidu_24743861的博客
03-13 1606
显示警告弹窗组件，可设置文本内容与响应回调。说明：从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
鸿蒙NEXT开发【自定义弹框使用（CustomDialog+TextPicker组合）】
houxiliOH的博客
10-11 1821
做过移动端甚至前端开发的小伙伴想必用过弹窗功能，其实弹窗就是一种浮动窗口，主要用于在应用界面上显示额外的信息或提供用户操作选项。而在HarmonyOS开发中，弹窗分为七种类型：AlertDialog、ActionSheet、CustomDialog、CalendarPickerDialog、DatePickerDialog、TimePickerDialog和TextPickerDialog。其他六种弹窗是系统预定义的弹框，而剩下的CustomDialog弹窗是允许开发者自定义弹窗的布局和内容的。
鸿蒙通用组件弹窗简介
lvsonghai的博客
05-08 1496
鸿蒙通用组件弹窗简介
鸿蒙OpenHarmony【警告弹窗 (AlertDialog)】弹窗
hhhhhh2323的博客
11-21 1160
定义警告弹窗并弹出。
鸿蒙系列--弹窗
weixin_42277946的博客
01-09 1398
鸿蒙弹窗介绍
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值