!21023 接口一致性整改

Merge pull request !21023 from 田雨/master

zh-cn/application-dev/reference/apis/js-apis-arkui-drawableDescriptor.md

@@ -80,7 +80,8 @@ getPixelMap(): image.PixelMap;
 
 **示例：**
   ```ts
-pixmap: PixelMap = (<DrawableDescriptor> (this.resManager.getDrawableDescriptor($r('app.media.icon')
+let resManager = getContext().resourceManager
+pixmap: PixelMap = (<DrawableDescriptor> (resManager.getDrawableDescriptor($r('app.media.icon')
     .id))).getPixelMap();
   ```
 
@@ -99,7 +100,8 @@ getPixelMap(): image.PixelMap;
 
 **示例：**
   ```ts
-pixmap: PixelMap = (<LayeredDrawableDescriptor> (this.resManager.getDrawableDescriptor($r('app.media.drawable')
+let resManager = getContext().resourceManager
+pixmap: PixelMap = (<LayeredDrawableDescriptor> (resManager.getDrawableDescriptor($r('app.media.drawable')
           .id))).getPixelMap();
   ```
 
@@ -118,7 +120,8 @@ getForeground(): DrawableDescriptor;
 
 **示例：**
   ```ts
-drawable: DrawableDescriptor = (<LayeredDrawableDescriptor> (this.resManager.getDrawableDescriptor($r('app.media.drawable')
+let resManager = getContext().resourceManager
+drawable: DrawableDescriptor = (<LayeredDrawableDescriptor> (resManager.getDrawableDescriptor($r('app.media.drawable')
     .id))).getForeground();
   ```
 
@@ -137,7 +140,8 @@ getBackground(): DrawableDescriptor;
 
 **示例：**
   ```ts
-drawable: DrawableDescriptor = (<LayeredDrawableDescriptor> (this.resManager.getDrawableDescriptor($r('app.media.drawable')
+let resManager = getContext().resourceManager
+drawable: DrawableDescriptor = (<LayeredDrawableDescriptor> (resManager.getDrawableDescriptor($r('app.media.drawable')
     .id))).getBackground();
   ```
 
@@ -156,7 +160,8 @@ getMask(): DrawableDescriptor;
 
 **示例：**
   ```ts
-drawable: DrawableDescriptor = (<LayeredDrawableDescriptor> (this.resManager.getDrawableDescriptor($r('app.media.drawable')
+let resManager = getContext().resourceManager
+drawable: DrawableDescriptor = (<LayeredDrawableDescriptor> (resManager.getDrawableDescriptor($r('app.media.drawable')
     .id))).getMask();
   ```
 ## LayeredDrawableDescriptor.getMashClipPath

zh-cn/application-dev/reference/apis/js-apis-arkui-inspector.md

@@ -48,7 +48,7 @@ let listener = inspector.createComponentObserver('COMPONENT_ID'); //监听id为C
 
 on(type: 'layout', callback: () => void): void
 
-通过句柄向对应的查询条件注册回调，当组件布局或者绘制完成时会触发该回调。
+通过句柄向对应的查询条件注册回调，当组件布局完成时会触发该回调。
 
 **系统能力：** SystemCapability.ArkUI.ArkUI.Full
 
@@ -63,7 +63,7 @@ on(type: 'layout', callback: () => void): void
 
 off(type: 'layout', callback?: () => void): void
 
-通过句柄向对应的查询条件取消注册回调，当组件布局或者绘制完成时不在触发指定的回调。
+通过句柄向对应的查询条件取消注册回调，当组件布局完成时不在触发指定的回调。
 
 **系统能力：** SystemCapability.ArkUI.ArkUI.Full
 
@@ -71,9 +71,39 @@ off(type: 'layout', callback?: () => void): void
 
 | 参数名   | 类型   | 必填 | 说明 |
 | -------- | ------ | ---- | -------------------------------------------- |
-| type     | string | 是   | 必须填写字符串'layout'或‘draw’。<br>layout: 组件布局完成。<br>draw: 组件绘制完成。 |
+| type     | string | 是   | 必须填写字符串'layout'或'draw'。<br>layout: 组件布局完成。<br>draw: 组件绘制完成。 |
 | callback | void   | 否   | 需要取消注册的回调，如果参数缺省则取消注册该句柄下所有的回调。|
 
+### on
+
+on(type: 'draw', callback: () => void): void
+
+通过句柄向对应的查询条件注册回调，当组件绘制完成时会触发该回调。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：** 
+
+| 参数名   | 类型   | 必填 | 说明                                                         |
+| -------- | ------ | ---- | ------------------------------------------------------------ |
+| type     | string | 是   | 必须填写字符串'layout'或'draw'。<br>layout: 组件布局完成。<br>draw: 组件绘制完成。 |
+| callback | void   | 是   | 监听layout或draw的回调。                                     |
+
+### off
+
+off(type: 'draw', callback?: () => void): void
+
+通过句柄向对应的查询条件取消注册回调，当组件绘制完成时不在触发指定的回调。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：** 
+
+| 参数名   | 类型   | 必填 | 说明                                                         |
+| -------- | ------ | ---- | ------------------------------------------------------------ |
+| type     | string | 是   | 必须填写字符串'layout'或'draw'。<br>layout: 组件布局完成。<br>draw: 组件绘制完成。 |
+| callback | void   | 否   | 需要取消注册的回调，如果参数缺省则取消注册该句柄下所有的回调。 |
+
 **示例：**
 
   ```ts

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

@@ -43,80 +43,100 @@ let modePosition = componentUtils.getRectangleById("onClick");
 
 ## ComponentInfo
 
-| 名称           | 类型             | 说明                         |
-| ---------------|------------     | -----------------------------|
-| size           | [Size](#size) | 组件大小。                    |
-| localOffset    | [Offset](#offset) | 组件相对于父组件信息。         |
-| windowOffset   | [Offset](#offset) | 组件相对于窗口信息。           |
-| screenOffset   | [Offset](#offset) | 组件相对于屏幕信息。           |
-| translate      | [TranslateResult](#translateresult) | 组件平移信息。                |
-| scale          | [ScaleResult](#scaleresult) | 组件缩放信息。                |
-| rotate         | [RotateResult](#rotateresult) | 组件旋转信息。                |
-| transform      | [Matrix4Result](#matrix4result) | 仿射矩阵信息，根据入参创建的四阶矩阵对象。  |
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+| 名称           | 类型             | 必填           | 说明                         |
+| ---------------|------------     | -----------------------------| -----------------------------|
+| size           | [Size](#size) | 是 | 组件大小。                    |
+| localOffset    | [Offset](#offset) | 是 | 组件相对于父组件信息。         |
+| windowOffset   | [Offset](#offset) | 是 | 组件相对于窗口信息。           |
+| screenOffset   | [Offset](#offset) | 是 | 组件相对于屏幕信息。           |
+| translate      | [TranslateResult](#translateresult) | 是 | 组件平移信息。                |
+| scale          | [ScaleResult](#scaleresult) | 是 | 组件缩放信息。                |
+| rotate         | [RotateResult](#rotateresult) | 是 | 组件旋转信息。                |
+| transform      | [Matrix4Result](#matrix4result) | 是 | 仿射矩阵信息，根据入参创建的四阶矩阵对象。  |
 
 ### Size 
 
-| 名称     | 类型 | 说明                               |
-| -------- | ---- | ----------------------------------|
-| width    | number | 组件宽度。                         |
-| height   | number | 组件高度。                         |
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+| 名称     | 类型 | 必填 | 说明                               |
+| -------- | ---- | ----------------------------------| ----------------------------------|
+| width    | number | 是 | 组件宽度。                         |
+| height   | number | 是 | 组件高度。                         |
 
 ### Offset
 
-| 名称     | 类型 | 说明                               |
-| --------| ---- | -----------------------------------|
-| x       | number | x点坐标。                           |
-| y       | number | y点坐标。                           |
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+| 名称     | 类型 | 必填 | 说明                               |
+| --------| ---- | -----------------------------------| -----------------------------------|
+| x       | number | 是 | x点坐标。                           |
+| y       | number | 是 | y点坐标。                           |
 
 ### TranslateResult
 
-| 名称     | 类型 | 说明                               |
-| --------| ---- | -----------------------------------|
-| x       | number | x轴平移距离。                       |
-| y       | number | y轴平移距离。                       |
-| z       | number | z轴平移距离。                       |
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+| 名称     | 类型 | 必填 | 说明                               |
+| --------| ---- | -----------------------------------| -----------------------------------|
+| x       | number | 是 | x轴平移距离。                       |
+| y       | number | 是 | y轴平移距离。                       |
+| z       | number | 是 | z轴平移距离。                       |
 
 ### ScaleResult
 
-| 名称     | 类型 | 说明                               |
-| --------| ---- | -----------------------------------|
-| x       | number | x轴缩放倍数。                       |
-| y       | number | y轴缩放倍数。                       |
-| z       | number | z轴缩放倍数。                       |
-| centerX | number | 变换中心点x轴坐标。                  |
-| centerY | number | 变换中心点y轴坐标。。                |
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+| 名称     | 类型 | 必填 | 说明                               |
+| --------| ---- | -----------------------------------| -----------------------------------|
+| x       | number | 是 | x轴缩放倍数。                       |
+| y       | number | 是 | y轴缩放倍数。                       |
+| z       | number | 是 | z轴缩放倍数。                       |
+| centerX | number | 是 | 变换中心点x轴坐标。                  |
+| centerY | number | 是 | 变换中心点y轴坐标。。                |
 
 ### RotateResult
 
-| 名称     | 类型 | 说明                               |
-| --------| ---- | -----------------------------------|
-| x       | number | 旋转轴向量x坐标。                   |
-| y       | number | 旋转轴向量y坐标。                   |
-| z       | number | 旋转轴向量z坐标。                   |
-| angle   | number | 旋转角度。                          |
-| centerX | number | 变换中心点x轴坐标。                 |
-| centerY | number | 变换中心点y轴坐标。                 |
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+| 名称     | 类型 | 必填 | 说明                               |
+| --------| ---- | -----------------------------------| -----------------------------------|
+| x       | number | 是 | 旋转轴向量x坐标。                   |
+| y       | number | 是 | 旋转轴向量y坐标。                   |
+| z       | number | 是 | 旋转轴向量z坐标。                   |
+| angle   | number | 是 | 旋转角度。                          |
+| centerX | number | 是 | 变换中心点x轴坐标。                 |
+| centerY | number | 是 | 变换中心点y轴坐标。                 |
 
 ### Matrix4Result
 
-| 名称     | 类型 | 说明                               |
-| --------| ---- | -----------------------------------|
-| number  | number | x轴缩放值，单位矩阵默认为1。         |
-| number  | number | 第2个值，xyz轴旋转会影响这个值。 |
-| number  | number | 第3个值，xyz轴旋转会影响这个值。 |
-| number  | number | 无实际意义。                        |
-| number  | number | 第5个值，xyz轴旋转会影响这个值。 |
-| number  | number | y轴缩放值，单位矩阵默认为1。          |
-| number  | number | 第7个值，xyz轴旋转会影响这个值。 |
-| number  | number | 无实际意义。                        |
-| number  | number | 第9个值，xyz轴旋转会影响这个值。 |
-| number  | number | 第10个值，xyz轴旋转会影响这个值。 |
-| number  | number | z轴缩放值，单位矩阵默认为1。         |
-| number  | number | 无实际意义。                       |
-| number  | number | x轴平移值，单位矩阵默认为0。  |
-| number  | number | y轴平移值，单位矩阵默认为0。 |
-| number  | number | z轴平移值，单位矩阵默认为0。 |
-| number  | number | 齐次坐标下生效，产生透视投影效果。   |
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+| 取值范围   | 说明                               |
+| --------| -----------------------------------|
+| [number,number,number,number,<br/>number,number,number,number,<br/>number,number,number,number,<br/>number,number,number,number] | 取值范围为长度为16（4\*4）的number数组,&nbsp;详情见四阶矩阵说明。 |
+
+**四阶矩阵说明：**
+
+| 参数名 | 类型   | 必填 | 说明                                 |
+| ------ | ------ | ---- | ------------------------------------ |
+| m00    | number | 是   | x轴缩放值，单位矩阵默认为1。         |
+| m01    | number | 是   | 第2个值，xyz轴旋转会影响这个值。     |
+| m02    | number | 是   | 第3个值，xyz轴旋转会影响这个值。     |
+| m03    | number | 是   | 无实际意义。                         |
+| m10    | number | 是   | 第5个值，xyz轴旋转会影响这个值。     |
+| m11    | number | 是   | y轴缩放值，单位矩阵默认为1。         |
+| m12    | number | 是   | 第7个值，xyz轴旋转会影响这个值。     |
+| m13    | number | 是   | 无实际意义。                         |
+| m20    | number | 是   | 第9个值，xyz轴旋转会影响这个值。     |
+| m21    | number | 是   | 第10个值，xyz轴旋转会影响这个值。    |
+| m22    | number | 是   | z轴缩放值，单位矩阵默认为1。         |
+| m23    | number | 是   | 无实际意义。                         |
+| m30    | number | 是   | x轴平移值，单位px，单位矩阵默认为0。 |
+| m31    | number | 是   | y轴平移值，单位px，单位矩阵默认为0。 |
+| m32    | number | 是   | z轴平移值，单位px，单位矩阵默认为0。 |
+| m33    | number | 是   | 齐次坐标下生效，产生透视投影效果。   |
 
 **示例：**
 

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

@@ -41,7 +41,7 @@ initCurve(curve?: Curve): ICurve
 
 **系统能力：**  SystemCapability.ArkUI.ArkUI.Full
 
-| 名称                | 描述                                                         |
+| 名称                | 说明                                                         |
 | ------------------- | ------------------------------------------------------------ |
 | Linear              | 表示动画从头到尾的速度都是相同的。                           |
 | Ease                | 表示动画以低速开始，然后加快，在结束前变慢，CubicBezier(0.25, 0.1, 0.25, 1.0)。 |
@@ -282,7 +282,7 @@ import Curves from '@ohos.curves'
 interpolate(fraction) {
     return Math.sqrt(fraction);
   }
-private curve = Curves.customCurve(this.interpolate) // 创建一个用户自定义插值曲线
+let curve = Curves.customCurve(interpolate) // 创建一个用户自定义插值曲线
 ```
 
 

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

@@ -138,7 +138,7 @@ getFontByName(fontName: string): FontInfo;
 | ---------------- | ---------------------------- |
 | FontInfo         | 字体的详细信息                 |
 
-## FontInfo
+## FontInfo<sup>10+</sup>
 
 **系统能力：** SystemCapability.ArkUI.ArkUI.Full
 
@@ -170,7 +170,7 @@ struct FontExample {
     Column() {
       Button("getFontByName")
         .onClick(() => {
-          this.fontInfo = font.getFontByName('HarmonyOS Sans Italic')
+          this.fontInfo = font.getFontByName('Sans Italic')
           console.log("getFontByName(): path = " + this.fontInfo.path)
           console.log("getFontByName(): postScriptName = " + this.fontInfo.postScriptName)
           console.log("getFontByName(): fullName = " + this.fontInfo.fullName)

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

@@ -27,7 +27,7 @@ Matrix的构造函数，可以通过传入的参数创建一个四阶矩阵，
 
 | 参数名 | 类型                                                         | 必填 | 说明                                                         |
 | ------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| option | [number,number,number,number,number,number,number,number,number,number,number,number,number,number,number,number] | 是   | 参数为长度为16（4\*4）的number数组,&nbsp;详情见四阶矩阵说明。<br/>默认值：<br/>[1,&nbsp;0,&nbsp;0,&nbsp;0,<br/>0,&nbsp;1,&nbsp;0,&nbsp;0,<br/>0,&nbsp;0,&nbsp;1,&nbsp;0,<br/>0,&nbsp;0,&nbsp;0,&nbsp;1] |
+| option | [number,number,number,number,<br/>number,number,number,number,<br/>number,number,number,number,<br/>number,number,number,number] | 是   | 参数为长度为16（4\*4）的number数组,&nbsp;详情见四阶矩阵说明。<br/>默认值：<br/>[1,&nbsp;0,&nbsp;0,&nbsp;0,<br/>0,&nbsp;1,&nbsp;0,&nbsp;0,<br/>0,&nbsp;0,&nbsp;1,&nbsp;0,<br/>0,&nbsp;0,&nbsp;0,&nbsp;1] |
 
 **返回值：**
 
@@ -170,6 +170,132 @@ struct Test {
 
 ![zh-cn_image_0000001219744181](figures/zh-cn_image_0000001219744181.png)
 
+## matrix4.invert<sup>(deprecated)</sup>
+
+invert(): Matrix4Transit
+
+Matrix的逆函数，可以返回一个当前矩阵对象的逆矩阵，即效果正好相反。
+
+该接口从Api 10开始废弃。
+
+**系统能力：**  SystemCapability.ArkUI.ArkUI.Full
+
+**返回值：**
+
+| 类型                              | 说明                   |
+| --------------------------------- | ---------------------- |
+| [Matrix4Transit](#matrix4transit) | 当前矩阵的逆矩阵对象。 |
+
+## matrix4.combine<sup>(deprecated)</sup>
+
+combine(options: Matrix4Transit): Matrix4Transit
+
+Matrix的叠加函数，可以将两个矩阵的效果叠加起来生成一个新的矩阵对象。
+
+该接口从Api 10开始废弃。
+
+**系统能力：**  SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+
+| 参数名 | 类型                              | 必填 | 说明               |
+| ------ | --------------------------------- | ---- | ------------------ |
+| option | [Matrix4Transit](#matrix4transit) | 是   | 待叠加的矩阵对象。 |
+
+**返回值：**
+
+| 类型                              | 说明                   |
+| --------------------------------- | ---------------------- |
+| [Matrix4Transit](#matrix4transit) | 当前矩阵的逆矩阵对象。 |
+
+## matrix4.translate<sup>(deprecated)</sup>
+
+translate(options: TranslateOption): Matrix4Transit
+
+Matrix的平移函数，可以为当前矩阵增加x轴/y轴/z轴平移效果。
+
+该接口从Api 10开始废弃。
+
+**系统能力：**  SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+
+| 参数名 | 类型                                | 必填 | 说明           |
+| ------ | ----------------------------------- | ---- | -------------- |
+| option | [TranslateOption](#translateoption) | 是   | 设置平移参数。 |
+
+**返回值：**
+
+| 类型                              | 说明                   |
+| --------------------------------- | ---------------------- |
+| [Matrix4Transit](#matrix4transit) | 当前矩阵的逆矩阵对象。 |
+
+## matrix4.scale<sup>(deprecated)</sup>
+
+scale(options: ScaleOption): Matrix4Transit
+
+Matrix的缩放函数，可以为当前矩阵增加x轴/y轴/z轴缩放效果。
+
+该接口从Api 10开始废弃。
+
+**系统能力：**  SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+
+| 参数名 | 类型                        | 必填 | 说明           |
+| ------ | --------------------------- | ---- | -------------- |
+| option | [ScaleOption](#scaleoption) | 是   | 设置缩放参数。 |
+
+**返回值：**
+
+| 类型                              | 说明                   |
+| --------------------------------- | ---------------------- |
+| [Matrix4Transit](#matrix4transit) | 当前矩阵的逆矩阵对象。 |
+
+## matrix4.rotate<sup>(deprecated)</sup>
+
+rotate(options: RotateOption): Matrix4Transit
+
+Matrix的旋转函数，可以为当前矩阵增加x轴/y轴/z轴旋转效果。
+
+该接口从Api 10开始废弃。
+
+**系统能力：**  SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+
+| 参数名 | 类型                          | 必填 | 说明           |
+| ------ | ----------------------------- | ---- | -------------- |
+| option | [RotateOption](#rotateoption) | 是   | 设置旋转参数。 |
+
+**返回值：**
+
+| 类型                              | 说明                   |
+| --------------------------------- | ---------------------- |
+| [Matrix4Transit](#matrix4transit) | 当前矩阵的逆矩阵对象。 |
+
+## matrix4.transformPoint<sup>(deprecated)</sup>
+
+transformPoint(options: [number, number]): [number, number]
+
+Matrix的坐标点转换函数，可以将当前的变换效果作用到一个坐标点上。
+
+该接口从Api 10开始废弃。
+
+**系统能力：**  SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+
+| 参数名 | 类型             | 必填 | 说明               |
+| ------ | ---------------- | ---- | ------------------ |
+| option | [number, number] | 是   | 需要转换的坐标点。 |
+
+**返回值：**
+
+| 类型             | 说明                        |
+| ---------------- | --------------------------- |
+| [number, number] | 返回矩阵变换后的Point对象。 |
+
 
 ## Matrix4Transit
 
@@ -330,7 +456,6 @@ Matrix的缩放函数，可以为当前矩阵增加x轴/y轴/z轴缩放效果。
 | ------ | --------------------------- | ---- | -------------- |
 | option | [ScaleOption](#scaleoption) | 是   | 设置缩放参数。 |
 
-
 **返回值：**
 
 | 类型                              | 说明                         |
@@ -375,7 +500,6 @@ Matrix的旋转函数，可以为当前矩阵增加x轴/y轴/z轴旋转效果。
 | ------ | ----------------------------- | ---- | -------------- |
 | option | [RotateOption](#rotateoption) | 是   | 设置旋转参数。 |
 
-
 **返回值：**
 
 | 类型                              | 说明                         |

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

@@ -693,7 +693,7 @@ replaceNamedRoute(options: NamedRouterOptions, mode: RouterMode): Promise<voi
 
 | 错误码ID   | 错误信息 |
 | --------- | ------- |
-| 100001    | if UI execution context not found, only throw in standard system. |
+| 100001    | if can not get the delegate, only throw in standard system. |
 | 100004    | if the named route is not exist. |
 
 **示例：**