diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-methods-custom-dialog-box.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-methods-custom-dialog-box.md index af1470f271fe54cd2ceef247f1cca22eb24cc74b..3618aac897568839f02859b8559c2812a05ee0e6 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-methods-custom-dialog-box.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-methods-custom-dialog-box.md @@ -40,7 +40,7 @@ constructor(value: CustomDialogControllerOptions) | autoCancel | boolean | 否 | 是否允许点击遮障层退出，true表示关闭弹窗。false表示不关闭弹窗。
默认值：true
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | alignment | [DialogAlignment](ts-methods-alert-dialog-box.md#dialogalignment枚举说明) | 否 | 弹窗在竖直方向上的对齐方式。
默认值：DialogAlignment.Default
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | offset | [Offset](ts-types.md#offset) | 否 | 弹窗相对alignment所在位置的偏移量。
默认值：{ dx: 0, dy: 0 }
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| customStyle | boolean | 否 | 弹窗容器样式是否自定义。值为true表示弹窗容器样式不能自定义，值为false表示弹窗样式可以自定义。
设置false时（默认值）：
1、圆角为32vp。
2、未设置弹窗宽度高度：弹窗容器的宽度根据栅格系统自适应。高度自适应自定义的内容节点。
3、设置弹窗宽度高度：弹窗容器的宽度不超过默认样式下的最大宽度（自定义节点设置100%的宽度），弹窗容器的高度不超过默认样式下的最大高度（自定义节点设置100%的高度）。
设置为true：
1、圆角为0，弹窗背景色为透明色。
2、不支持设置弹窗宽度、高度、边框宽度、边框样式、边框颜色以及阴影宽度。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| +| customStyle | boolean | 否 | 弹窗容器样式是否自定义。值为true表示弹窗容器样式不能自定义，值为false表示弹窗样式可以自定义。
设置false时（默认值）：
1.圆角为32vp。
2.未设置弹窗宽度高度：弹窗容器的宽度根据栅格系统自适应。高度自适应自定义的内容节点。
3.设置弹窗宽度高度：弹窗容器的宽度不超过默认样式下的最大宽度（自定义节点设置100%的宽度），弹窗容器的高度不超过默认样式下的最大高度（自定义节点设置100%的高度）。
4.受安全区域的影响，弹窗显示区域将排除安全区域。
设置为true：
1.圆角为0，弹窗背景色为透明色。
2.不支持设置弹窗宽度、高度、边框宽度、边框样式、边框颜色以及阴影宽度。
3.弹窗显示区域为屏幕。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| | gridCount8+ | number | 否 | 弹窗宽度占[栅格宽度](../../../ui/arkts-layout-development-grid-layout.md)的个数。
默认为按照窗口大小自适应，异常值按默认值处理，最大栅格数为系统最大栅格数。
取值范围：大于等于0的整数。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | maskColor10+ | [ResourceColor](ts-types.md#resourcecolor) | 否 | 自定义蒙层颜色。
默认值：0x33000000
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | maskRect10+ | [Rectangle](ts-methods-alert-dialog-box.md#rectangle8类型说明) | 否 | 弹窗遮蔽层区域，在遮蔽层区域内的事件不透传，在遮蔽层区域外的事件透传。
默认值：{ x: 0, y: 0, width: '100%', height: '100%' }
**说明：**
showInSubWindow为true时，maskRect不生效。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| @@ -83,7 +83,6 @@ constructor(value: CustomDialogControllerOptions) > - 为了达成良好的视觉体验，弹窗的显示和关闭存在默认动画，动画时长不同设备间可能存在差异。 > 需要注意：在动画播放过程中，页面不响应触摸、滑动、点击操作。关闭默认弹窗动画效果可设置openAnimation和closeAnimation的duration为0。 > - 当前，ArkUI弹出框默认为非页面级弹出框，在页面路由跳转时，如果开发者未调用close方法将其关闭，弹出框将不会自动关闭。若需实现在跳转页面时覆盖弹出框的场景，可以使用[组件导航子页面显示类型的弹窗类型](../../../ui/arkts-navigation-navigation.md#页面显示类型)或者[页面级弹出框](../../../ui/arkts-embedded-dialog.md)。 -> - customStyle为true时，弹窗显示区域为屏幕；为false时，受安全区域的影响，弹窗显示区域将排除安全区域。 ## DismissDialogAction12+ @@ -1109,7 +1108,7 @@ struct Example3 { ### 示例10（不同customStyle下的弹窗示例） -该示例时在对齐方式为DialogAlignment.Bottom时，展示customStyle不同值下，弹窗内容与安全区域的效果。 +该示例是在对齐方式为DialogAlignment.Bottom时，展示customStyle不同值下，弹窗内容与安全区域的效果。 ```ts @CustomDialog diff --git a/zh-cn/application-dev/reference/apis-arkui/js-apis-arkui-UIContext.md b/zh-cn/application-dev/reference/apis-arkui/js-apis-arkui-UIContext.md index 8fe9f09bb6716f5ceccc545e0bf48eadcd7faeeb..7276aa2ee46e7204875c37aa21df71f743348827 100644 --- a/zh-cn/application-dev/reference/apis-arkui/js-apis-arkui-UIContext.md +++ b/zh-cn/application-dev/reference/apis-arkui/js-apis-arkui-UIContext.md @@ -7180,8 +7180,8 @@ openCustomDialog\(dialogContent: ComponentContent\, options ```ts import { ComponentContent } from '@kit.ArkUI'; import { AbilityConstant, Configuration, EnvironmentCallback, ConfigurationConstant } from '@kit.AbilityKit'; -import { BusinessError } from "@kit.BasicServicesKit"; -import { resourceManager } from '@kit.LocalizationKit' +import { BusinessError } from '@kit.BasicServicesKit'; +import { resourceManager } from '@kit.LocalizationKit'; class Params { text: string = ""; @@ -7218,10 +7218,10 @@ struct Index { console.log("onConfigurationUpdated " + JSON.stringify(config)); this.getUIContext().getHostContext()?.getApplicationContext().resourceManager.getConfiguration((err, config) => { - // 调用ComponentContent的update更新colorMode信息。 + // 调用ComponentContent的update更新colorMode信息 this.contentNode?.update(new Params(this.message, config.colorMode)) setTimeout(() => { - // 调用ComponentContent的updateConfiguration，触发节点的全量更新。 + // 调用ComponentContent的updateConfiguration，触发节点的全量更新 this.contentNode?.updateConfiguration() }) }) diff --git a/zh-cn/application-dev/reference/apis-arkui/js-apis-promptAction-sys.md b/zh-cn/application-dev/reference/apis-arkui/js-apis-promptAction-sys.md index e463902aab017fa892cda548070913d92b44af3a..4d2e02da989881e03dfd5f3ca8caef0a2696474e 100644 --- a/zh-cn/application-dev/reference/apis-arkui/js-apis-promptAction-sys.md +++ b/zh-cn/application-dev/reference/apis-arkui/js-apis-promptAction-sys.md @@ -16,7 +16,7 @@ import { promptAction } from '@kit.ArkUI'; ### ToastShowMode -设置弹窗显示模式，默认显示在应用内，支持显示在应用之上。 +设置弹窗显示模式，默认显示在应用内，支持显示在子窗。 **系统接口：** 此接口为系统接口。 diff --git a/zh-cn/application-dev/reference/apis-arkui/js-apis-promptAction.md b/zh-cn/application-dev/reference/apis-arkui/js-apis-promptAction.md index 6d9be7e2ad32587202cdd1c103b655bb7bcd9093..34d089a3702cc4b7e48369ef201f6b7359eb243a 100644 --- a/zh-cn/application-dev/reference/apis-arkui/js-apis-promptAction.md +++ b/zh-cn/application-dev/reference/apis-arkui/js-apis-promptAction.md @@ -143,7 +143,7 @@ closeToast(toastId: number): void | message | string \| [Resource](arkui-ts/ts-types.md#resource) | 是 | 显示的文本信息。
**说明：**
默认字体为'Harmony Sans'，不支持设置其他字体。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | duration | number | 否 | 默认值1500ms，取值区间：1500ms-10000ms。若小于1500ms则取默认值，若大于10000ms则取上限值10000ms。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | bottom | string \| number | 否 | 设置弹窗底部边框距离导航条的高度，ToastShowMode.TOP_MOST模式下，软键盘拉起时，如果bottom值过小，toast要被软键盘遮挡时，会自动避让至距离软键盘80vp处。ToastShowMode.DEFAULT模式下，软键盘拉起时，会上移软键盘的高度。
默认值：80vp
**说明：**
当底部没有导航条时，bottom为设置弹窗底部边框距离窗口底部的高度。
设置对齐方式alignment后，bottom不生效。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| showMode11+ | [ToastShowMode](#toastshowmode11) | 否 | 设置弹窗是否显示在应用之上。
默认值：ToastShowMode.DEFAULT，默认显示在应用内。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | +| showMode11+ | [ToastShowMode](#toastshowmode11) | 否 | 设置弹窗层级。
默认值：ToastShowMode.DEFAULT，默认显示在应用内。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | | alignment12+ | [Alignment](arkui-ts/ts-appendix-enums.md#alignment) | 否 | 对齐方式。
**说明：**
不同alignment下，Toast位置对齐效果，如下图所示。
![zh-cn_image_0001](figures/toast_alignment.PNG)
Toast的文本显示默认自左向右，不支持其他对齐方式。
默认值：undefined，默认底部偏上位置。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | | offset12+ | [Offset](arkui-ts/ts-types.md#offset) | 否 | 在对齐方式上的偏移。
默认值：{ dx: 0, dy: 0 }，默认没有偏移。
**说明：**
只支持设置px类型的数值，如需设置vp，可以将vp改成px传入。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | | backgroundColor12+ | [ResourceColor](arkui-ts/ts-types.md#resourcecolor) | 否 | 文本提示框背板颜色。
默认值：Color.Transparent
**说明：**
backgroundColor会与模糊属性backgroundBlurStyle叠加产生效果，如果不符合预期，可将backgroundBlurStyle设置为BlurStyle.NONE，即可取消模糊。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | @@ -155,7 +155,7 @@ closeToast(toastId: number): void ## ToastShowMode11+ -设置弹窗显示模式，默认显示在应用内，支持显示在应用之上。 +设置弹窗显示模式，默认显示在应用内，支持显示在子窗。 **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 @@ -163,8 +163,8 @@ closeToast(toastId: number): void | 名称 | 值 | 说明 | | -------- | ---- | ---------------------- | -| DEFAULT | 0 | Toast 显示在应用内。 | -| TOP_MOST | 1 | Toast 显示在应用之上。 | +| DEFAULT | 0 | Toast显示在应用内。 | +| TOP_MOST | 1 | Toast显示在子窗上。 | ## ShowDialogOptions @@ -656,6 +656,8 @@ showToast(options: ShowToastOptions): void > 从API version 18开始废弃，且直接使用showToast可能导致[UI上下文不明确](../../ui/arkts-global-interface.md)的问题，建议使用[UIContext](js-apis-arkui-UIContext.md#uicontext)中的[getPromptAction](js-apis-arkui-UIContext.md#getpromptaction)获取[PromptAction](js-apis-arkui-UIContext.md#promptaction)实例，再通过此实例调用替代方法[showToast](js-apis-arkui-UIContext.md#showtoast)。 > > 从API version 10开始，可以通过使用[UIContext](js-apis-arkui-UIContext.md#uicontext)中的[getPromptAction](js-apis-arkui-UIContext.md#getpromptaction)方法获取当前UI上下文关联的[PromptAction](js-apis-arkui-UIContext.md#promptaction)对象。 +> +> Toast样式单一，不支持内容的自定义，具体支持能力请参考[ShowToastOptions](#showtoastoptions)提供的接口。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 diff --git a/zh-cn/application-dev/ui/arkts-dialog-overview.md b/zh-cn/application-dev/ui/arkts-dialog-overview.md index 85550e7de4aa96190ad953a03c7f1852741d8cb0..48cbd3a4af4f256de8dee9edd378b76a45653572 100644 --- a/zh-cn/application-dev/ui/arkts-dialog-overview.md +++ b/zh-cn/application-dev/ui/arkts-dialog-overview.md @@ -16,7 +16,7 @@ > > 系统弹窗由系统弹出，出于安全考虑，不支持自定义样式。 > -> 系统弹窗由系统弹出，出于安全考虑，不支持自定义样式，不支持在其存在情况下调用接口显示非系统的弹窗。 +> 系统弹窗出现时，调用非系统弹窗的显示接口（例如：promptAction的openCustomDialog、CustomDialogController的open等），禁止该类弹窗显示。 ## 使用场景