!20850 # 17FZEN

Merge pull request !20850 from Peihao Ying/cherry-pick-1689237876

zh-cn/application-dev/reference/apis/js-apis-window.md

@@ -830,7 +830,7 @@ off(type: 'systemBarTintChange', callback?: Callback<SystemBarTintState >)
 | 参数名   | 类型                                                       | 必填 | 说明                                                         |
 | -------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ |
 | type     | string                                                     | 是   | 监听事件，固定为'systemBarTintChange'，即导航栏、状态栏属性变化事件。 |
-| callback | Callback<[SystemBarTintState](#systembartintstate8)> | 否   | 回调函数。返回当前的状态栏、导航栏信息集合。                 |
+| callback | Callback<[SystemBarTintState](#systembartintstate8)> | 否   | 回调函数。返回当前的状态栏、导航栏信息集合。如果传入参数，则关闭该监听。如果未传入参数，则关闭所有状态栏、导航栏属性变化的监听。                |
 
 **示例：**
 
@@ -886,7 +886,7 @@ off(type: 'gestureNavigationEnabledChange', callback?: Callback<boolean>):
 | 参数名   | 类型                     | 必填 | 说明                                                        |
 | -------- | ----------------------- | -- | ------------------------------------------------------------ |
 | type     | string                  | 是 | 监听事件，固定为'gestureNavigationEnabledChange'，即手势导航启用状态变化事件。 |
-| callback | Callback<boolean> | 否 | 已注册的回调函数。参数传入时表示只移除该监听；参数未传入时表示移除所有手势导航启用状态变化的监听。 |
+| callback | Callback<boolean> | 否 | 已注册的回调函数。如果传入参数，则关闭该监听。如果未传入参数，则关闭所有手势导航启用状态变化的监听。 |
 
 **示例：**
 
@@ -2726,7 +2726,7 @@ off(type: 'windowSizeChange', callback?: Callback<Size>): void
 | 参数名   | 类型                          | 必填 | 说明                                                     |
 | -------- | ----------------------------- | ---- | -------------------------------------------------------- |
 | type     | string                        | 是   | 监听事件，固定为'windowSizeChange'，即窗口尺寸变化事件。 |
-| callback | Callback<[Size](#size7)> | 否   | 回调函数。返回当前的窗口尺寸。                           |
+| callback | Callback<[Size](#size7)> | 否   | 回调函数。返回当前的窗口尺寸。如果传入参数，则关闭该监听。如果未传入参数，则关闭窗口尺寸变化的监听。                           |
 
 **示例：**
 
@@ -2779,7 +2779,7 @@ off(type: 'avoidAreaChange', callback?: Callback<{AvoidAreaType, AvoidArea}&g
 | 参数名   | 类型                                                                          | 必填  | 说明                                 |
 | -------- |-----------------------------------------------------------------------------|-----|------------------------------------|
 | type     | string                                                                      | 是   | 监听事件，固定为'avoidAreaChange'，即系统规避区变化事件。 |
-| callback | Callback<{[AvoidAreaType](#avoidareatype7), [AvoidArea](#avoidarea7)}> | 否   | 回调函数。返回当前规避区以及规避区类型。|
+| callback | Callback<{[AvoidAreaType](#avoidareatype7), [AvoidArea](#avoidarea7)}> | 否   | 回调函数。返回当前规避区以及规避区类型。如果传入参数，则关闭该监听。如果未传入参数，则关闭所有系统规避区变化的监听。|
 
 **示例：**
 
@@ -2831,7 +2831,7 @@ off(type: 'keyboardHeightChange', callback?: Callback<number>): void
 | 参数名   | 类型                   | 必填 | 说明                                                         |
 | -------- | ---------------------- | ---- | ------------------------------------------------------------ |
 | type     | string                 | 是   | 监听事件，固定为'keyboardHeightChange'，即键盘高度变化事件。 |
-| callback | Callback<number> | 否   | 回调函数。返回当前的键盘高度，返回值为整数。                               |
+| callback | Callback<number> | 否   | 回调函数。返回当前的键盘高度，返回值为整数。若传入参数，则关闭该监听。如果未传入参数，则关闭所有固定态输入法窗口软键盘高度变化的监听。                               |
 
 **示例：**
 
@@ -2887,7 +2887,7 @@ off(type: 'touchOutside', callback?: Callback<void>): void
 | 参数名   | 类型                   | 必填 | 说明                                   |
 | -------- |----------------------| ---- |--------------------------------------|
 | type     | string               | 是   | 监听事件，固定为'touchOutside'，即本窗口范围外的点击事件。 |
-| callback | Callback<void> | 否   | 回调函数。当点击事件发生在本窗口范围之外的回调。             |
+| callback | Callback<void> | 否   | 回调函数。当点击事件发生在本窗口范围之外的回调。如果传入参数，则关闭该监听。如果未传入参数，则关闭所有本窗口区域范围外的点击事件的监听。            |
 
 **示例：**
 
@@ -2939,7 +2939,7 @@ off(type: 'screenshot', callback?: Callback<void>): void
 | 参数名   | 类型                   | 必填 | 说明                                                         |
 | -------- | ---------------------- | ---- | ------------------------------------------------------------ |
 | type     | string                 | 是   | 监听事件，固定为'screenshot'，即截屏事件。 |
-| callback | Callback<void> | 否   | 回调函数。发生截屏事件时的回调。 |
+| callback | Callback<void> | 否   | 回调函数。发生截屏事件时的回调。若传入参数，则关闭该监听。若未传入参数，则关闭所有截屏事件的监听。 |
 
 **示例：**
 
@@ -3001,7 +3001,7 @@ off(type: 'dialogTargetTouch', callback?: Callback<void>): void
 | 参数名   | 类型                    | 必填 | 说明                                                          |
 | -------- | ---------------------- | ---- | ------------------------------------------------------------ |
 | type     | string                 | 是   | 监听事件，固定为'dialogTargetTouch'，即模态窗口目标窗口的点击事件。 |
-| callback | Callback<void>      | 否   | 回调函数。当点击事件发生在模态窗口目标窗口的回调。 |
+| callback | Callback<void>      | 否   | 回调函数。当点击事件发生在模态窗口目标窗口的回调。若传入参数，则关闭该监听。若未传入参数，则关闭所有模态窗口目标窗口的点击事件的监听。 |
 
 **示例：**
 
@@ -3053,7 +3053,7 @@ off(type: 'windowEvent', callback?: Callback<WindowEventType >): void
 | 参数名   | 类型                                                       | 必填 | 说明                                                         |
 | -------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ |
 | type     | string                                                     | 是   | 监听事件，固定为'windowEvent'，即窗口生命周期变化事件。 |
-| callback | Callback<[WindowEventType](#windoweventtype10)> | 否   | 回调函数。返回当前的窗口生命周期状态。                 |
+| callback | Callback<[WindowEventType](#windoweventtype10)> | 否   | 回调函数。返回当前的窗口生命周期状态。若传入参数，则关闭该监听。若未传入参数，则关闭所有窗口生命周期变化的监听。                 |
 
 **示例：**
 
@@ -5865,7 +5865,7 @@ off(type: 'systemAvoidAreaChange', callback?: Callback<AvoidArea>): void
 | 参数名   | 类型                                       | 必填 | 说明                                                    |
 | -------- |------------------------------------------| ---- | ------------------------------------------------------- |
 | type     | string                                   | 是   | 监听事件，固定为'systemAvoidAreaChange'，即系统规避区变化事件。 |
-| callback | Callback<[AvoidArea](#avoidarea7)> | 否   | 回调函数。返回当前规避区。                            |
+| callback | Callback<[AvoidArea](#avoidarea7)> | 否   | 回调函数。返回当前规避区。若传入参数，则关闭该监听。若未传入参数，则关闭所有系统规避区变化的监听。           |
 
 **示例：**
 
@@ -7191,7 +7191,7 @@ off(eventType: 'windowStageEvent', callback?: Callback<WindowStageEventType&g
 | 参数名   | 类型                                                         | 必填 | 说明                                                         |
 | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
 | type     | string                                                       | 是   | 监听事件，固定为'windowStageEvent'，即WindowStage生命周期变化事件。 |
-| callback | Callback<[WindowStageEventType](#windowstageeventtype9)> | 否   | 回调函数。返回当前的WindowStage生命周期状态。                |
+| callback | Callback<[WindowStageEventType](#windowstageeventtype9)> | 否   | 回调函数。返回当前的WindowStage生命周期状态。若传入参数，则关闭该监听。若未传入参数，则关闭所有WindowStage生命周期变化的监听。                |
 
 **错误码：**