From 35445dec2b6901bc3ca80ba93bc379946807ae4b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=A7=9A=E6=98=8E?= Date: Mon, 23 Jun 2025 21:48:20 +0800 Subject: [PATCH] =?UTF-8?q?=E8=B5=84=E6=96=99=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 姚明 --- .../arkui-ts/ts-methods-custom-dialog-box.md | 5 ++--- .../reference/apis-arkui/js-apis-arkui-UIContext.md | 8 ++++---- .../reference/apis-arkui/js-apis-promptAction-sys.md | 2 +- .../reference/apis-arkui/js-apis-promptAction.md | 10 ++++++---- 4 files changed, 13 insertions(+), 12 deletions(-) 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 d6743ce78e1..9c01ce002e6 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+ @@ -1019,7 +1018,7 @@ struct Example3 { ### 示例9（不同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 e5a7a148e7e..06ad90b30d9 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 @@ -6794,8 +6794,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 = ""; @@ -6832,10 +6832,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 e463902aab0..4d2e02da989 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 1195b2eb92c..f51a1dcd366 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 @@ -142,7 +142,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开始，该接口支持在原子化服务中使用。 | @@ -154,7 +154,7 @@ closeToast(toastId: number): void ## ToastShowMode11+ -设置弹窗显示模式，默认显示在应用内，支持显示在应用之上。 +设置弹窗显示模式，默认显示在应用内，支持显示在子窗。 **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 @@ -162,8 +162,8 @@ closeToast(toastId: number): void | 名称 | 值 | 说明 | | -------- | ---- | ---------------------- | -| DEFAULT | 0 | Toast 显示在应用内。 | -| TOP_MOST | 1 | Toast 显示在应用之上。 | +| DEFAULT | 0 | Toast显示在应用内。 | +| TOP_MOST | 1 | Toast显示在子窗上。 | ## ShowDialogOptions @@ -547,6 +547,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开始，该接口支持在原子化服务中使用。 -- Gitee