鸿蒙5.0开发进阶:ArkTS组件-警告弹窗 (AlertDialog)

HarmonyOS系统开发ArkTS常用组件弹窗及参数(十) 弹窗是移动应用中常见的一种用户界面元素,常用于显示一些重要的信息、提示用户进行操作或收集用户输入。ArkTS提供了多种内置的弹窗供开发者使用,除此之外还支持自定义弹窗,来满足各种不同的需求。 阅读详情

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


警告弹窗 (AlertDialog)

显示警告弹窗组件,可设置文本内容与响应回调。

说明

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

本模块功能依赖UI的执行上下文,不可在UI上下文不明确的地方使用,参见UIContext说明。

从API version 10开始,可以通过使用UIContext中的showAlertDialog来明确UI的执行上下文。

AlertDialog

show

static show(value: AlertDialogParamWithConfirm | AlertDialogParamWithButtons | AlertDialogParamWithOptions)

定义警告弹窗并弹出。

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

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

参数:

参数名类型必填说明
valueAlertDialogParamWithConfirm | AlertDialogParamWithButtons | AlertDialogParamWithOptions10+是定义并显示AlertDialog组件。

AlertDialogParam对象说明

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

名称类型必填说明
titleResourceStr否

弹窗标题。

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

subtitle10+ResourceStr否

弹窗副标题。

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

messageResourceStr是

弹窗内容。

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

autoCancelboolean否

点击遮障层时,是否关闭弹窗,true表示关闭弹窗。false表示不关闭弹窗。

默认值:true

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

cancel() => void否

点击遮障层关闭dialog时的回调。

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

alignmentDialogAlignment否

弹窗在竖直方向上的对齐方式。

默认值:DialogAlignment.Default

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

说明:

若在UIExtension中设置showInSubWindow为true, 弹窗将基于UIExtension的宿主窗口对齐。

offsetOffset否

弹窗相对alignment所在位置的偏移量。

默认值:{ dx: 0 , dy: 0 }

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

gridCountnumber否

弹窗容器宽度所占用栅格数。

默认值:4

元服务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+BorderRadiuses | Dimension | LocalizedBorderRadiuses否

设置背板的圆角半径。

可分别设置4个圆角的半径。

默认值:{ topLeft: '32vp', topRight: '32vp', bottomLeft: '32vp', bottomRight: '32vp' }

圆角大小受组件尺寸限制,最大值为组件宽或高的一半,若值为负,则按照默认值处理。

百分比参数方式:以父元素弹窗宽和高的百分比来设置弹窗的圆角。

说明:

当cornerRadius属性类型为LocalizedBorderRadiuses时,支持随语言习惯改变布局顺序。

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

transition12+TransitionEffect否

设置弹窗显示和退出的过渡效果。

说明:

1.如果不设置,则使用默认的显示/退出动效。

2.显示动效中按back键,打断显示动效,执行退出动效,动画效果为显示动效与退出动效的曲线叠加后的效果。

3.退出动效中按back键,不会打断退出动效,退出动效继续执行,继续按back键退出应用。

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

width12+Dimension否

设置弹窗背板的宽度。

说明:

- 弹窗宽度默认最大值:400vp。

- 百分比参数方式:弹窗参考宽度为所在窗口的宽度,在此基础上调小或调大。

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

height12+Dimension否

设置弹窗背板的高度。

说明:

- 弹窗高度默认最大值:0.9 *(窗口高度 - 安全区域)。

- 百分比参数方式:弹窗参考高度为(窗口高度 - 安全区域),在此基础上调小或调大。

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

borderWidth12+Dimension | EdgeWidths | LocalizedEdgeWidths否

可分别设置4个边框宽度。

默认值:0

百分比参数方式:以父元素弹窗宽的百分比来设置弹窗的边框宽度。

当弹窗左边框和右边框大于弹窗宽度,弹窗上边框和下边框大于弹窗高度,显示可能不符合预期。

说明:

当borderWidth属性类型为LocalizedEdgeWidths时,支持随语言习惯改变布局顺序。

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

borderColor12+ResourceColor | EdgeColors | LocalizedEdgeColors否

设置弹窗背板的边框颜色。

默认值:Color.Black

如果使用borderColor属性,需要和borderWidth属性一起使用。说明:

当borderColor属性类型为LocalizedEdgeColors时,支持随语言习惯改变布局顺序。

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

borderStyle12+BorderStyle | EdgeStyles否

设置弹窗背板的边框样式。

默认值:BorderStyle.Solid

如果使用borderStyle属性,需要和borderWidth属性一起使用。

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

shadow12+ShadowOptions | ShadowStyle否

设置弹窗背板的阴影。

当设备为2in1时,默认场景下获焦阴影值为ShadowStyle.OUTER_FLOATING_MD,失焦为ShadowStyle.OUTER_FLOATING_SM

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

textStyle12+TextStyle否

设置弹窗message内容的文本样式。

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

AlertDialogParamWithConfirm对象说明

继承自AlertDialogParam。

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

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

名称类型必填说明
confirm

{

enabled10+?: boolean,

defaultFocus10+?: boolean,

style10+?: DialogButtonStyle,

value: ResourceStr,

fontColor?: ResourceColor,

backgroundColor?: ResourceColor,

action: () => void

}

否

确认Button的使能状态、默认焦点、按钮风格、文本内容、文本色、按钮背景色和点击回调。在弹窗获焦且未进行tab键走焦时,该按钮默认响应Enter键,且多重弹窗可自动获焦连续响应。默认响应Enter键能力在defaultFocus为true时不生效。

enabled:点击Button是否响应,true表示Button可以响应,false表示Button不可以响应。

默认值:true

defaultFocus:设置Button是否是默认焦点,true表示Button是默认焦点,false表示Button不是默认焦点。

默认值:false

style:设置Button的风格样式。

默认值:DialogButtonStyle.DEFAULT。

value:Button文本内容。

fontColor:Button文本颜色。

backgroundColor:Button背景颜色。

action: Button选中时的回调。

confirm参数优先级:fontColor、backgroundColor > style > defaultFocus

backgroundColorfontColorstyledefaultFocus效果
绿底红字--绿底红字
绿底-DialogButtonStyle.HIGHLIGHT-绿底白字
绿底-DialogButtonStyle.DEFAULT-绿底蓝字
绿底--TRUE绿底白字
绿底--FALSE/-绿底蓝字
-红字DialogButtonStyle.HIGHLIGHT-蓝底红字
-红字DialogButtonStyle.DEFAULT-白底红字
-红字-TRUE蓝底红字
-红字-FALSE/-白底红字
--DialogButtonStyle.HIGHLIGHT-蓝底白字
--DialogButtonStyle.DEFAULT-白底蓝字
---TRUE蓝底白字
---FALSE/-白底蓝字

AlertDialogParamWithButtons对象说明

继承自AlertDialogParam。

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

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

名称类型必填说明
primaryButton

{

enabled10+?: boolean,

defaultFocus10+?: boolean,

style10+?: DialogButtonStyle,

value: ResourceStr,

fontColor?: ResourceColor,

backgroundColor?: ResourceColor,

action: () => void;

}

是

确认Button的使能状态、默认焦点、按钮风格、文本内容、文本色、按钮背景色和点击回调。在弹窗获焦且未进行tab键走焦时,该按钮默认响应Enter键,且多重弹窗可自动获焦连续响应。默认响应Enter键能力在defaultFocus为true时不生效。

enabled:点击Button是否响应。

默认值:true

defaultFocus:设置Button是否是默认焦点。

默认值:false

style:设置Button的风格样式。

默认值:DialogButtonStyle.DEFAULT。

value:Button文本内容。

fontColor:Button文本颜色。

backgroundColor:Button背景颜色。

action: Button选中时的回调。

secondaryButton

{

enabled10+?: boolean,

defaultFocus10+?: boolean,

style10+?: DialogButtonStyle,

value: ResourceStr,

fontColor?: ResourceColor,

backgroundColor?: ResourceColor,

action: () => void;

}

是

确认Button的使能状态、默认焦点、按钮风格、文本内容、文本色、按钮背景色和点击回调。

enabled:点击Button是否响应。

默认值:true。

defaultFocus:设置Button是否是默认焦点。

默认值:false。

style:设置Button的风格样式。

默认值:DialogButtonStyle.DEFAULT。

value:Button文本内容。

fontColor:Button文本颜色。

backgroundColor:Button背景颜色。

action: Button选中时的回调。

AlertDialogParamWithOptions10+对象说明

继承自AlertDialogParam。

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

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

名称类型必填说明
buttons10+Array<AlertDialogButtonOptions>是弹窗容器中的多个按钮。
buttonDirection10+DialogButtonDirection否按钮排布方向默认值为DialogButtonDirection.AUTO,建议3个以上按钮使用Auto模式(两个以上按钮会切换为纵向模式,通常能显示更多按钮),非Auto模式下,3个以上按钮可能会显示不全,超出显示范围的按钮会被截断。

AlertDialogButtonOptions10+对象说明

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

名称类型必填说明
enabledboolean否

点击Button是否响应,默认值true。

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

defaultFocusboolean否

设置Button是否是默认焦点,默认值false。

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

styleDialogButtonStyle否

设置Button的风格样式,默认值DialogButtonStyle.DEFAULT。

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

valueResourceStr是

Button的文本内容,若值为null,则该按钮不显示。

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

fontColorResourceColor否

Button的文本颜色。

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

backgroundColorResourceColor否

Button背景颜色。

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

action() => void是

Button选中时的回调。

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

primary12+boolean否

在弹窗获焦且未进行tab键走焦时,按钮是否默认响应Enter键。多个Button时,只允许一个Button的该字段配置为true,否则所有Button均不响应。多重弹窗可自动获焦连续响应。在defaultFocus为true时不生效。

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

DialogButtonDirection10+枚举说明

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

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

名称描述
AUTO两个及以下按钮水平排布,两个以上为竖直排布。
HORIZONTAL按钮水平布局。
VERTICAL按钮竖直布局。

DialogAlignment枚举说明

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

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

名称描述
Top垂直顶部对齐。
Center垂直居中对齐。
Bottom垂直底部对齐。
Default默认对齐。
TopStart8+左上对齐。
TopEnd8+右上对齐。
CenterStart8+左中对齐。
CenterEnd8+右中对齐。
BottomStart8+左下对齐。
BottomEnd8+右下对齐。

Rectangle8+类型说明

Rectangle是各种Dialog中maskRect参数的类型。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

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

名称类型必填说明
xLength否

弹窗遮蔽层区域相对于窗口左上角的x轴坐标。

默认值:0vp

yLength否

弹窗遮蔽层区域相对于窗口左上角的y轴坐标。

默认值:0vp

widthLength否

弹窗遮蔽层区域的宽度。

默认值:'100%'

heightLength否

弹窗遮蔽层区域的高度。

默认值:'100%'

说明

x和y可以设置正负值百分比。当x设置为'100%'时表示遮蔽层区域往右偏移窗口本身宽度大小,当x设置为'-100%'时表示遮蔽层区域往左偏移窗口本身宽度大小。当y设置为'100%'时表示遮蔽层区域往下偏移窗口本身高度大小,当y设置为'-100%'时表示遮蔽层区域往上偏移窗口本身高度大小。

width和height只能设置正值,支持百分比,如果设置为负值,那么该值将被重置为默认值。

百分比相对于窗口自身宽高进行计算。

DismissDialogAction12+

Dialog关闭的信息。

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

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

属性

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

TextStyle12+对象说明

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

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

名称类型必填说明
wordBreakWordBreak否

弹窗message内容的文本截断方式。

默认值:WordBreak.BREAK_ALL

示例

示例1(弹出多个按钮的弹窗)

说明

直接使用AlertDialog可能导致实例不明确的问题,建议使用getUIContext获取UIContext实例,并使用showAlertDialog调用绑定实例的AlertDialog.show()。

该示例实现了分别弹出一、二、三个按钮的弹窗。

// xxx.ets
@Entry
@Component
struct AlertDialogExample {
  build() {
    Column({ space: 5 }) {
      Button('one button dialog')
        .onClick(() => {
          // 建议使用this.getUIContext().showAlertDialog()
          AlertDialog.show(
            {
              title: 'title',
              message: 'text',
              autoCancel: true,
              alignment: DialogAlignment.Bottom,
              offset: { dx: 0, dy: -20 },
              gridCount: 3,
              confirm: {
                value: 'button',
                action: () => {
                  console.info('Button-clicking callback')
                }
              },
              cancel: () => {
                console.info('Closed callbacks')
              },
              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()
                }
              }
            }
          )
        })
        .backgroundColor(0x317aff)
      Button('two button dialog')
        .onClick(() => {
          // 建议使用this.getUIContext().showAlertDialog()
          AlertDialog.show(
            {
              title: 'title',
              subtitle: 'subtitle',
              message: 'text',
              autoCancel: true,
              alignment: DialogAlignment.Bottom,
              gridCount: 4,
              offset: { dx: 0, dy: -20 },
              primaryButton: {
                value: 'cancel',
                action: () => {
                  console.info('Callback when the first button is clicked')
                }
              },
              secondaryButton: {
                enabled: true,
                defaultFocus: true,
                style: DialogButtonStyle.HIGHLIGHT,
                value: 'ok',
                action: () => {
                  console.info('Callback when the second button is clicked')
                }
              },
              cancel: () => {
                console.info('Closed callbacks')
              },
              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()
                }
              }
            }
          )
        }).backgroundColor(0x317aff)
        Button('three button dialog')
        .onClick(() => {
          // 建议使用this.getUIContext().showAlertDialog()
          AlertDialog.show(
            {
              title: 'title',
              subtitle: 'subtitle',
              message: 'text',
              autoCancel: true,
              alignment: DialogAlignment.Bottom,
              gridCount: 4,
              offset: { dx: 0, dy: -20 },
              buttonDirection: DialogButtonDirection.HORIZONTAL,
              buttons: [
                {
                  value: '按钮',
                  action: () => {
                    console.info('Callback when button1 is clicked')
                  }
                },
                {
                  value: '按钮',
                  action: () => {
                    console.info('Callback when button2 is clicked')
                  }
                },
                {
                  value: '按钮',
                  enabled: true,
                  defaultFocus: true,
                  style: DialogButtonStyle.HIGHLIGHT,
                  action: () => {
                    console.info('Callback when button3 is clicked')
                  }
                },
              ],
              cancel: () => {
                console.info('Closed callbacks')
              },
              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()
                }
              }
            }
          )
        }).backgroundColor(0x317aff)
    }.width('100%').margin({ top: 5 })
  }
}

示例2(可在主窗外弹出的弹窗)

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

说明

直接使用AlertDialog可能导致实例不明确的问题,建议使用getUIContext获取UIContext实例,并使用showAlertDialog调用绑定实例的AlertDialog.show()。

// xxx.ets
@Entry
@Component
struct AlertDialogExample {
  build() {
    Column({ space: 5 }) {
      Button('one button dialog')
        .onClick(() => {
          // 建议使用this.getUIContext().showAlertDialog()
          AlertDialog.show(
            {
              title: 'title',
              subtitle: 'subtitle',
              message: 'text',
              autoCancel: true,
              alignment: DialogAlignment.Center,
              gridCount: 4,
              showInSubWindow: true,
              isModal: true,
              offset: { dx: 0, dy: -20 },
              buttonDirection: DialogButtonDirection.HORIZONTAL,
              buttons: [
                {
                  value: '按钮',
                  action: () => {
                    console.info('Callback when button1 is clicked')
                  }
                },
                {
                  value: '按钮',
                  action: () => {
                    console.info('Callback when button2 is clicked')
                  }
                },
                {
                  value: '按钮',
                  enabled: true,
                  defaultFocus: true,
                  style: DialogButtonStyle.HIGHLIGHT,
                  action: () => {
                    console.info('Callback when button3 is clicked')
                  }
                },
              ],
              cancel: () => {
                console.info('Closed callbacks')
              },
              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()
                }
              }
            })
        })
    }.width('100%').margin({ top: 5 }).backgroundColor(0x317aff)
  }
}

示例3(设置弹窗的动画)

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

说明

直接使用AlertDialog可能导致实例不明确的问题,建议使用getUIContext获取UIContext实例,并使用showAlertDialog调用绑定实例的AlertDialog.show()。

// xxx.ets
@Entry
@Component
struct AlertDialogExample {
  build() {
    Column({ space: 5 }) {
      Button('AlertDialog Set Duration')
        .onClick(()=>{
            // 建议使用this.getUIContext().showAlertDialog()
            AlertDialog.show(
              {
                title: 'AlertDialog 1',
                message: 'Set Animation Duration open 3 second, close 100ms',
                autoCancel: true,
                alignment: DialogAlignment.Top,
                offset: { dx: 0, dy: -20 },
                gridCount: 3,
                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}))),
                confirm: {
                  value: 'button',
                  action: () => {
                    console.info('Button-clicking callback')
                  }
                },
                cancel: () => {
                  console.info('Closed callbacks')
                }
              }
            )
        })
        .backgroundColor(0x317aff).height("88px")
    }.width('100%').margin({ top: 5 })
  }
}

示例4(设置弹窗的样式)

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

说明

直接使用AlertDialog可能导致实例不明确的问题,建议使用getUIContext获取UIContext实例,并使用showAlertDialog调用绑定实例的AlertDialog.show()。

// xxx.ets
@Entry
@Component
struct AlertDialogExample {
  build() {
    Column({ space: 5 }) {
      Button('one button dialog')
        .onClick(() => {
          // 建议使用this.getUIContext().showAlertDialog()
          AlertDialog.show(
            {
              title: 'title',
              message: 'text',
              autoCancel: true,
              alignment: DialogAlignment.Center,
              offset: { dx: 0, dy: -20 },
              gridCount: 3,
              width: 300,
              height: 200,
              cornerRadius: 20,
              borderWidth: 1,
              borderStyle: BorderStyle.Dashed,//使用borderStyle属性,需要和borderWidth属性一起使用
              borderColor: Color.Blue,//使用borderColor属性,需要和borderWidth属性一起使用
              backgroundColor: Color.White,
              shadow: ({ radius: 20, color: Color.Grey, offsetX: 50, offsetY: 0}),
              textStyle: { wordBreak: WordBreak.BREAK_ALL },
              confirm: {
                value: 'button',
                action: () => {
                  console.info('Button-clicking callback')
                }
              },
              cancel: () => {
                console.info('Closed callbacks')
              },
              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()
                }
              }
            }
          )
        })
        .backgroundColor(0x317aff)
    }.width('100%').margin({ top: 5 })
  }
}

鸿蒙Harmony应用开发—ArkTS-全局UI方法(警告弹窗) 显示警告弹窗组件,可设置文本内容与响应回调。 阅读详情

相关推荐

鸿蒙OpenHarmony【警告弹窗 (AlertDialog)】弹窗

定义警告弹窗并弹出。

hhhhhh2323的博客 1385

HarmonyOS鸿蒙开发入门,警告弹窗 (AlertDialog)

本文介绍了HarmonyOS中AlertDialog警告弹窗的使用方法。通过AlertDialog.show静态方法可显示弹窗,支持配置标题、副标题、内容、对齐方式等属性,并提供了三种参数类型:AlertDialogParamWithConfirm(确认按钮)、AlertDialogParamWithButtons(主/次按钮)和AlertDialogParamWithOptions。示例代码演示了如何创建包含确认/取消按钮的底部对齐弹窗,设置按钮样式和点击事件,并禁止点击遮罩层关闭弹窗。运行效果展示了弹窗

商城app+新闻app+备忘录记事本app视频教程在某站【浩宇软件开发】 2765

鸿蒙5.0版开发:ArkTS组件-警告弹窗 (AlertDialog)

显示警告弹窗组件,可设置文本内容与响应回调。

m0_69424697的博客 1096

HarmonyOS ArkTS 应用添加弹窗(八)

在我们日常使用应用的时候,可能会进行一些敏感的操作,比如删除联系人,这时候我们给应用添加弹窗来提示用户是否需要执行该操作,如下图所示:弹窗是一种模态窗口,通常用来展示用户当前需要的或用户必须关注的信息或操作。在弹出框消失之前,用户无法操作其他界面内容。确认类:例如警告弹窗AlertDialog。选择类:包括文本选择弹窗TextPickerDialog 、日期滑动选择弹窗DatePickerDialog、时间滑动选择弹窗TimePickerDialog等。您可以根据业务场景,选择不同类型的弹窗。

陈志宝‑天津|Android&Java 全栈开发工程师 4417

HarmonyOS实战开发-实现自定义弹窗

本篇Codelab基于ArkTS的声明式开发范式实现了三种不同的弹窗,第一种直接使用公共组件,后两种使用CustomDialogController实现自定义弹窗,效果如图所示

2401_82546228的博客 1774

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

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

shangkangba的博客 768

【鸿蒙next开发】ArkUI框架:ArkTS组件-警告弹窗 (AlertDialog)

本文详细介绍了鸿蒙HarmonyOS中AlertDialog组件的开发使用,涵盖API版本7至12的功能特性。

m0_73088370的博客 1337

鸿蒙开发实战:5种弹窗组件的使用场景与代码示例(HarmonyOS 3.0)

本文深入解析HarmonyOS 3.0中5种核心弹窗组件的使用场景与代码实现,包括Toast提示、AlertDialog、ActionSheet、选择器及自定义弹窗。通过实战示例和性能优化技巧,帮助开发者提升鸿蒙应用的用户交互体验与开发效率。

weixin_30832143的博客 528

鸿蒙API13开发【警告弹窗 (AlertDialog)】ArkTS组件

显示警告弹窗组件,可设置文本内容与响应回调。

鸿蒙的技术博客 1335

OpenHarmony实战开发-如何使用不同的弹窗。

应用中经常用到弹窗,比如警告弹窗、日期选择弹窗、文本选择弹窗以及其他自定义弹窗等等。本例将为大家介绍如何使用不同的弹窗。

2401_82546228的博客 1286

OpenHarmony开发实战:构建多种样式弹窗(ArkTS),2024年最新鸿蒙面试2024

点击兴趣爱好选项,通过customDialogController.open方法弹出自定义弹窗,根据需要选择相应的兴趣爱好,效果如图所示:在view目录下,点击鼠标右键 > New > ArkTS File,新建一个ArkTS文件,然后命名为CustomDialogWeight子组件。在CustomDialogWeight的aboutToAppear方法,通过manager.getStringArrayValue方法获取本地资源数据进行初始化。return;if (!

2301_82243558的博客 949

鸿蒙API14开发【警告弹窗 (AlertDialog)】ArkTS组件

本文介绍了AlertDialog组件的基本功能和使用方法。该组件用于显示警告弹窗,支持设置文本内容和回调响应。主要API是show()方法,可接收三种参数类型(AlertDialogParamWithConfirm/Buttons/Options)来定义弹窗内容。弹窗支持配置标题、副标题(API 10+)和消息内容,这些参数均为可选。该组件从API 11起支持原子化服务,系统能力要求为SystemCapability.ArkUI.ArkUI.Full。通过不同参数组合,开发者可以灵活创建包含确认按钮、多个按

bbq的博客 926

PLC模拟量输入电路设计:±10V与±20mA信号调理全解析

在工业自动化和数据采集系统中,模拟量输入是连接物理世界与数字控制的核心桥梁。无论是变送器输出的4-20mA电流环,还是伺服驱动与信号发生器提供的±10V电压信号,PLC和采集模块都需要在复杂现场环境下稳定、精准地完成信号采集。理解信号体制的原理——电流环抗长线干扰、电压环响应快——是设计模拟输入前端的基础。通过精密电阻网络实现分压与采样,利用运放完成双极性到单极性的电平搬移,配合TVS与滤波电路保障可靠性,并经过ADC量化与校准流程,最终构建出兼顾精度、成本和工业级鲁棒性的完整信号链路。本文面向硬件工程师与

weixin_29163797的博客 302

HarmonyOS开发 弹窗组件

当现有组件不满足要求时,可考虑自定义弹窗,自定义弹窗允许开发者自定义弹窗内容和样式。例如build() {Text('请输入你的答案')TextInput({ placeholder: '请输入数字' })})Button('取消')})Button('确认').onClick(() => {})// }}),})/*** 自定义弹窗*/

qq_36158551的博客 1274

ERGM指数随机图模型全解析:从基础原理到R语言实操

从社交网络中的互惠、传递性和同质性等基本现象切入,介绍网络数据与传统回归分析的本质差异——边与边之间的依赖关系。指数随机图模型(ERGM)正是为刻画这种依赖结构而设计的统计框架,它通过指数族分布将网络结构效应显式建模,结合MCMC方法完成参数估计。ERGM在组织协作、传播扩散、生物生态等领域的应用日益广泛,其扩展模型TERGM、GERGM和多层ERGM进一步支持时序、权重与多重关系网络。本文系统梳理ERGM的理论基础、核心统计量、扩展模型选型及R语言实操要点,帮助研究者理解网络生成机制并完成收敛性诊断与结果

weixin_29050271的博客 365

tft_espi 中文字体及自定义字体制作(tft.eSPI模块)

tft.eSPI库自定义字体方法 先下载 processing 然后安装到mixly安装目录下找到tft_eSPI文件夹。

琢磨侠的博客 2764

鸿蒙应用开发从入门到实战(二十):ArkUI内置弹窗组件

弹窗是移动应用中常见的一种用户界面元素,常用于显示一些重要的信息、提示用户进行操作或收集用户输入。ArkTS提供了多种内置的弹窗供开发者使用,除此之外还支持自定义弹窗,来满足各种不同的需求。

潘Sir的经验分享,带你少走弯路! 1100

避开这些坑!医疗影像数据增强的6个安全操作指南(附PyTorch代码)

本文详细介绍了医疗影像数据增强的六大安全准则,包括解剖结构守恒、密度值物理意义保留和病灶特征保护等关键原则,并提供了PyTorch实战代码。通过具体案例和参数建议,帮助开发者在肺结节检测和MRI分割等医疗AI应用中实现安全有效的数据增强,避免因不当操作导致的诊断误差。

cola5的博客 556

鸿蒙 ArkTS 实战:弹窗演示 DialogDemo

画板(Drawing Board)是一款自由绘画创作工具,支持多种画笔工具、颜色选择、笔画粗细调整、撤销重做、背景色切换和图片导出功能。该应用以HarmonyOS NEXT的ArkTS框架为基础,深入展示了手势识别与触摸事件处理、自定义绘制Canvas、绘制数据结构设计、命令模式(撤销/重做)、多工具绘制模式和图片导出等关键技术。绘制数据结构:基于DrawAction的数据结构,记录每次绘制的工具、颜色、粗细和路径点。Canvas绘制引擎:支持画笔、直线、矩形、圆形、箭头和橡皮擦6种工具。

2403_87838053的博客 224

Delphi开发者必备:CEF4Delphi跨平台浏览器嵌入实战指南(含Lazarus适配)

本文详细介绍了Delphi开发者如何利用CEF4Delphi实现跨平台浏览器嵌入,包括环境配置、Lazarus适配、ARM架构优化及Firemonkey集成等实战技巧。通过Chromium引擎的强大功能,开发者可以轻松为传统桌面应用添加现代浏览器特性,提升多平台开发效率。

weixin_29233333的博客 230

嵌入式Linux Qt应用程序卡死问题分析记录

根据应用和系统层面的分析,软件功能异常和卡死现象的原因是系统控制台/dev/console阻塞导致依赖其的相关应用和命令异常。系统控制台/dev/console阻塞的原因还未确定,最近的软件版本和其他测试同事未出现该问题,所以很大可能是串口线的问题,待后续有进展了继续更新。

V10_x的博客 1649

鸿蒙原生 ArkTS 弹窗布局深度解析:AlertDialog 与 CustomDialog 全场景对比实战

本文对比分析了鸿蒙ArkTS中AlertDialog和CustomDialog两种弹窗组件的特性与应用场景。AlertDialog作为系统级弹窗,适合标准化提示场景,采用函数式调用,配置简单但自定义能力有限;CustomDialog则通过声明式组件方案实现完全自定义,支持复杂交互和状态管理。文章从定义方式、UI自定义、表单交互等六个维度进行对比,并提供了典型场景的代码实现,指出AlertDialog适用于轻量提示,而CustomDialog更适合登录、设置等复杂交互场景。通过实际Demo展示了两种弹窗在实际

m0_67000457的博客 397

保姆级教程:用ROS2 Humble和Nav2从零搭建一个能自主导航的机器人小车(含SLAM建图与避障)

本文提供了一份详细的保姆级教程,指导如何使用ROS2 Humble和Nav2从零搭建一个具备自主导航功能的机器人小车,包括SLAM建图与避障。教程涵盖了硬件组装、ROS2环境配置、URDF模型创建、SLAM建图实战、Nav2导航栈配置以及系统集成调试等关键步骤,适合机器人开发初学者和进阶开发者。

weixin_30329623的博客 493

【HarmonyOS 4.0 应用开发实战】ArkTS 快速入门之常用属性(3)

按钮 概述 Button为按钮组件,通常用于响应用户的点击操作。 参数 Button组件有两种使用方式,分别是不包含子组件和包含子组件,两种方式下,Button 组件所需的参数有所不同,下面分别介绍 ● 不包含子组件 不包含子组件时,Button组件所需的参数如下

鱼干的博客 3562

使用 vLLM 和 YaRN 扩展技术部署 Qwen3-32B 大模型:实现 80K 长文本推理

vLLM 是一个高性能的 LLM 推理和服务引擎,以其高效的注意力机制(PagedAttention)和优异的内存管理著称。它提供了与 OpenAI API 兼容的接口,使得现有应用可以无缝迁移。通过vLLM与YaRN技术的结合,我们成功将Qwen3-32B的上下文处理能力从32K扩展到80K,为长文本应用场景提供了强大的技术支持。这种部署方案兼具高效性和实用性,是处理大模型长上下文需求的优选方案。随着硬件和算法的不断进步,我们期待看到更大上下文窗口的模型服务成为可能。延伸阅读vLLM官方文档。

Ven%的博客 1750

霍尼韦尔SoftMaster使用说明

霍尼韦尔SoftMaster使用说明

自学鸿蒙HarmonyOS的ArkTS语言<六>警告弹窗AlertDialog和列表选择弹窗ActionSheet

1、这两种弹窗都没有找到设置标题内容居中的属性。2、警告弹窗按钮中间的线没有办法去掉。3、选择列表弹窗按钮只能一个。

hanchengmei的博客 870

计算机控制技术及应用

《计算机控制技术及应用》通过总结作者的科研成果和吸收国内外的先进理论、方法和技术,以计算机控制系统的网络化、开放化、智能化和集成化发展趋势为主线索,主要介绍计算机控制系统的基本概念和计算机控制系统的典型形式,计算机控制系统的数学描述与基本分析方法,以及数字PID控制器、最少拍控制系统、达林算法、状态变量设计法等设计方法及其各种改进算法。重点突出计算机控制系统输入输出通道接口的设计方法和典型控制系统的设计案例与实现方法等。

上一篇: 鸿蒙5.0开发进阶:ArkTS组件-显式动画立即下发 (animateToImmediately)
下一篇: 鸿蒙5.0开发进阶:ArkTS组件-列表选择弹窗 (ActionSheet)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值