鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.promptAction (弹窗)

HarmonyOS Next开发学习手册——粒子动画 粒子动画 是在一定范围内随机生成的大量粒子产生运动而组成的动画。动画元素是一个个粒子,这些粒子可以是圆点、图片。开发者可以通过对粒子在颜色、透明度、大小、速度、加速度、自旋角度等维度变化做动画,来营造一种氛围感,比如下雪的动效,雪花飘舞就相当于一个个雪花粒子在做动画。粒子动画的效果通过Particle组件展现。基本示例代码和效果如下。 阅读详情

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


@ohos.promptAction (弹窗)

创建并显示文本提示框、对话框和操作菜单。

说明

本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

该模块不支持在UIAbility的文件声明处使用,即不能在UIAbility的生命周期中调用,需要在创建组件实例后使用。

本模块功能依赖UI的执行上下文,不可在UI上下文不明确的地方使用,参见UIContext说明。建议在无UI界面的场景外,均使用UIContext中的弹窗方法。

从API version 10开始,可以通过使用UIContext中的getPromptAction方法获取当前UI上下文关联的PromptAction对象。

导入模块

import { promptAction } from '@kit.ArkUI';

promptAction.showToast

showToast(options: ShowToastOptions): void

创建并显示文本提示框。

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

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

参数:

参数名类型必填说明
optionsShowToastOptions是文本弹窗选项。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameters types; 3. Parameter verification failed.
100001Internal error.

示例:

import { promptAction } from '@kit.ArkUI'
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct toastExample {
build() {
Column() {
Button('Show toast').fontSize(20)
.onClick(() => {
try {
promptAction.showToast({
message: 'Hello World',
duration: 2000
});
} catch (error) {
let message = (error as BusinessError).message
let code = (error as BusinessError).code
console.error(`showToast args error code is ${code}, message is ${message}`);
};
})
}.height('100%').width('100%').justifyContent(FlexAlign.Center)
}
}

API version 11及之前Toast样式。

API version 12及之后Toast样式。

promptAction.showDialog

showDialog(options: ShowDialogOptions): Promise<ShowDialogSuccessResponse>

创建并显示对话框,对话框响应后异步返回结果。

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

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

参数:

参数名类型必填说明
optionsShowDialogOptions是对话框选项。

返回值:

类型说明
Promise<ShowDialogSuccessResponse>对话框响应结果。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameters types; 3. Parameter verification failed.
100001Internal error.

示例:

import { promptAction } from '@kit.ArkUI'
import { BusinessError } from '@kit.BasicServicesKit';

try {
promptAction.showDialog({
title: 'Title Info',
message: 'Message Info',
buttons: [
{
text: 'button1',
color: '#000000'
},
{
text: 'button2',
color: '#000000'
}
],
})
.then(data => {
console.info('showDialog success, click button: ' + data.index);
})
.catch((err:Error) => {
console.info('showDialog error: ' + err);
})
} catch (error) {
let message = (error as BusinessError).message
let code = (error as BusinessError).code
console.error(`showDialog args error code is ${code}, message is ${message}`);
};

promptAction.showDialog

showDialog(options: ShowDialogOptions, callback: AsyncCallback<ShowDialogSuccessResponse>):void

创建并显示对话框,对话框响应结果异步返回。

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

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

参数:

参数名类型必填说明
optionsShowDialogOptions是页面显示对话框信息描述。
callbackAsyncCallback<ShowDialogSuccessResponse>是对话框响应结果回调。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameters types; 3. Parameter verification failed.
100001Internal error.

示例:

import { promptAction } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';

try {
promptAction.showDialog({
title: 'showDialog Title Info',
message: 'Message Info',
buttons: [
{
text: 'button1',
color: '#000000'
},
{
text: 'button2',
color: '#000000'
}
]
}, (err, data) => {
if (err) {
console.info('showDialog err: ' + err);
return;
}
console.info('showDialog success callback, click button: ' + data.index);
});
} catch (error) {
let message = (error as BusinessError).message
let code = (error as BusinessError).code
console.error(`showDialog args error code is ${code}, message is ${message}`);
};

当弹窗的showInSubWindow属性为true时,弹窗可显示在窗口外。

import { promptAction } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';

try {
  promptAction.showDialog({
    title: 'showDialog Title Info',
    message: 'Message Info',
    isModal: true,
    showInSubWindow: true,
    buttons: [
      {
        text: 'button1',
        color: '#000000'
      },
      {
        text: 'button2',
        color: '#000000'
      }
    ]
  }, (err, data) => {
    if (err) {
      console.info('showDialog err: ' + err);
      return;
    }
    console.info('showDialog success callback, click button: ' + data.index);
  });
} catch (error) {
  let message = (error as BusinessError).message
  let code = (error as BusinessError).code
  console.error(`showDialog args error code is ${code}, message is ${message}`);
};

promptAction.showActionMenu

showActionMenu(options: ActionMenuOptions, callback: AsyncCallback<ActionMenuSuccessResponse>):void

创建并显示操作菜单,菜单响应结果异步返回。

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

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

参数:

参数名类型必填说明
optionsActionMenuOptions是操作菜单选项。
callbackAsyncCallback<ActionMenuSuccessResponse>是菜单响应结果回调。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameters types; 3. Parameter verification failed.
100001Internal error.

示例:

import { promptAction } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';

try {
promptAction.showActionMenu({
title: 'Title Info',
buttons: [
{
text: 'item1',
color: '#666666'
},
{
text: 'item2',
color: '#000000'
},
]
}, (err, data) => {
if (err) {
console.info('showActionMenu err: ' + err);
return;
}
console.info('showActionMenu success callback, click button: ' + data.index);
})
} catch (error) {
let message = (error as BusinessError).message
let code = (error as BusinessError).code
console.error(`showActionMenu args error code is ${code}, message is ${message}`);
};

promptAction.showActionMenu

showActionMenu(options: ActionMenuOptions): Promise<ActionMenuSuccessResponse>

创建并显示操作菜单,菜单响应后异步返回结果。

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

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

参数:

参数名类型必填说明
optionsActionMenuOptions是操作菜单选项。

返回值:

类型说明
Promise<ActionMenuSuccessResponse>菜单响应结果。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameters types; 3. Parameter verification failed.
100001Internal error.

示例:

import { promptAction } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';

try {
promptAction.showActionMenu({
title: 'showActionMenu Title Info',
buttons: [
{
text: 'item1',
color: '#666666'
},
{
text: 'item2',
color: '#000000'
},
]
})
.then(data => {
console.info('showActionMenu success, click button: ' + data.index);
})
.catch((err:Error) => {
console.info('showActionMenu error: ' + err);
})
} catch (error) {
let message = (error as BusinessError).message
let code = (error as BusinessError).code
console.error(`showActionMenu args error code is ${code}, message is ${message}`);
};

promptAction.openCustomDialog11+

openCustomDialog(options: CustomDialogOptions): Promise<number>

打开自定义弹窗。

暂不支持isModal = true与showInSubWindow = true同时使用。

弹窗宽度在设备竖屏时默认为 所在窗口宽度 - 左右margin(16vp,设备为2in1时为40vp),最大默认宽度为400vp。

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

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

参数:

参数名类型必填说明
optionsCustomDialogOptions是自定义弹窗的内容。

返回值:

类型说明
Promise<number>返回供closeCustomDialog使用的对话框id。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameters types; 3. Parameter verification failed.
100001Internal error.

示例:

import { promptAction } from '@kit.ArkUI'

@Entry
@Component
struct Index {
private customDialogComponentId: number = 0

@Builder customDialogComponent() {
Column() {
Text('弹窗').fontSize(30)
Row({ space: 50 }) {
Button("确认").onClick(() => {
promptAction.closeCustomDialog(this.customDialogComponentId)
})
Button("取消").onClick(() => {
promptAction.closeCustomDialog(this.customDialogComponentId)
})
}
}.height(200).padding(5).justifyContent(FlexAlign.SpaceBetween)
}

build() {
Row() {
Column({ space: 20 }) {
Text('组件内弹窗')
.fontSize(30)
.onClick(() => {
promptAction.openCustomDialog({
builder: () => {
this.customDialogComponent()
},
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()
}
}
}).then((dialogId: number) => {
this.customDialogComponentId = dialogId
})
})
}
.width('100%')
}
.height('100%')
}
}

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

import { promptAction } from '@kit.ArkUI'

let customDialogId: number = 0

@Builder
function customDialogBuilder() {
Column() {
Text('Custom dialog Message').fontSize(10)
Row() {
Button("确认").onClick(() => {
promptAction.closeCustomDialog(customDialogId)
})
Blank().width(50)
Button("取消").onClick(() => {
promptAction.closeCustomDialog(customDialogId)
})
}
}
}

@Entry
@Component
struct Index {
@State message: string = 'Hello World'

@Builder
customDialogComponent() {
customDialogBuilder()
}

build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.onClick(() => {
promptAction.openCustomDialog({
builder: () => {
this.customDialogComponent()
},
keyboardAvoidMode: KeyboardAvoidMode.NONE,
showInSubWindow: false,
offset: { dx: 5, dy: 5 },
backgroundColor: 0xd9ffffff,
cornerRadius: 20,
width: '80%',
height: 200,
borderWidth: 1,
borderStyle: BorderStyle.Dashed, //使用borderStyle属性,需要和borderWidth属性一起使用
borderColor: Color.Blue, //使用borderColor属性,需要和borderWidth属性一起使用
shadow: ({
radius: 20,
color: Color.Grey,
offsetX: 50,
offsetY: 0
}),
}).then((dialogId: number) => {
customDialogId = dialogId
})
})
}
.width('100%')
}
.height('100%')
}
}

promptAction.closeCustomDialog11+

closeCustomDialog(dialogId: number): void

关闭自定义弹窗。

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

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

参数:

参数名类型必填说明
dialogIdnumber是openCustomDialog返回的对话框id。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameters types; 3. Parameter verification failed.
100001Internal error.

示例:

示例请看promptAction.openCustomDialog的示例。

ShowToastOptions

文本提示框的选项。

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

名称类型必填说明
messagestring | Resource是

显示的文本信息。

说明:

默认字体为'Harmony Sans',不支持设置其他字体。

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

durationnumber否

默认值1500ms,取值区间:1500ms-10000ms。若小于1500ms则取默认值,若大于10000ms则取上限值10000ms。

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

bottomstring | number否

设置弹窗底部边框距离导航条的高度,ToastShowMode.TOP_MOST模式下,软键盘拉起时,如果bottom值过小,toast要被软键盘遮挡时,会自动避让至距离软键盘80vp处。ToastShowMode.DEFAULT模式下,软键盘拉起时,会上移软键盘的高度。

默认值:80vp

说明:

当底部没有导航条时,bottom为设置弹窗底部边框距离窗口底部的高度。

设置对齐方式alignment后,bottom不生效。

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

showMode11+ToastShowMode否

设置弹窗是否显示在应用之上。

默认值:ToastShowMode.DEFAULT,默认显示在应用内。

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

alignment12+Alignment否

对齐方式。

默认值:undefined,默认底部偏上位置。

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

offset12+Offset否

在对齐方式上的偏移。

默认值:{ dx: 0, dy: 0 },默认没有偏移。

说明:

只支持设置px类型的数值,如需设置vp,可以将vp改成px传入。

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

backgroundColor12+ResourceColor否

文本提示框背板颜色

默认值:Color.Transparent

说明:

当设置了backgroundColor为非透明色时,backgroundBlurStyle需要设置为BlurStyle.NONE,否则颜色显示将不符合预期效果。

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

textColor12+ResourceColor否

文本提示框文本颜色

默认值:Color.Black

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

backgroundBlurStyle12+BlurStyle否

文本提示框背板模糊材质

默认值:BlurStyle.COMPONENT_ULTRA_THICK

说明:

设置为BlurStyle.NONE即可关闭背景虚化。当设置了backgroundBlurStyle为非NONE值时,则不要设置backgroundColor,否则颜色显示将不符合预期效果。

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

shadow12+ShadowOptions | ShadowStyle否

文本提示框背板阴影

默认值:ShadowStyle.OUTER_DEFAULT_MD

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

ToastShowMode11+

设置弹窗显示模式,默认显示在应用内,支持显示在应用之上。

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

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

名称值说明
DEFAULT0Toast 显示在应用内。
TOP_MOST1Toast 显示在应用之上。

ShowDialogOptions

对话框的选项。

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

名称类型必填说明
titlestring | Resource否

标题文本。

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

messagestring | Resource否

内容文本。

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

buttonsArray<Button>否

对话框中按钮的数组,结构为:{text:'button', color: '#666666'},支持大于1个按钮。

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

alignment10+DialogAlignment否

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

默认值:DialogAlignment.Default

说明:

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

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

offset10+Offset否

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

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

元服务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开始,该接口支持在元服务中使用。

backgroundColor12+ResourceColor否

弹窗背板颜色。

默认值:Color.Transparent

说明:

当设置了backgroundColor为非透明色时,backgroundBlurStyle需要设置为BlurStyle.NONE,否则颜色显示将不符合预期效果。

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

backgroundBlurStyle12+BlurStyle否

弹窗背板模糊材质。

默认值:BlurStyle.COMPONENT_ULTRA_THICK

说明:

设置为BlurStyle.NONE即可关闭背景虚化。当设置了backgroundBlurStyle为非NONE值时,则不要设置backgroundColor,否则颜色显示将不符合预期效果。

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

shadow12+ShadowOptions | ShadowStyle否

设置弹窗背板的阴影。

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

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

ShowDialogSuccessResponse

对话框的响应结果。

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

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

名称类型必填说明
indexnumber是选中按钮在buttons数组中的索引。

ActionMenuOptions

操作菜单的选项。

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

名称类型必填说明
titlestring | Resource否

标题文本。

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

buttons[Button,Button?,Button?,Button?,Button?,Button?]是

菜单中菜单项按钮的数组,结构为:{text:'button', color: '#666666'},支持1-6个按钮。按钮数量大于6个时,仅显示前6个按钮,之后的按钮不显示。

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

showInSubWindow11+boolean否

某弹框需要显示在主窗口之外时,是否在子窗口显示此弹窗。

默认值:false,在子窗口不显示弹窗。

说明:

- showInSubWindow为true的弹窗无法触发显示另一个showInSubWindow为true的弹窗。

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

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

isModal11+boolean否

弹窗是否为模态窗口,模态窗口有蒙层,非模态窗口无蒙层。

默认值:true,此时弹窗有蒙层。

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

ActionMenuSuccessResponse

操作菜单的响应结果。

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

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

名称类型必填说明
indexnumber是选中按钮在buttons数组中的索引,从0开始。

CustomDialogOptions11+

自定义弹窗的内容,继承自BaseDialogOptions。

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

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

名称类型必填说明
builderCustomBuilder是

设置自定义弹窗的内容。

说明:

builder需要赋值为箭头函数,格式如下:() => { this.XXX() },其中XXX是内部builder名。

如果是全局builder需要在组件内部创建一个builder,在内部builder中调用全局builder。

builder根节点宽高百分比相对弹框容器大小。

builder非根节点宽高百分比相对父节点大小。

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

backgroundColor 12+ResourceColor否

设置弹窗背板颜色。

默认值:Color.Transparent

说明:

当设置了backgroundColor为非透明色时,backgroundBlurStyle需要设置为BlurStyle.NONE,否则颜色显示将不符合预期效果。

cornerRadius12+Dimension | BorderRadiuses否

设置背板的圆角半径。

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

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

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

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

borderWidth12+Dimension | EdgeWidths否

设置弹窗背板的边框宽度。

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

默认值:0。

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

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

borderColor12+ResourceColor | EdgeColors否

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

默认值:Color.Black。

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

borderStyle12+BorderStyle | EdgeStyles否

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

默认值:BorderStyle.Solid。

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

width12+Dimension否

设置弹窗背板的宽度。

说明:

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

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

height12+Dimension否

设置弹窗背板的高度。

说明:

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

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

shadow12+ShadowOptions | ShadowStyle否

设置弹窗背板的阴影。

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

backgroundBlurStyle12+BlurStyle否

弹窗背板模糊材质。

默认值:BlurStyle.COMPONENT_ULTRA_THICK

说明:

设置为BlurStyle.NONE即可关闭背景虚化。当设置了backgroundBlurStyle为非NONE值时,则不要设置backgroundColor,否则颜色显示将不符合预期效果。

BaseDialogOptions11+

弹窗的选项。

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

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

名称类型必填说明
maskRectRectangle否

弹窗遮蔽层区域。

默认值:{ x: 0, y: 0, width: '100%', height: '100%' }

说明:

showInSubWindow为true时,maskRect不生效。

alignmentDialogAlignment否

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

默认值:DialogAlignment.Default

说明:

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

offsetOffset否

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

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

isModalboolean否

弹窗是否为模态窗口,模态窗口有蒙层,非模态窗口无蒙层。

默认值:true,此时弹窗有蒙层。

showInSubWindowboolean否

某弹框需要显示在主窗口之外时,是否在子窗口显示此弹窗。

默认值:false,弹窗显示在应用内,而非独立子窗口。

onWillDismiss12+Callback<DismissDialogAction>否

交互式关闭回调函数。

说明:

1.当用户执行点击遮障层关闭、左滑/右滑、三键back、键盘ESC关闭交互操作时,如果注册该回调函数,则不会立刻关闭弹窗。在回调函数中可以通过reason得到阻拦关闭弹窗的操作类型,从而根据原因选择是否能关闭弹窗。当前组件返回的reason中,暂不支持CLOSE_BUTTON的枚举值。

2.在onWillDismiss回调中,不能再做onWillDismiss拦截。

autoCancel12+boolean否

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

默认值:true

maskColor12+ResourceColor否

自定义蒙层颜色。

默认值: 0x33000000

transition12+TransitionEffect否

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

说明:

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

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

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

onDidAppear12+() => void否

弹窗弹出时的事件回调。

说明:

1.正常时序依次为:onWillAppear>>onDidAppear>>(onDateAccept/onCancel/onDateChange)>>onWillDisappear>>onDidDisappear。

2.在onDidAppear内设置改变弹窗显示效果的回调事件,二次弹出生效。

3.快速点击弹出,消失弹窗时,存在onWillDisappear在onDidAppear前生效。

4. 当弹窗入场动效未完成时关闭弹窗,该回调不会触发。

onDidDisappear12+() => void否

弹窗消失时的事件回调。

说明:

正常时序依次为:onWillAppear>>onDidAppear>>(onDateAccept/onCancel/onDateChange)>>onWillDisappear>>onDidDisappear。

onWillAppear12+() => void否

弹窗显示动效前的事件回调。

说明:

1.正常时序依次为:onWillAppear>>onDidAppear>>(onDateAccept/onCancel/onDateChange)>>onWillDisappear>>onDidDisappear。

2.在onWillAppear内设置改变弹窗显示效果的回调事件,二次弹出生效。

onWillDisappear12+() => void否

弹窗退出动效前的事件回调。

说明:

1.正常时序依次为:onWillAppear>>onDidAppear>>(onDateAccept/onCancel/onDateChange)>>onWillDisappear>>onDidDisappear。

2.快速点击弹出,消失弹窗时,存在onWillDisappear在onDidAppear前生效。

keyboardAvoidMode12+KeyboardAvoidMode否

用于设置弹窗是否在拉起软键盘时进行自动避让。

默认值:KeyboardAvoidMode.DEFAULT

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

DismissDialogAction12+

Dialog关闭的信息。

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

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

属性

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

DismissReason12+枚举说明

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

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

名称值描述
PRESS_BACK0点击三键back、左滑/右滑、键盘ESC。
TOUCH_OUTSIDE1点击遮障层时。
CLOSE_BUTTON2点击关闭按钮。
SLIDE_DOWN3

下拉关闭。

说明:

该接口仅支持在半模态转场中使用。

KeyboardAvoidMode12+枚举说明

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

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

名称值说明
DEFAULT0默认避让软键盘并在到达极限高度之后进行高度压缩。
NONE1不避让软键盘。

Button

菜单中的菜单项按钮。

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

名称类型必填说明
textstring | Resource是

按钮文本内容。

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

colorstring | Resource是

按钮文本颜色。

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

primary12+boolean否

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

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

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

相关推荐

Rust + Tauri调用鸿蒙系统原生API,打通桥接实战经验总结

真不容易啊,网上这方面资料很少,探索尝试了很久终于打通了调用鸿蒙原生API的方法。这有什么用?使用Tauri做跨端APP是个不错的技术方案,可以一次可以跨N端。但是呢肯定避免不了依赖和使用系统的原生API来扩展能力。当前Tauri在android和ios端,官方都有插件支持。但鸿蒙还不支持,有待探索。正在(或即将)把 Tauri 应用往鸿蒙(HarmonyOS)上搬、想调用系统原生能力(相册、分享、通知、剪贴板……)的开发者。本文是一篇实战记录,不是官方文档复述。

猫哥 的沉淀、积累、总结。天天学习,好好向上...c/c++,嵌入式 linux,Android,HarmonyOS,AIOT) 229

【鸿蒙软件开发】ArkTS常见组件之单选框Radio和切换按钮Toggle

Radio是单选框组件,通常用于提供相应的用户交互选择项,同一组的Radio中只有一个可以被选中。具体用法请参考Radio。Toggle组件提供状态按钮样式,勾选框样式及开关样式,一般用于两种状态之间的切换。具体用法请参考Toggle。其中对于Toggle独特的属性是,他是当Toggle选中后,所呈现的颜色以上就是今天要讲的内容,本文介绍了单选框Radio和切换按钮Toggle的使用,使用这些组件可以帮助我们快速构建ArkTS的界面。

m0_62599305的博客 6419

shopee app算法分析第一篇

shopee app算法分析第一篇分析完整算法大概要好几篇,耐心等待下.国内只会发律师函,牛逼,一个律师套话,一个律师发函,大意了(警惕卡通律师头像),希望law可以保护好你,还是干国外好.

2533

HarmonyOS开发(十二):ArkTS组件通用事件

不支持冒泡点击动作触发该回调,支持在卡片中使用ClickEvent对象说明触发事件的元素对象显示区域区域是一个Area类型数据。

advent86的专栏 5907

从JX-2R-01热敏打印机芯到稳定打印:硬件设计与时序控制的实践指南

本文详细解析了JX-2R-01热敏打印机芯的硬件设计与驱动开发全流程。核心内容包括:实现严格的双电源上电时序控制、采用PWM恒流驱动步进电机确保走纸平稳,以及精确控制SPI数据加载与加热脉冲时序以获得清晰打印效果。文章提供了从电路设计、芯片选型到代码调试的实战指南,旨在帮助开发者构建稳定可靠的热敏打印模块。

weixin_29169899的博客 224

CST实战:变容二极管电容曲线提取全流程(附S参数设置技巧)

本文详细介绍了在CST Studio Suite中提取变容二极管电容-电压(C-V)曲线的完整实战流程。重点解析了S参数仿真的核心原理、DCFEED模块的正确配置、参数扫描的设置技巧,并探讨了集成SPICE模型进行精确仿真的方法,帮助射频工程师高效、准确地获取器件关键特性。

weixin_29237635的博客 529

HarmonyOS系统开发ArkTS常用组件切换按钮及参数(七)

Toggle组件的参数:Toggle(options: { type: ToggleType, isOn?: boolean })Toggle为切换按钮组件,一般用于两种状态之间的切换,例如下图中的蓝牙开关。

qq_41946216的博客 984

从零构建:基于Docker与FRR的OSPF虚拟网络实验室

本文详细介绍了如何利用Docker与FRR构建OSPF虚拟网络实验室,从环境设计到高级网络拓扑配置,再到实验验证与排错。通过容器化技术实现高效资源利用和快速部署,特别适合网络协议教学、企业网络架构验证等场景。

plum99的博客 223

鸿蒙6.1 promptAction坑:showToast废迁getPromptAction+ToastType enum非字符串

本文是「鸿蒙 6.1 API 23 开发坑系列」第 10 篇(非 UI 系第 4 篇)。本篇讲 @ohos.promptAction namespace(API 9+,鸿蒙 6.1 API 23 基座

ConanYao的博客 405

EETI_eGTouch驱动移植及校准

一.环境 芯片:NXP IMX6Q 内核版本:4.1.15 uname:Linux myimx6ek314 4.1.15-myimx6-g5d588fa6-dirty #4 SMP PREEMPT Tue Nov 17 17:26:34 CST 2020 armv7l armv7l armv7l GNU/Linux 二.官方《EETI_eGTouch_Linux_Programming_Guide_v2.5l.pdf》文档勘误 HID_MULTITOUCH =Y or N(官方文档设置为M): 正确设置H

Garden的博客 4338

STM32F103C8T6+A4988驱动42步进电机全流程(附接线图+代码解析)

本文详细介绍了使用STM32F103C8T6单片机与A4988驱动模块控制42步进电机的完整流程。内容涵盖硬件接线图解析、电流设置、GPIO驱动代码编写以及细分控制等核心实践,旨在帮助嵌入式开发者和DIY爱好者快速实现精准运动控制,适用于3D打印机、CNC等需要精密定位的项目。

Python的专栏 797

HarmonyOS NEXT 祝福自动生成器开发实战:从零构建 ArkTS 声明式 UI 应用

在组件结构体中,我们定义了 5 个@State@Component// 当前选中的分类索引// 当前显示的祝福语// 是否正在生成(加载动画)变量类型初始值作用number0控制哪个分类被选中,驱动 UI 高亮效果string‘’当前展示的祝福语文本booleanfalse控制加载动画的显示/隐藏string[][]booleanfalse用户点击"🎉 祝福生成器"→ BlessingGenerator 组件实例化。

hsjdebbebdbdhd的博客 437

告别标注地狱!YOLO+CLIP多模态零样本检测全实战:图文联合推理,想检测什么直接输文字,不用训模型

这套方案我给朋友的超市用了快3个月,运行极其稳定,临期商品的检测准确率能到96%,后续加了“货架空货检测”“通道杂物堆积检测”,都是改一行文本就搞定,完全不用重新开发,朋友说省了十几万的定制开发费用。很多做计算机视觉的朋友,总觉得目标检测必须标数据、训模型,其实不是的。现在多模态大模型的能力已经足够强,把YOLO的定位能力和CLIP的图文泛化能力结合起来,就能用极低的成本,搞定绝大多数定制化检测需求。对于我们开发者来说,技术的价值从来不是炫技,而是用最简单的方案,解决最实际的问题。

专注于Python爬虫开发,分享爬虫技巧、项目实战与反爬经验,使用Scrapy、BeautifulSoup等工具,解决数据抓取难题。 519

鸿蒙 ArkTS 实战:弹窗演示 DialogDemo

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

2403_87838053的博客 224

文档:亲测可用解决vnc灰屏,黑屏,鼠标大黑叉情况

主要解决vnc-viewer灰屏,黑屏,鼠标大黑叉等现象,详细见文档。

锂电池充电器电路设计 里面有电路

锂电池充电器电路设计 里面有电路 3.7V升压到5V电路设计。

HarmonyOS ArkTS API 24,React Native鸿蒙跨平台开发音乐每日推荐页的核心价值在于推荐内容展示与交互逻辑(播放、收藏、查看详情)

受欢迎的 Python WSGI 兼容的网络服务器:Gunicorn(参考 http://gunicorn.org/)和 uWSGI(参考 https://uwsgi-docs.readthedocs.org),它们使用工作线程处理 HTTP 请求,这些工作线。进程,例如使用 subprocess 模块中的 run()函数,实际上这是在多个进程中进行工作,幸运的是,许多兼容 WSGI 的 Web 服务器允许这样的设置。如果在多线程中毫无顾忌的使用它,中可能会导致串行化,这将撤消多线程的所有好处。

2301_77888392的博客 953

IMSL CNL 7.0.0 (x86-64)Crack

IMSL CNL 7.0.0 (x86-64)Crack intel的算法库破解文件,这是C++版本的破解文件

HarmonyOS ArkTS API 24,React Native鸿蒙跨平台React Native 的stateEffect模拟关闭 Button 默认点击效果

缓存装饰器与参数检查十分相似,不过它重点是关注那些内部状态不会影响输出的函数。每组参数都可以链接到唯一的结果。这种编程风格是函数式编程(functional programming,参见 https://en.wikipedia.org/wiki/Functional_programming)的特点,当输入值有限时可以使用。因此,缓存装饰器可以将输出与计算它所需要的参数放在一起,并在后续的调用中直接返回它。

2301_77888392的博客 675

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

鸿蒙 HarmonyOS 待办清单应用开发实战 —— 基于 ArkTS + SQLite 的完整教程

本文介绍了如何基于鸿蒙HarmonyOS的ArkTS语言和SQLite数据库开发一个功能完整的待办清单应用。主要内容包括: 项目概述: 实现待办事项的增删改查、状态切换、优先级管理、截止日期设置等核心功能 采用ArkTS + Stage模型 + SQLite技术栈 数据持久化设计: 选择SQLite作为存储方案,设计合理的表结构 定义了TodoItem和InsertTodoItem接口规范数据类型 封装TodoDatabase类管理数据库操作 关键技术点: 使用@ohos.data.relationalSt

s1316339343的博客 460

HarmonyOS 7 实战:ArkTS + Canvas 2D 打造情绪可视化 AI 应用

本文介绍了一个基于HarmonyOS 7开发的"情绪树"AI应用,通过ArkTS和Canvas 2D技术将用户情绪可视化为动态生长的树木。文章重点阐述了三个核心内容: 产品设计理念:通过"情绪树"的具身化隐喻(Embodied Metaphor),将多维情绪数据转化为可视化树木,比传统折线图更直观生动。 技术架构:采用端云协同的三层模型,App调用本地FastAPI服务而非直接持有大模型API Key,实现了AI失败降级和渲染与数据解耦的设计。 关键技术实现:包括ArkTS的声明式UI开发范式、多级状态管理

一键难忘的博客 2万+

React Native鸿蒙,HarmonyOS ArkTS API 24,useState会映射为 ArkUI 的 @State装饰器,实现状态的响应式更新

是用于与工作线程通信的很好的选择,它来自内置的 queue 模块。何性能改进,但实际上,我们还减少由于缓慢的 print()执行的线程串行化的风险。这里是一个修改版本的 main()函数,它只启动有限数量的工作线程,并使用。建一个严格定义大小的工作线程池,它将处理所有的并行工作,并通过一些线程安全的数。所以通常的想法是启动一些预定义数量的线程,它将从队列中消费工作项,直到完成。我们尝试解决的第一个问题是程序运行中未绑定限制的线程。我们现在能够解决的另一个问题是在线程中输出的潜在的有问题的打印。

2301_77888392的博客 955

HarmonyOS ArkTS API 24 鸿蒙跨平台以21点游戏React Native组件为例,剖析跨端开发的核心技术,包括组件映射、样式转换和事件处理

使用 TypeScript 类型定义,确保了在不同平台上的数据结构一致性。

2401_86113894的博客 458

React Native鸿蒙跨平台如何实现分类页面组件HarmonyOS ArkTS API 24 通过searchQuery状态变量管理搜索输入,实现了分类的实时过滤功能

组件采用了现代 React 函数组件架构,结合useStateHook 实现了简洁的状态管理。组件通过状态变量管理搜索输入,实现了分类的实时过滤功能。组件作为独立的子组件,负责渲染单个分类的详细信息,通过 props 接收分类数据和点击回调函数,实现了组件的复用和逻辑分离。这种组件化设计使得代码结构清晰,易于维护和扩展。

2401_86113894的博客 374

基于HarmonyOS API 24,React Native鸿蒙跨平台核心组件(如View、Text、Image、TouchableOpacity、ScrollView等)完成用户中心的页面开发

Python 3 终结了这一分歧,其开发者只能使用被称为新式类的模型。怎样,知道两种模型在 Python 2 中的工作原理仍是很重要的,因为这有助于你移植旧代码。定义好之后,注解可以通过函数对象的__annotations__属性获取,它是一个字典,分重点介绍了与 Python 序列和集合相关的语法特性,也讨论了字符串和字节相关的序列。这也是为什么本章包含关于 Python 2 旧特性的大量内容,尽管本书针对的是最新版的。自定义函数使用的类型的完全可选的元信息,但事实上,它并不局限于类型提示,而且在。

2301_77888392的博客 400

从零开始构建鸿蒙纪念日提醒 App:ArkTS + API 24 实战

这篇文章摘要如下: 本文详细介绍了基于鸿蒙ArkTS和API 24开发纪念日提醒App的完整过程。主要内容包括:1) 项目需求分析和技术选型,采用轻量级Preferences存储;2) 三层架构设计(数据模型、持久化、UI);3) 核心数据模型设计,包括日期处理算法和边界条件处理;4) 数据持久化层的实现方案;5) UI层的视觉设计和交互实现。文章特别强调了日期计算、倒计时逻辑、状态标识等关键功能的实现细节,并解释了技术决策背后的考量,为鸿蒙开发者提供了一个完整的应用开发实战案例。

m0_67000457的博客 293

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

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

2401_86113894的博客 1188

鸿蒙 ArkTS 实战:侧滑菜单 SideBarContainer

点击打开菜单 → 查看菜单项 → 点击选中 → 自动收起。页面自上而下分为三块区域:顶部是返回栏,左侧「返回」按钮调用返回上一页,中间是标题「侧滑菜单」;中部是容器,左侧菜单栏占 40% 宽度,深色背景(#1f2733),右侧主内容区占满剩余空间,浅灰背景(#f2f3f5底部功能说明卡片列出三条使用提示。示例 91 的侧滑菜单虽然代码量不大,但涉及了的核心用法、状态绑定与双向同步、动态样式绑定、列表渲染等多个 ArkUI 关键知识点。状态驱动:用一个变量控制侧边栏的展开/收起。双向同步:同时使用属性和。

qizayaoshuap的博客 290
上一篇: 鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.pluginComponent (PluginComponentManager)
下一篇: 鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.router (页面路由)(不推荐)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值