From 75e3b0eaf46ef51f8023dcc01996fc4e618081c6 Mon Sep 17 00:00:00 2001 From: liuhui Date: Fri, 4 Jul 2025 15:32:00 +0800 Subject: [PATCH 1/2] =?UTF-8?q?=E6=A3=80=E8=A7=86=E6=84=8F=E8=A7=81?= =?UTF-8?q?=E4=BF=AE=E6=94=B9=20Signed-off-by:=20liuhui=20?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../reference/apis-arkui/Readme-CN.md | 2 +- .../apis-arkui/_ark_u_i___native_module.md | 4 +-- .../ts-universal-accessibility-event.md | 26 +++++++++---------- 3 files changed, 16 insertions(+), 16 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-arkui/Readme-CN.md b/zh-cn/application-dev/reference/apis-arkui/Readme-CN.md index 39ac498dae9..6cfc7e5c134 100644 --- a/zh-cn/application-dev/reference/apis-arkui/Readme-CN.md +++ b/zh-cn/application-dev/reference/apis-arkui/Readme-CN.md @@ -101,7 +101,7 @@ - [自定义事件拦截](arkui-ts/ts-universal-attributes-on-touch-intercept.md) - [自定义事件分发](arkui-ts/ts-universal-attributes-on-child-touch-test.md) - 无障碍相关 - - [无障碍事件](arkui-ts/ts-universal-accessibility-event.md) + - [无障碍控制操作](arkui-ts/ts-universal-accessibility-event.md) - [无障碍悬浮事件](arkui-ts/ts-universal-accessibility-hover-event.md) - 组件变化事件 - [挂载卸载事件](arkui-ts/ts-universal-events-show-hide.md) diff --git a/zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md b/zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md index 3307f154643..fc73337a830 100644 --- a/zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md +++ b/zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md @@ -19224,7 +19224,7 @@ void OH_ArkUI_EmbeddedComponentOption_SetOnError(ArkUI_EmbeddedComponentOption* **描述** -设置EmbeddedComponent组件的onError回调。 +设置EmbeddedComponent组件的[onError](./arkui-ts/ts-container-embedded-component.md#onerror)回调。 **起始版本：** 20 @@ -19245,7 +19245,7 @@ void OH_ArkUI_EmbeddedComponentOption_SetOnTerminated(ArkUI_EmbeddedComponentOpt **描述** -设置EmbeddedComponent组件的onTerminated回调。 +设置EmbeddedComponent组件的[onTerminated](./arkui-ts/ts-container-embedded-component.md#terminationInfo)回调。 **起始版本：** 20 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-accessibility-event.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-accessibility-event.md index 60e1cf184ce..dbace247e5b 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-accessibility-event.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-accessibility-event.md @@ -1,6 +1,6 @@ -# 无障碍事件 +# 无障碍控制操作 -在开启无障碍模式后，需要判断是否拦截无障碍事件。 +在开启无障碍模式后，需要判断是否拦截无障碍控制操作。 >**说明：** > @@ -51,7 +51,7 @@ type AccessibilityFocusCallback = (isFocus: boolean) => void onAccessibilityActionIntercept(callback: AccessibilityActionInterceptCallback): T -该接口在无障碍模式下，可在无障碍事件触发前通知注册的回调函数，由注册方决定是否拦截该次无障碍事件。 +该接口在无障碍模式下，可在无障碍控制操作触发前通知注册的回调函数，由注册方决定是否拦截该次无障碍动作，对不支持Click的组件注册也无法触发回调。 **卡片能力：** 从API version 20开始，该接口支持在ArkTS卡片中使用。 @@ -63,7 +63,7 @@ onAccessibilityActionIntercept(callback: AccessibilityActionInterceptCallback): | 参数名 | 类型 | 必填 | 说明 | | -------- | ------- | ---- | ------------------------------------------------------------ | -| callback | [AccessibilityActionInterceptCallback](ts-universal-accessibility-event.md#accessibilityactioninterceptcallback20) | 是 | 在无障碍事件触发前，向注册回调函数方通知，由注册方决定是否拦截该次无障碍事件。 | +| callback | [AccessibilityActionInterceptCallback](ts-universal-accessibility-event.md#accessibilityactioninterceptcallback20) | 是 | 在无障碍控制操作触发前，向注册回调函数方通知，由注册方决定是否拦截该次无障碍控制操作。
入参设置undefined时取消回调注册。 | **返回值：** @@ -87,17 +87,17 @@ type AccessibilityActionInterceptCallback = (action: AccessibilityAction) => Acc | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ---------------- | -| action | [AccessibilityAction](ts-universal-accessibility-event.md#accessibilityaction20枚举说明) | 是 | 当前触发的无障碍事件类型。 | +| action | [AccessibilityAction](ts-universal-accessibility-event.md#accessibilityaction20枚举说明) | 是 | 当前触发的无障碍控制操作类型。 | **返回值：** | 类型 | 说明 | | ------ | ---------------- | -| [AccessibilityActionInterceptResult](ts-universal-accessibility-event.md#accessibilityactioninterceptresult20枚举说明) | 无障碍事件拦截结果。 | +| [AccessibilityActionInterceptResult](ts-universal-accessibility-event.md#accessibilityactioninterceptresult20枚举说明) | 无障碍控制操作拦截结果。 | ## AccessibilityAction20+枚举说明 -定义组件当前触发的无障碍事件类型。 +定义组件当前触发的无障碍控制操作类型。 **卡片能力：** 从API version 20开始，该接口支持在ArkTS卡片中使用。 @@ -107,12 +107,12 @@ type AccessibilityActionInterceptCallback = (action: AccessibilityAction) => Acc | 名称 | 值 | 说明 | | ---- | ---- | ------------------ | -| UNDEFINED_ACTION | 0 | 未定义的无障碍事件。 | -| ACCESSIBILITY_CLICK | 1 | 无障碍点击事件。 | +| UNDEFINED_ACTION | 0 | 未定义的无障碍操作。 | +| ACCESSIBILITY_CLICK | 1 | 无障碍点击操作。 | ## AccessibilityActionInterceptResult20+枚举说明 -定义AccessibilityActionInterceptCallback的无障碍事件拦截结果。 +定义AccessibilityActionInterceptCallback的无障碍控制操作拦截结果。 **卡片能力：** 从API version 20开始，该接口支持在ArkTS卡片中使用。 @@ -122,9 +122,9 @@ type AccessibilityActionInterceptCallback = (action: AccessibilityAction) => Acc | 名称 | 值 | 说明 | | ---- | ---- | ------------------ | -| ACTION_INTERCEPT | 0 | 拦截当前组件接收的无障碍事件。 | -| ACTION_CONTINUE | 1 | 继续执行当前组件接收的无障碍事件。 | -| ACTION_RISE | 2 | 判断本组件当前接收的无障碍事件是否拦截并冒泡查询有onAccessibilityActionIntercept注册的祖先组件并执行其回调，以祖先组件的返回值，来确定本组件的拦截结果。如果祖先组件的拦截结果仍然是ACTION_RISE，则继续冒泡查询和执行。 | +| ACTION_INTERCEPT | 0 | 拦截当前组件接收的无障碍控制操作，回调处理结束后，不允许当前组件响应无障碍控制操作。 | +| ACTION_CONTINUE | 1 | 拦截当前组件接收的无障碍控制操作, 回调处理结束后，仍然需要组件做出响应，执行当前组件的处理逻辑。 | +| ACTION_RISE | 2 | 拦截执行当前组件接收的无障碍控制操作，回调处理结束后，仍然需要组件做出响应，执行当前组件的处理逻辑，并且将ACTION信息往父组件传递，传递到下一个使用了onAccessibilityActionIntercept的组件，触发当前组件中注册的回调，但不触发组件处理逻辑。处理完成后，可以继续使用RISE向父组件传递ACTION。 | ## 示例 -- Gitee From 08d94a1e87b72247e1e4abd9fbbe116429061180 Mon Sep 17 00:00:00 2001 From: liuhui Date: Fri, 4 Jul 2025 11:45:59 +0000 Subject: [PATCH 2/2] update zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md. Signed-off-by: liuhui --- .../reference/apis-arkui/_ark_u_i___native_module.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md b/zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md index fc73337a830..bfae5546495 100644 --- a/zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md +++ b/zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md @@ -19245,7 +19245,7 @@ void OH_ArkUI_EmbeddedComponentOption_SetOnTerminated(ArkUI_EmbeddedComponentOpt **描述** -设置EmbeddedComponent组件的[onTerminated](./arkui-ts/ts-container-embedded-component.md#terminationInfo)回调。 +设置EmbeddedComponent组件的[onTerminated](./arkui-ts/ts-container-embedded-component.md#onterminated)回调。 **起始版本：** 20 -- Gitee