简体中文

探索
设计
开发
分发
推广与变现
生态合作
支持

更多

输入关键字搜索

开发者能力认证

鸿蒙高校创新赛

HarmonyOS 7

animation

HarmonyOS行业解决方案

layoutWeight

HarmonyOS模板&组件

bindPopup

bindsheet

RelativeContainer

CustomDialogController

animateTo

CTRL+K

文档管理中心

我的

Hello，

欢迎来到开发者联盟

ArkTS API参考

Archived

系统能力SystemCapability使用说明

系统能力SystemCapability列表

ArkTS接口参考

Stage模型能力的接口(推荐)

@ohos.app.ability.Ability (Ability基类)

@ohos.app.ability.AbilityConstant (AbilityConstant)

@ohos.app.ability.abilityLifecycleCallback (AbilityLifecycleCallback)

@ohos.app.ability.AbilityStage (AbilityStage)

@ohos.app.ability.common (应用上下文Context)

@ohos.app.ability.contextConstant (ContextConstant)

@ohos.app.ability.EnvironmentCallback (EnvironmentCallback)

@ohos.app.ability.ExtensionAbility (扩展能力基类)

@ohos.app.ability.UIAbility (UIAbility)

@ohos.app.form.FormExtensionAbility (FormExtensionAbility)

FA模型能力的接口

@ohos.ability.ability (Ability)

@ohos.ability.featureAbility (FeatureAbility模块)

@ohos.ability.particleAbility (ParticleAbility模块)

通用能力的接口(推荐)

@ohos.app.ability.abilityDelegatorRegistry (AbilityDelegatorRegistry)

@ohos.app.ability.appManager (appManager)

@ohos.app.ability.appRecovery (appRecovery)

@ohos.app.ability.Configuration (Configuration)

@ohos.app.ability.ConfigurationConstant (ConfigurationConstant)

@ohos.app.ability.dataUriUtils (DataUriUtils模块)

@ohos.app.ability.dialogRequest (dialogRequest模块)

@ohos.app.ability.errorManager (ErrorManager)

@ohos.app.ability.Want (Want)

@ohos.app.ability.wantAgent (WantAgent模块)

@ohos.app.ability.wantConstant (wantConstant)

@ohos.app.form.formBindingData (卡片数据绑定类)

@ohos.app.form.formInfo (FormInfo)

@ohos.app.form.formProvider (FormProvider)

通用能力的接口(待停用)

@ohos.ability.dataUriUtils (DataUriUtils模块)

@ohos.ability.errorCode (ErrorCode)

@ohos.ability.wantConstant (wantConstant)

@ohos.application.abilityDelegatorRegistry (AbilityDelegatorRegistry)

@ohos.application.appManager (appManager)

@ohos.application.Configuration (Configuration)

@ohos.application.ConfigurationConstant (ConfigurationConstant)

@ohos.application.formBindingData (卡片数据绑定类)

@ohos.application.formError (FormError)

@ohos.application.formInfo (FormInfo)

@ohos.application.formProvider (FormProvider)

@ohos.application.Want (Want)

@ohos.wantAgent (WantAgent模块)

接口依赖的元素及定义

DataAbilityHelper

DataAbilityOperation

DataAbilityResult

StartAbilityParameter

AbilityDelegator

AbilityDelegatorArgs

AbilityStageContext

AbilityStateData

AbilityStageMonitor

ApplicationContext

ExtensionContext

ProcessRunningInfo

ProcessInformation

UIAbilityContext

@ohos.continuation.continuationManager (continuationManager)

ContinuationExtraParams

ContinuationResult

公共事件与通知

系统公共事件定义

@ohos.commonEventManager (公共事件模块)

@ohos.events.emitter (Emitter)

@ohos.notificationManager (NotificationManager模块)

@ohos.commonEvent (公共事件模块)

系统公共事件定义(待停用)

@ohos.notification (Notification模块)

CommonEventData

CommonEventPublishData

CommonEventSubscriber

CommonEventSubscribeInfo

NotificationActionButton

NotificationCommonDef

NotificationContent

NotificationFlags

NotificationRequest

NotificationSlot

NotificationTemplate

NotificationUserInput

@ohos.bundle.bundleManager (bundleManager模块)

@ohos.bundle.defaultAppManager (默认应用管理)

@ohos.zlib (Zip模块)

ApplicationInfo

ExtensionAbilityInfo

@ohos.animator (动画)

@ohos.curves (插值计算)

@ohos.matrix4 (矩阵变换)

@ohos.mediaquery (媒体查询)

@ohos.promptAction (弹窗)

@ohos.router (页面路由)

@ohos.font (注册自定义字体)

@ohos.measure (文本计算)

@ohos.display (屏幕属性)

@ohos.effectKit (图像效果)

@ohos.graphics.colorSpaceManager (色彩管理)

@ohos.window (窗口)

@ohos.multimedia.audio (音频管理)

@ohos.multimedia.image (图片处理)

@ohos.multimedia.media (媒体服务)

@ohos.i18n (国际化-I18n)

@ohos.intl (国际化-Intl)

@ohos.resourceManager (资源管理)

后台任务(Background Task)

@ohos.reminderAgentManager (后台代理提醒)

@ohos.resourceschedule.backgroundTaskManager (后台任务管理)

@ohos.resourceschedule.workScheduler (延迟任务调度)

@ohos.WorkSchedulerExtensionAbility (延迟任务调度回调)

@ohos.abilityAccessCtrl (程序访问控制管理)

@ohos.security.cert (证书模块)

@ohos.security.cryptoFramework (加解密算法库框架)

@ohos.security.huks (通用密钥库系统)

@ohos.userIAM.userAuth (用户认证)

PermissionRequestResult

@ohos.data.dataAbility (DataAbility谓词)

@ohos.data.distributedDataObject (分布式数据对象)

@ohos.data.distributedKVStore (分布式键值数据库)

@ohos.data.preferences (用户首选项)

@ohos.data.relationalStore (关系型数据库)

@ohos.file.fileuri (文件URI)

@ohos.file.fs (文件管理)

@ohos.file.hash (文件哈希处理)

@ohos.file.picker (选择器)

@ohos.file.securityLabel (数据标签)

@ohos.file.statvfs (文件系统空间统计)

@ohos.file.storageStatistics (应用空间统计)

@ohos.contact (联系人)

@ohos.telephony.call (拨打电话)

@ohos.telephony.data (蜂窝数据)

@ohos.telephony.observer (observer)

@ohos.telephony.radio (网络搜索)

@ohos.telephony.sim (SIM卡管理)

@ohos.telephony.sms (短信服务)

@ohos.net.connection (网络连接管理)

@ohos.net.http (数据请求)

@ohos.net.socket (Socket连接)

@ohos.net.webSocket (WebSocket连接)

@ohos.request (上传下载)

通信与连接

@ohos.bluetoothManager (蓝牙)

@ohos.connectedTag (有源标签)

@ohos.nfc.cardEmulation (标准NFC-cardEmulation)

@ohos.nfc.controller (标准NFC)

@ohos.nfc.tag (标准NFC-Tag)

@ohos.rpc (RPC通信)

@ohos.wifiManager (WLAN)

@ohos.wifiManagerExt (WLAN扩展接口)

@ohos.wifi (WLAN)

@ohos.wifiext (WLAN扩展接口)

nfctech (标准NFC-Tag Nfc 技术)

tagSession (标准NFC-Tag TagSession)

系统基础能力

@ohos.accessibility (辅助功能)

@ohos.accessibility.GesturePath (手势路径)

@ohos.accessibility.GesturePoint (手势触摸点)

@ohos.application.AccessibilityExtensionAbility (辅助功能扩展能力)

@ohos.faultLogger (故障日志获取)

@ohos.hichecker (检测模式)

@ohos.hidebug (Debug调试)

@ohos.hilog (HiLog日志打印)

@ohos.hiTraceChain (分布式跟踪)

@ohos.hiTraceMeter (性能打点)

@ohos.hiviewdfx.hiAppEvent (应用事件打点)

@ohos.inputMethod (输入法框架)

@ohos.inputMethodEngine (输入法服务)

@ohos.InputMethodExtensionAbility (InputMethodExtensionAbility)

@ohos.InputMethodExtensionContext (InputMethodExtensionContext)

@ohos.InputMethodSubtype (输入法子类型)

@ohos.pasteboard (剪贴板)

@ohos.screenLock (锁屏管理)

@ohos.systemDateTime (系统时间、时区)

@ohos.wallpaper (壁纸)

@ohos.web.webview (Webview)

Console (控制台)

Timer (定时器)

AccessibilityExtensionContext (辅助功能扩展上下文)

@ohos.batteryInfo (电量信息)

@ohos.deviceInfo (设备信息)

@ohos.geoLocationManager (位置服务)

@ohos.multimodalInput.inputDevice (输入设备)

@ohos.multimodalInput.inputEvent (输入事件)

@ohos.multimodalInput.keyCode (键值)

@ohos.multimodalInput.keyEvent (按键输入事件)

@ohos.multimodalInput.mouseEvent (鼠标输入事件)

@ohos.multimodalInput.pointer (鼠标指针)

@ohos.multimodalInput.touchEvent (触摸输入事件)

@ohos.power (系统电源管理)

@ohos.runningLock (Runninglock锁)

@ohos.sensor (传感器)

@ohos.settings (设置数据项名称)

@ohos.stationary (设备状态感知框架)

@ohos.thermal (热管理)

@ohos.usbManager (USB管理)

@ohos.vibrator (振动)

@ohos.account.appAccount (应用帐号管理)

@ohos.account.distributedAccount (分布式帐号管理)

@ohos.account.osAccount (系统帐号管理)

语言基础类库

@ohos.buffer (Buffer)

@ohos.convertxml (xml转换JavaScript)

@ohos.process (获取进程相关的信息)

@ohos.taskpool（使用任务池）

@ohos.uri (URI字符串解析)

@ohos.url (URL字符串解析)

@ohos.util (util工具函数)

@ohos.util.ArrayList (线性容器ArrayList)

@ohos.util.Deque (线性容器Deque)

@ohos.util.HashMap (非线性容器HashMap)

@ohos.util.HashSet (非线性容器HashSet)

@ohos.util.LightWeightMap (非线性容器LightWeightMap)

@ohos.util.LightWeightSet (非线性容器LightWeightSet)

@ohos.util.LinkedList (线性容器LinkedList)

@ohos.util.List (线性容器List)

@ohos.util.PlainArray (非线性容器PlainArray)

@ohos.util.Queue (线性容器Queue)

@ohos.util.Stack (线性容器Stack)

@ohos.util.TreeMap (非线性容器TreeMap)

@ohos.util.TreeSet (非线性容器TreeSet)

@ohos.util.Vector (线性容器Vector)

@ohos.worker (启动一个Worker)

@ohos.xml (xml解析与生成)

@ohos.application.testRunner (TestRunner)

已停止维护的接口

@ohos.backgroundTaskManager (后台任务管理)

@ohos.bluetooth (蓝牙)

@ohos.bundle (Bundle模块)

@ohos.bundleState (设备使用信息统计)

@ohos.bytrace (性能打点)

@ohos.data.distributedData (分布式数据管理)

@ohos.data.storage (轻量级存储)

@ohos.data.rdb (关系型数据库)

@ohos.document (文件交互)

@ohos.fileio (文件管理)

@ohos.geolocation（位置服务）

@ohos.hiAppEvent (应用打点)

@ohos.multimedia.medialibrary (媒体库管理)

@ohos.prompt (弹窗)

@ohos.reminderAgent (后台代理提醒)

@ohos.statfs (statfs)

@ohos.systemTime (系统时间、时区)

@ohos.usb (USB管理)

@system.app (应用上下文)

@system.battery (电量信息)

@system.bluetooth (蓝牙)

@system.brightness (屏幕亮度)

@system.cipher (加密算法)

@system.configuration (应用配置)

@system.device (设备信息)

@system.fetch (数据请求)

@system.file (文件存储)

@system.geolocation (地理位置)

@system.mediaquery (媒体查询)

@system.network (网络状态)

@system.notification (通知消息)

@system.package (应用管理)

@system.prompt (弹窗)

@system.request (上传下载)

@system.router (页面路由)

@system.sensor (传感器)

@system.storage (数据存储)

@system.vibrator (振动)

ApplicationInfo

resultSet (结果集)

组件参考（基于ArkTS的声明式开发范式）

组件通用信息

挂载卸载事件

组件区域变化事件

组件可见区域变化事件

图片边框设置

透明度设置

文本样式设置

悬浮态效果

触摸热区设置

触摸测试控制

分布式迁移标识

绑定手势方法

LongPressGesture

RotationGesture

AlphabetIndexer

LoadingProgress

RelativeContainer

SideBarContainer

CanvasRenderingContext2D对象

CanvasGradient对象

ImageBitmap对象

ImageData对象

OffscreenCanvasRenderingContext2D对象

页面间转场

组件内转场

共享元素转场

列表选择弹窗

自定义弹窗

日期滑动选择器弹窗

时间滑动选择器弹窗

文本滑动选择器弹窗

自定义组件的生命周期

应用级变量的状态管理

已停止维护的组件

组件参考（兼容JS的类Web开发范式-ArkUI.Full）

组件通用信息

自定义字体样式

list-item-group

CanvasRenderingContext2D对象

CanvasGradient对象

ImageData对象

ImageBitmap对象

OffscreenCanvas对象

OffscreenCanvasRenderingContext2D对象

animateTransform

自定义组件

自定义组件的基本用法

数据传递与处理

生命周期定义

动态创建组件

数据类型说明

组件参考（兼容JS的类Web开发范式-ArkUI.Lite）

HML语法参考

CSS语法参考

组件通用信息

CanvasRenderingContext2D对象

JS服务卡片UI组件参考

JS服务卡片UI框架说明

HML语法参考

CSS语法参考

多语言支持

版本兼容适配

设置主题样式

自定义字体样式

自定义组件使用说明

数据类型说明

错误码参考

通用错误码

元能力子系统错误码

DistributedSchedule错误码

卡片错误码

包管理子系统通用错误码

zlib子系统错误码

公共事件与通知

事件错误码

通知错误码

DistributedNotificationService错误码

动画错误码

弹窗错误码

页面路由错误码

色彩管理错误码

屏幕错误码

窗口错误码

资源管理错误码

backgroundTaskManager错误码

reminderAgentManager错误码

workScheduler错误码

AccessToken错误码

crypto framework错误码

用户认证错误码

关系型数据库错误码

分布式数据对象错误码

分布式键值数据库错误码

用户首选项错误码

文件管理错误码

电话子系统错误码

上传下载错误码

Socket 错误码

网络连接管理错误码

通信与连接

蓝牙服务子系统错误码

系统基础能力

无障碍子系统错误码

Faultlogger 错误码

应用事件打点错误码

系统事件错误码

Hidebug错误码

输入法框架错误码

剪贴板错误码

时间时区服务错误码

Webview错误码

帐号管理错误码

耗电统计错误码

屏幕亮度错误码

系统电源管理错误码

RunningLock锁错误码

热管理错误码

设备管理错误码

位置服务子系统错误码

传感器错误码

振动错误码

USB服务错误码

语言基础类库

语言基础类库错误码

uitest错误码

Native API参考

Archived

Native XComponent

OH_NativeBuffer

NeuralNetworkRuntime

HuksParamSetApi

drawing_bitmap.h

drawing_brush.h

drawing_canvas.h

drawing_color.h

drawing_font_collection.h

drawing_text_declaration.h

drawing_text_typography.h

drawing_types.h

external_window.h

image_pixel_map_napi.h

native_buffer.h

native_interface_xcomponent.h

raw_file_manager.h

neural_network_runtime_type.h

neural_network_runtime.h

native_avcodec_audiodecoder.h

native_avcodec_audioencoder.h

native_avcodec_base.h

native_avcodec_videodecoder.h

native_avcodec_videoencoder.h

native_averrors.h

native_avformat.h

native_avmemory.h

native_huks_api.h

native_huks_param.h

native_huks_type.h

OH_Drawing_BitmapFormat

OH_NativeBuffer_Config

OH_NativeXComponent_Callback

OH_NativeXComponent_MouseEvent

OH_NativeXComponent_MouseEvent_Callback

OH_NativeXComponent_TouchEvent

OH_NativeXComponent_TouchPoint

OHExtDataHandle

OhosPixelMapInfo

RawFileDescriptor

OH_AI_CallBackParam

OH_AI_ShapeInfo

OH_AI_TensorHandleArray

OH_NN_QuantParam

OH_NN_UInt32Array

OH_AVCodecAsyncCallback

OH_AVCodecBufferAttr

OH_Huks_CertChain

OH_Huks_KeyInfo

OH_Huks_KeyMaterial25519

OH_Huks_KeyMaterialDh

OH_Huks_KeyMaterialDsa

OH_Huks_KeyMaterialEcc

OH_Huks_KeyMaterialRsa

OH_Huks_ParamSet

OH_Huks_PubKeyInfo

Native API中支持的标准库

Native api中没有导出的符号列表

Native api中导出的EGL符号列表

Native api中导出的OpenGL ES 3.2符号列表

Native api中支持的OpenSL ES接口列表

您当前浏览的3.1/4.0版本文档归档不再维护，推荐您使用最新的HarmonyOS NEXT版本文档。详细请参考文档维护策略变更。

dialog

更新时间: 2024-04-15 08:42

本文导读

展开章节

说明

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

自定义弹窗容器。

权限列表

无

子组件

支持单个子组件。

示例

属性

除支持通用属性外，支持如下属性：

展开

名称	类型	默认值	必填	描述
dragable⁷⁺	boolean	false	否	设置对话框是否支持拖拽。

说明

弹窗类组件不支持focusable、click-effect属性。

样式

仅支持通用样式中的width、height、margin、margin-[left|top|right|bottom]、margin-[start|end]样式。

事件

不支持通用事件，仅支持如下事件：

展开

名称	参数	描述
cancel	-	用户点击非dialog区域触发取消弹窗时触发的事件。
show⁷⁺	-	对话框弹出时触发该事件。
close⁷⁺	-	对话框关闭时触发该事件。

方法

不支持通用方法，仅支持如下方法。

展开

名称	参数	描述
show	-	弹出对话框。
close	-	关闭对话框。

说明

dialog属性、样式均不支持动态更新。

在 API参考中进行搜索

只在容器组件中搜索只搜索章节标题

请输入您想要搜索的关键词