update apis

Signed-off-by: N yamila <tianyu55@huawei.com>

update apis
Signed-off-by: N yamila <tianyu55@huawei.com>
a2cf8882 · yamila · 654c9ee7 · a2cf8882 · a2cf8882 · a2cf8882
8 changed file
--- a/zh-cn/application-dev/reference/apis/js-apis-arkui-UIContext.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-arkui-UIContext.md
--- a/zh-cn/application-dev/reference/apis/js-apis-arkui-drawableDescriptor.md
+++ b/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

--- a/zh-cn/application-dev/reference/apis/js-apis-arkui-inspector.md
+++ b/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

--- a/zh-cn/application-dev/reference/apis/js-apis-componentUtils.md
+++ b/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 | 是   | 齐次坐标下生效，产生透视投影效果。   |

 **示例：**


--- a/zh-cn/application-dev/reference/apis/js-apis-curve.md
+++ b/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) // 创建一个用户自定义插值曲线
 ```



--- a/zh-cn/application-dev/reference/apis/js-apis-font.md
+++ b/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)

--- a/zh-cn/application-dev/reference/apis/js-apis-matrix4.md
+++ b/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) | 是   | 设置旋转参数。 |

-
 **返回值：**

 | 类型                              | 说明                         |

--- a/zh-cn/application-dev/reference/apis/js-apis-router.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-router.md
@@ -693,7 +693,7 @@ replaceNamedRoute(options: NamedRouterOptions, mode: RouterMode): Promise&lt;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. |

 **示例：**