Update docs (19087)

Signed-off-by: Nester.zhou <ester.zhou@huawei.com>

en/application-dev/application-models/accessibilityextensionability.md

-# AccessibilityExtensionAbility Development
+# AccessibilityExtensionAbility
 
 The **AccessibilityExtensionAbility** module provides accessibility extension capabilities based on the **ExtensionAbility** framework. You can develop your accessibility applications by applying the **AccessibilityExtensionAbility** template to enhance usability.
 
@@ -10,14 +10,6 @@ The **AccessibilityExtensionAbility** module provides accessibility extension ca
 >
 > Model: stage
 
-This document is organized as follows:
-
-- [AccessibilityExtensionAbility Overview](#accessibilityextensionability-overview)
-- [Creating an Accessibility Extension Service](#creating-an-accessibility-extension-service)
-- [Processing an Accessibility Event](#processing-an-accessibility-event)
-- [Declaring Capabilities of Accessibility Extension Services](#declaring-capabilities-of-accessibility-extension-services)
-- [Enabling a Custom Accessibility Extension Service](#enabling-a-custom-accessibility-extension-service)
-
 ## AccessibilityExtensionAbility Overview
 
 Accessibility is about giving equal access to everyone so that they can access and use information equally and conveniently under any circumstances. It helps narrow the digital divide between people of different classes, regions, ages, and health status in terms of information understanding, information exchange, and information utilization, so that they can participate in social life more conveniently and enjoy the benefits of technological advances.

en/application-dev/reference/arkui-ts/ts-basic-components-datapanel.md

@@ -48,7 +48,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 | ------------- | ------- | ---- | -------- |
 | closeEffect | boolean | Yes| Whether to disable the rotation and shadow effects for the component.<br>Default value: **false**<br>**NOTE**<br> This attribute enables or disables the shadow effect only when **trackShadow** is not set.<br> The shadow effect enabled through this attribute is in the default style.|
 | valueColors<sup>10+</sup>   | Array<[ResourceColor](ts-types.md#resourcecolor) \| [LinearGradient](#lineargradient10)> | Yes| Array of data segment colors. A value of the **ResourceColor** type indicates a solid color, and A value of the **LinearGradient** type indicates a color gradient.|
-| trackBackgroundColor<sup>10+</sup> | [ResourceColor](ts-types.md#resourcecolor) | Yes| Background color.<br>Default value: **'#081824'**|
+| trackBackgroundColor<sup>10+</sup> | [ResourceColor](ts-types.md#resourcecolor) | Yes| Background color.<br>The value is in hexadecimal ARGB notation. The first two digits indicate opacity.<br>Default value: **'#08182431'**|
 | strokeWidth<sup>10+</sup> | [Length](ts-types.md#Length) | Yes| Stroke width of the border.<br>Default value: **24**<br>Unit: vp<br>**NOTE**<br>A value less than 0 evaluates to the default value.<br>This attribute does not take effect when the data panel type is **DataPanelType.Line**.|
 | trackShadow<sup>10+</sup> | [DataPanelShadowOption](#datapanelshadowoption10) | Yes| Shadow style.<br>**NOTE**<br>If this attribute is set to **null**, the shadow effect is disabled.|
 

en/application-dev/reference/arkui-ts/ts-components-canvas-canvaspattern.md

+# CanvasPattern
+
+**CanvasPattern** represents an object, created by the [createPattern](ts-canvasrenderingcontext2d.md#createpattern) API, describing an image filling pattern based on the image and repetition mode.
+
+>  **NOTE**
+>
+>  The APIs of this module are supported since API version 8. Updates will be marked with a superscript to indicate their earliest API version.
+
+## Methods
+
+### setTransform
+
+setTransform(transform?: Matrix2D): void
+
+Uses a **Matrix2D** object as a parameter to perform matrix transformation on the current **CanvasPattern** object.
+
+Since API version 9, this API is supported in ArkTS widgets.
+
+**Parameters**
+
+| Name     | Type                                                 | Mandatory| Default Value| Description      |
+| --------- | ----------------------------------------------------- | ---- | ------ | ---------- |
+| transform | [Matrix2D](ts-components-canvas-matrix2d.md#Matrix2D) | No  | null   | Transformation matrix.|
+
+**Example**
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct CanvasPatternPage {
+  private settings: RenderingContextSettings = new RenderingContextSettings(true)
+  private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings)
+  private matrix: Matrix2D = new Matrix2D()
+  private img: ImageBitmap = new ImageBitmap("common/pattern.jpg")
+  private pattern : CanvasPattern
+
+  build() {
+      Column() {
+        Button("Click to set transform")
+          .onClick(() => {
+            this.matrix.scaleY = 1
+            this.matrix.scaleX = 1
+            this.matrix.translateX = 50
+            this.matrix.translateY = 200
+            this.pattern.setTransform(this.matrix)
+            this.context.fillRect(0, 0, 480, 720)
+          })
+          .width("45%")
+          .margin("5px")
+        Canvas(this.context)
+          .width('100%')
+          .height('80%')
+          .backgroundColor('#FFFFFF')
+          .onReady(() => {
+            this.pattern = this.context.createPattern(this.img, 'no-repeat')
+            this.context.fillStyle = this.pattern
+            this.matrix.scaleY = 0.5
+            this.matrix.scaleX = 0.5
+            this.matrix.translateX = 50
+            this.matrix.translateY = 50
+            this.pattern.setTransform(this.matrix)
+            this.context.fillRect(0, 0, 480, 720)
+          })
+      }
+      .width('100%')
+      .height('100%')
+  }
+}
+```
+
+![CanvasPattern](./figures/canvas_pattern.gif)

en/application-dev/reference/arkui-ts/ts-components-canvas-imagebitmap.md

@@ -65,6 +65,6 @@ Since API version 9, this API is supported in ArkTS widgets.
 
 close()
 
-Releases all graphics resources associated with this **ImageBitmap** object. This API is a void API.
+Releases all graphics resources associated with this **ImageBitmap** object and sets its width and height to **0**.
 
 Since API version 9, this API is supported in ArkTS widgets.

en/application-dev/reference/arkui-ts/ts-components-canvas-matrix2d.md

+# Matrix2D
+
+**Matrix2D** allows you to perform matrix transformation, such as scaling, rotating, and translating.
+
+>  **NOTE**
+> 
+> The APIs of this module are supported since API version 8. Updates will be marked with a superscript to indicate their earliest API version.
+
+## APIs
+
+Matrix2D()
+
+Since API version 9, this API is supported in ArkTS widgets.
+
+## Attributes
+
+| Name                     | Type  | Description                                                        |
+| ------------------------- | ------ | ------------------------------------------------------------ |
+| [scaleX](#scalex)         | number | Horizontal scale factor. Since API version 9, this API is supported in ArkTS widgets.|
+| [scaleY](#scaley)         | number | Vertical scale factor. Since API version 9, this API is supported in ArkTS widgets.|
+| [rotateX](#rotatex)       | number | Horizontal tilt coefficient. Since API version 9, this API is supported in ArkTS widgets.|
+| [rotateY](#rotatey)       | number | Vertical tilt coefficient. Since API version 9, this API is supported in ArkTS widgets.|
+| [translateX](#translatex) | number | Horizontal translation distance, in vp. Since API version 9, this API is supported in ArkTS widgets.|
+| [translateY](#translatey) | number | Vertical translation distance, in vp. Since API version 9, this API is supported in ArkTS widgets.|
+
+>  **NOTE**
+>  
+>  You can use the [px2vp](ts-pixel-units.md) API to convert the unit.
+
+### scaleX
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct Matrix2DScaleX {
+  @State message: string = 'Matrix2D ScaleX'
+
+  printMatrix(title, matrix) {
+    console.log(title)
+    console.log("Matrix [scaleX = " + matrix.scaleX + ", scaleY = " + matrix.scaleY +
+                ", rotateX = " + matrix.rotateX + ", rotateY = " + matrix.rotateY +
+                ", translateX = " + matrix.translateX + ", translateY = " + matrix.translateY + "]")
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(20)
+          .fontWeight(FontWeight.Bold)
+        Button("Set scaleX")
+          .onClick(() => {
+            var matrix : Matrix2D = new Matrix2D()
+            matrix.scaleX = 1
+            this.printMatrix(this.message, matrix)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+### scaleY
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct Matrix2DScaleY {
+  @State message: string = 'Matrix2D ScaleY'
+
+  printMatrix(title, matrix) {
+    console.log(title)
+    console.log("Matrix [scaleX = " + matrix.scaleX + ", scaleY = " + matrix.scaleY +
+                ", rotateX = " + matrix.rotateX + ", rotateY = " + matrix.rotateY +
+                ", translateX = " + matrix.translateX + ", translateY = " + matrix.translateY + "]")
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(20)
+          .fontWeight(FontWeight.Bold)
+        Button("Set scaleY")
+          .onClick(() => {
+            var matrix : Matrix2D = new Matrix2D()
+            matrix.scaleY = 1
+            this.printMatrix(this.message, matrix)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+### rotateX
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct Matrix2DRotateX {
+  @State message: string = 'Matrix2D RotateX'
+
+  printMatrix(title, matrix) {
+    console.log(title)
+    console.log("Matrix [scaleX = " + matrix.scaleX + ", scaleY = " + matrix.scaleY +
+                ", rotateX = " + matrix.rotateX + ", rotateY = " + matrix.rotateY +
+                ", translateX = " + matrix.translateX + ", translateY = " + matrix.translateY + "]")
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(20)
+          .fontWeight(FontWeight.Bold)
+        Button("Set rotateX")
+          .onClick(() => {
+            var matrix : Matrix2D = new Matrix2D()
+            matrix.rotateX = Math.sin(45 / Math.PI)
+            this.printMatrix(this.message, matrix)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+### rotateY
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct Matrix2DRotateY {
+  @State message: string = 'Matrix2D RotateY'
+
+  printMatrix(title, matrix) {
+    console.log(title)
+    console.log("Matrix [scaleX = " + matrix.scaleX + ", scaleY = " + matrix.scaleY +
+                ", rotateX = " + matrix.rotateX + ", rotateY = " + matrix.rotateY +
+                ", translateX = " + matrix.translateX + ", translateY = " + matrix.translateY + "]")
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(20)
+          .fontWeight(FontWeight.Bold)
+        Button("Set rotateY")
+          .onClick(() => {
+            var matrix : Matrix2D = new Matrix2D()
+            matrix.rotateY = Math.cos(45 / Math.PI)
+            this.printMatrix(this.message, matrix)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+### translateX
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct Matrix2DTranslateX {
+  @State message: string = 'Matrix2D TranslateX'
+
+  printMatrix(title, matrix) {
+    console.log(title)
+    console.log("Matrix [scaleX = " + matrix.scaleX + ", scaleY = " + matrix.scaleY +
+                ", rotateX = " + matrix.rotateX + ", rotateY = " + matrix.rotateY +
+                ", translateX = " + matrix.translateX + ", translateY = " + matrix.translateY + "]")
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(20)
+          .fontWeight(FontWeight.Bold)
+        Button("Set translateX")
+          .onClick(() => {
+            var matrix : Matrix2D = new Matrix2D()
+            matrix.translateX = 10
+            this.printMatrix(this.message, matrix)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+### translateY
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct Matrix2DTranslateY {
+  @State message: string = 'Matrix2D TranslateY'
+
+  printMatrix(title, matrix) {
+    console.log(title)
+    console.log("Matrix [scaleX = " + matrix.scaleX + ", scaleY = " + matrix.scaleY +
+                ", rotateX = " + matrix.rotateX + ", rotateY = " + matrix.rotateY +
+                ", translateX = " + matrix.translateX + ", translateY = " + matrix.translateY + "]")
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(20)
+          .fontWeight(FontWeight.Bold)
+        Button("Set translateY")
+          .onClick(() => {
+            var matrix : Matrix2D = new Matrix2D()
+            matrix.translateY = 10
+            this.printMatrix(this.message, matrix)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+## Methods
+
+### identity
+
+identity(): Matrix2D
+
+Creates an identity matrix.
+
+Since API version 9, this API is supported in ArkTS widgets.
+
+**Return value**
+
+| Type                 | Description      |
+| --------------------- | ---------- |
+| [Matrix2D](#matrix2d) | Identity matrix.|
+
+**Example**
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct Matrix2DIdentity {
+  @State message: string = 'Matrix2D Identity'
+
+  printMatrix(title, matrix) {
+    console.log(title)
+    console.log("Matrix [scaleX = " + matrix.scaleX + ", scaleY = " + matrix.scaleY +
+                ", rotateX = " + matrix.rotateX + ", rotateY = " + matrix.rotateY +
+                ", translateX = " + matrix.translateX + ", translateY = " + matrix.translateY + "]")
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(20)
+          .fontWeight(FontWeight.Bold)
+        Button("matrix identity")
+          .onClick(() => {
+            var matrix : Matrix2D = new Matrix2D()
+            matrix = matrix.identity()
+            this.printMatrix(this.message, matrix)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+### invert
+
+invert(): Matrix2D
+
+Obtains an inverse of this matrix.
+
+Since API version 9, this API is supported in ArkTS widgets.
+
+**Return value**
+
+| Type                 | Description        |
+| --------------------- | ------------ |
+| [Matrix2D](#matrix2d) | Inverse of the current matrix.|
+
+**Example**
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct Matrix2DInvert {
+  @State message: string = 'Matrix2D Invert'
+
+  printMatrix(title, matrix) {
+    console.log(title)
+    console.log("Matrix [scaleX = " + matrix.scaleX + ", scaleY = " + matrix.scaleY +
+                ", rotateX = " + matrix.rotateX + ", rotateY = " + matrix.rotateY +
+                ", translateX = " + matrix.translateX + ", translateY = " + matrix.translateY + "]")
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(20)
+          .fontWeight(FontWeight.Bold)
+        Button("matrix invert")
+          .onClick(() => {
+            var matrix : Matrix2D = new Matrix2D()
+            matrix.scaleX = 2
+            matrix.scaleY = 1
+            matrix.rotateX = 0
+            matrix.rotateY = 0
+            matrix.translateX = 10
+            matrix.translateY = 20
+            matrix.invert()
+            this.printMatrix(this.message, matrix)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+### multiply<sup>(deprecated) </sup>
+
+multiply(other?: Matrix2D): Matrix2D
+
+Multiplies this matrix by the target matrix.
+
+Since API version 9, this API is supported in ArkTS widgets. This API is a null API.
+
+This API is deprecated since API version 10.
+
+**Parameters**
+
+| Parameter | Type    | Mandatory| Default Value| Description      |
+| ----- | -------- | ---- | ------ | ---------- |
+| other | Matrix2D | No  | null   | Target matrix.|
+
+**Return value**
+
+| Type                 | Description          |
+| --------------------- | -------------- |
+| [Matrix2D](#matrix2d) | Matrix of the multiplication result.|
+
+**Example**
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct Matrix2DMultiply {
+  @State message: string = 'Matrix2D Multiply'
+
+  printMatrix(title, matrix) {
+    console.log(title)
+    console.log("Matrix [scaleX = " + matrix.scaleX + ", scaleY = " + matrix.scaleY +
+                ", rotateX = " + matrix.rotateX + ", rotateY = " + matrix.rotateY +
+                ", translateX = " + matrix.translateX + ", translateY = " + matrix.translateY + "]")
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(20)
+          .fontWeight(FontWeight.Bold)
+        Button("matrix multiply")
+          .onClick(() => {
+            var matrix : Matrix2D = new Matrix2D()
+            matrix.scaleX = 1
+            matrix.scaleY = 1
+            matrix.rotateX = 0
+            matrix.rotateY = 0
+            matrix.translateX = 0
+            matrix.translateY = 0
+            var other: Matrix2D = new Matrix2D()
+            other.scaleX = 2
+            other.scaleY = 2
+            other.rotateX = 0
+            other.rotateY = 0
+            other.translateX = 10
+            other.translateY = 10
+            other.multiply(other)
+            this.printMatrix(this.message, matrix)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+### rotate<sup>10+</sup>
+
+rotate(degree: number, rx?: number, ry?: number): Matrix2D
+
+Performs a right multiplication rotation operation on this matrix, with the specified rotation point as the transform origin.
+
+Since API version 10, this API is supported in ArkTS widgets.
+
+**Parameters**
+
+| Parameter  | Type  | Mandatory| Default Value| Description                                                        |
+| ------ | ------ | ---- | ------ | ------------------------------------------------------------ |
+| degree | number | Yes  | 0      | Rotation angle, in radians. A positive angle denotes a clockwise rotation. You can use **Math.PI& / 180** to convert the angle to a radian value.|
+| rx     | number | No  | 0      | Horizontal coordinate (in vp) of the rotation point.                            |
+| ry     | number | No  | 0      | Vertical coordinate (in vp) of the rotation point.                            |
+
+**Return value**
+
+| Type                 | Description                |
+| --------------------- | -------------------- |
+| [Matrix2D](#matrix2d) | Matrix of the rotation result.|
+
+**Example**
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct Matrix2DRotate {
+  @State message: string = 'Matrix2D Rotate'
+
+  printMatrix(title, matrix) {
+    console.log(title)
+    console.log("Matrix [scaleX = " + matrix.scaleX + ", scaleY = " + matrix.scaleY +
+                ", rotateX = " + matrix.rotateX + ", rotateY = " + matrix.rotateY +
+                ", translateX = " + matrix.translateX + ", translateY = " + matrix.translateY + "]")
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(20)
+          .fontWeight(FontWeight.Bold)
+        Button("matrix rotate")
+          .onClick(() => {
+            var matrix : Matrix2D = new Matrix2D()
+            matrix.scaleX = 1
+            matrix.scaleY = 1
+            matrix.rotateX = 0
+            matrix.rotateY = 0
+            matrix.translateX = 0
+            matrix.translateY = 0
+            matrix.rotate(90 / Math.PI, 10, 10)
+            this.printMatrix(this.message, matrix)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+### translate
+
+translate(tx?: number, ty?: number): Matrix2D
+
+Performs a left multiplication translation operation on this matrix.
+
+Since API version 9, this API is supported in ArkTS widgets.
+
+**Parameters**
+
+| Parameter| Type  | Mandatory| Default Value| Description                        |
+| ---- | ------ | ---- | ------ | ---------------------------- |
+| tx   | number | No  | 0      | Horizontal translation distance, in vp.|
+| ty   | number | No  | 0      | Vertical translation distance, in vp.|
+
+**Return value**
+
+| Type                 | Description                |
+| --------------------- | -------------------- |
+| [Matrix2D](#matrix2d) | Matrix of the translation result.|
+
+**Example**
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct Matrix2DTranslate {
+  @State message: string = 'Matrix2D Translate'
+
+  printMatrix(title, matrix) {
+    console.log(title)
+    console.log("Matrix [scaleX = " + matrix.scaleX + ", scaleY = " + matrix.scaleY +
+                ", rotateX = " + matrix.rotateX + ", rotateY = " + matrix.rotateY +
+                ", translateX = " + matrix.translateX + ", translateY = " + matrix.translateY + "]")
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(20)
+          .fontWeight(FontWeight.Bold)
+        Button("matrix translate")
+          .onClick(() => {
+            var matrix : Matrix2D = new Matrix2D()
+            matrix.scaleX = 1
+            matrix.scaleY = 1
+            matrix.rotateX = 0
+            matrix.rotateY = 0
+            matrix.translateX = 0
+            matrix.translateY = 0
+            matrix.translate(100, 100)
+            this.printMatrix(this.message, matrix)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+### scale
+
+scale(sx?: number, sy?: number): Matrix2D
+
+Performs a right multiplication scaling operation on this matrix.
+
+Since API version 9, this API is supported in ArkTS widgets.
+
+**Parameters**
+
+| Parameter| Type  | Mandatory| Default Value| Description              |
+| ---- | ------ | ---- | ------ | ------------------ |
+| sx   | number | No  | 1      | Horizontal scale factor.|
+| sy   | number | No  | 1      | Vertical scale factor.|
+
+**Return value**
+
+| Type                 | Description              |
+| --------------------- | ------------------ |
+| [Matrix2D](#matrix2d) | Matrix of the scale result.|
+
+**Example**
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct Matrix2DScale {
+  @State message: string = 'Matrix2D Scale'
+
+  printMatrix(title, matrix) {
+    console.log(title)
+    console.log("Matrix [scaleX = " + matrix.scaleX + ", scaleY = " + matrix.scaleY +
+                ", rotateX = " + matrix.rotateX + ", rotateY = " + matrix.rotateY +
+                ", translateX = " + matrix.translateX + ", translateY = " + matrix.translateY + "]")
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(20)
+          .fontWeight(FontWeight.Bold)
+        Button("matrix scale")
+          .onClick(() => {
+            var matrix : Matrix2D = new Matrix2D()
+            matrix.scaleX = 1
+            matrix.scaleY = 1
+            matrix.rotateX = 0
+            matrix.rotateY = 0
+            matrix.translateX = 0
+            matrix.translateY = 0
+            matrix.scale(0.5, 0.5)
+            this.printMatrix(this.message, matrix)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```

en/application-dev/reference/arkui-ts/ts-container-gridrow.md

@@ -130,7 +130,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 
 | Name                      | Type                           | Description                                              |
 | ----------------------- | ----------------------------------- | ------------------------------------------- |
-| alignItems<sup>10+</sup>             | [ItemAlign](ts-appendix-enums.md#itemalign) | Alignment mode of the **\<GridCol>** cross axis.<br>Default value: **ItemAlign.Start**<br>**NOTE**<br>In **ItemAlign**, only the enumerated values **Start**, **Center**, **End**, and **Stretch** are supported.<br>The alignment mode of the **\<GridCol>** component can also be set using **alignSelf([ItemAlign](ts-appendix-enums.md#itemalign))**. If both of the preceding methods are used, the setting of **alignSelf(ItemAlign)** prevails.<br>Since API version 10, this API is supported in ArkTS widgets.|
+| alignItems<sup>10+</sup>             | ItemAlign | Alignment mode of the **\<GridCol>** cross axis.<br>Default value: **ItemAlign.Start**<br>**NOTE**<br>**ItemAlign** supports the following enums: **ItemAlign.Start**, **ItemAlign.Center**, **ItemAlign.End**, and **ItemAlign.Stretch**.<br>The alignment mode of the **\<GridCol>** component can also be set using **alignSelf([ItemAlign](ts-appendix-enums.md#itemalign))**. If both of the preceding methods are used, the setting of **alignSelf(ItemAlign)** prevails.<br>Since API version 10, this API is supported in ArkTS widgets.|
 
 
 ## Events

en/application-dev/reference/arkui-ts/ts-container-sidebarcontainer.md

@@ -44,7 +44,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 | showSideBar | boolean | Whether to display the sidebar.<br>Default value: **true**<br>Since API version 10, this attribute supports [$$](../../quick-start/arkts-two-way-sync.md) for two-way binding of variables.|
 | controlButton | [ButtonStyle](#buttonstyle)                            | Attributes of the sidebar control button.|
 | showControlButton | boolean | Whether to display the sidebar control button.<br>Default value: **true**|
-| sideBarWidth | number \| [Length](ts-types.md#length)<sup>9+</sup> | Width of the sidebar.<br>Default value: **200**<br>Unit: vp<br>**NOTE**<br>A value less than 0 evaluates to the default value.<br>The value must comply with the width constraints. If it is not within the valid range, the value closest to the set one is used.<br>When set, the width of the sidebar takes precedence over that of the sidebar child components. If it is not set, however, the width of the sidebar child component takes precedence.|
+| sideBarWidth | number \| [Length](ts-types.md#length)<sup>9+</sup> | Width of the sidebar.<br>Default value: **200**<br>Unit: vp<br>**NOTE**<br>A value less than 0 evaluates to the default value.<br>The value must comply with the width constraints. If it is not within the valid range, the value closest to the set one is used.<br>The width of the sidebar, whether it is specified or kept at the default, takes precedence over that of the sidebar child components.|
 | minSideBarWidth | number \| [Length](ts-types.md#length)<sup>9+</sup> | Minimum width of the sidebar.<br>Default value: **200**, in vp<br>**NOTE**<br>A value less than 0 evaluates to the default value.<br>The value cannot exceed the width of the sidebar container itself. Otherwise, the width of the sidebar container itself is used.<br>When set, the minimum width of the sidebar takes precedence over that of the sidebar child components. If it is not set, however, the minimum width of the sidebar child component takes precedence.|
 | maxSideBarWidth | number \| [Length](ts-types.md#length)<sup>9+</sup> | Maximum width of the sidebar.<br>Default value: **280**, in vp<br>**NOTE**<br>A value less than 0 evaluates to the default value.<br>The value cannot exceed the width of the sidebar container itself. Otherwise, the width of the sidebar container itself is used.<br>When set, the maximum width of the sidebar takes precedence over that of the sidebar child components. If it is not set, however, the maximum width of the sidebar child component takes precedence.|
 | autoHide<sup>9+</sup> | boolean | Whether to automatically hide the sidebar when it is dragged to be smaller than the minimum width.<br>Default value: **true**<br>**NOTE**<br>The value is subject to the **minSideBarWidth** attribute method. If it is not set in **minSideBarWidth**, the default value is used.<br>Whether the sidebar should be hidden is determined when it is being dragged. When its width is less than the minimum width, the damping effect is required to trigger hiding (a distance out of range).|

en/application-dev/reference/arkui-ts/ts-container-swiper.md

@@ -45,18 +45,16 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 | cachedCount<sup>8+</sup>    | number                                   | Number of child components to be cached.<br>Default value: **1**<br>**NOTE**<br>**cachedCount** has caching optimized. You are advised not to use it together with [LazyForEach](../../quick-start/arkts-rendering-control-lazyforeach.md).|
 | disableSwipe<sup>8+</sup>   | boolean                                  | Whether to disable the swipe feature.<br>Default value: **false**                             |
 | curve<sup>8+</sup>          | [Curve](ts-appendix-enums.md#curve)  \| string | Animation curve. The ease-in/ease-out curve is used by default. For details about common curves, see [Curve](ts-appendix-enums.md#curve). You can also create custom curves (interpolation curve objects) by using the API provided by the [interpolation calculation](../apis/js-apis-curve.md) module.<br>Default value: **Curve.Linear**|
-| indicatorStyle<sup>8+</sup> | {<br>left?: [Length](ts-types.md#length),<br>top?: [Length](ts-types.md#length),<br>right?: [Length](ts-types.md#length),<br>bottom?: [Length](ts-types.md#length),<br>size?: [Length](ts-types.md#length),<br>mask?: boolean,<br>color?: [ResourceColor](ts-types.md),<br>selectedColor?: [ResourceColor](ts-types.md)<br>} | Style of the navigation point indicator.<br>\- **left**: distance between the navigation point indicator and the left edge of the **\<Swiper>** component.<br>\- **top**: distance between the navigation point indicator and the top edge of the **\<Swiper>** component.<br>\- **right**: distance between the navigation point indicator and the right edge of the **\<Swiper>** component.<br>\- **bottom**: distance between the navigation point indicator and the bottom edge of the **\<Swiper>** component.<br>\- **size**: diameter of the navigation point indicator.<br>\- **mask**: whether to enable the mask for the navigation point indicator.<br>\- **color**: color of the navigation point indicator.<br>\- **selectedColor**: color of the selected navigation dot.|
-| displayCount<sup>8+</sup>   | number \| string                                             | Number of elements to display per page.<br>Default value: **1**<br>**NOTE**<br>If the value is of the string type, it can only be **'auto'**, whose display effect is the same as that of **SwiperDisplayMode.AutoLinear**.<br>If the value is of the number type, child components stretch (shrink) on the main axis after the swiper width [deducting the result of itemSpace x (displayCount – 1)] is evenly distributed among them on the main axis.|
+| indicatorStyle<sup>(deprecated)</sup> | {<br>left?: [Length](ts-types.md#length),<br>top?: [Length](ts-types.md#length),<br>right?: [Length](ts-types.md#length),<br>bottom?: [Length](ts-types.md#length),<br>size?: [Length](ts-types.md#length),<br>mask?: boolean,<br>color?: [ResourceColor](ts-types.md),<br>selectedColor?: [ResourceColor](ts-types.md)<br>} | Style of the navigation point indicator.<br>\- **left**: distance between the navigation point indicator and the left edge of the **\<Swiper>** component.<br>\- **top**: distance between the navigation point indicator and the top edge of the **\<Swiper>** component.<br>\- **right**: distance between the navigation point indicator and the right edge of the **\<Swiper>** component.<br>\- **bottom**: distance between the navigation point indicator and the bottom edge of the **\<Swiper>** component.<br>\- **size**: diameter of the navigation point indicator. The value cannot be in percentage. Default value: **6vp**<br>\- **mask**: whether to enable the mask for the navigation point indicator.<br>\- **color**: color of the navigation point indicator.<br>\- **selectedColor**: color of the selected navigation dot.<br>This API is supported since API version 8 and is deprecated since API version 9. You are advised to use [indicator](#indicator10) instead.|
+| displayCount<sup>8+</sup>   | number \| string                                               | Number of elements to display per page.<br>Default value: **1**<br>**NOTE**<br>If the value is of the string type, it can only be **'auto'**, whose display effect is the same as that of **SwiperDisplayMode.AutoLinear**.<br>If the value is of the number type, child components stretch (shrink) on the main axis after the swiper width [deducting the result of itemSpace x (displayCount – 1)] is evenly distributed among them on the main axis.|
 | effectMode<sup>8+</sup>     | [EdgeEffect](ts-appendix-enums.md#edgeeffect)  | Swipe effect. For details, see **EdgeEffect**.<br>Default value: **EdgeEffect.Spring**<br>**NOTE**<br>The spring effect does not take effect when the controller API is called.|
-| nextMargin<sup>10+</sup>    | <br>[Length](ts-types.md#length)<br>| Next margin, used to reveal a small part of the next item.<br>Default value: **0**<br>**NOTE**<br>This parameter is valid only when **SwiperDisplayMode** is set to **STRETCH**. If **cachedCount** is set to a value less than or equal to 0, a small part of the next item is displayed, but child components cannot be loaded.        |
-| prevMargin<sup>10+</sup>    | <br>[Length](ts-types.md#length)<br>| Previous margin, used to reveal a small part of the previous item.<br>Default value: **0**<br>**NOTE**<br>This parameter is valid only when **SwiperDisplayMode** is set to **STRETCH**. If **cachedCount** is set to a value less than or equal to 0, a small part of the previous item is displayed, but child components cannot be loaded.       |
 
 ## SwiperDisplayMode
 
 | Name| Description|
 | ----------- | ------------------------------------------ |
-| Stretch     | The slide width of the **\<Swiper>** component is equal to the width of the component.|
-| AutoLinear  | The slide width of the **\<Swiper>** component is equal to that of the child component with the maximum width.|
+| Stretch<sup>(deprecated)</sup>     | The slide width of the **\<Swiper>** component is equal to the width of the component.<br>This API is deprecated since API version 10. You are advised to use **STRETCH** instead.|
+| AutoLinear<sup>(deprecated)</sup>   | The slide width of the **\<Swiper>** component is equal to that of the child component with the maximum width.<br>This API is deprecated since API version 10. You are advised to use **AUTO_LINEAR** instead.|
 
 ## SwiperController
 
@@ -92,10 +90,10 @@ Sets the distance between the navigation point indicator and the **\<Swiper>** c
 
 | Name| Type| Mandatory.| Description                            |
 | ------ | -------- | ------ | ------------------------------------ |
-| left   | [Length](ts-types.md#length)   | No    | Distance between the navigation point indicator and the left edge of the **\<Swiper>** component.|
-| top    | [Length](ts-types.md#length)   | No    | Distance between the navigation point indicator and the top edge of the **\<Swiper>** component.|
-| right  | [Length](ts-types.md#length)   | No    | Distance between the navigation point indicator and the right edge of the **\<Swiper>** component.|
-| bottom | [Length](ts-types.md#length)   | No    | Distance between the navigation point indicator and the bottom edge of the **\<Swiper>** component.|
+| left   | [Length](ts-types.md#length)   | No    | Distance between the navigation point indicator and the left edge of the **\<Swiper>** component.<br>Default value: **0**<br>Unit: vp|
+| top    | [Length](ts-types.md#length)   | No    | Distance between the navigation point indicator and the top edge of the **\<Swiper>** component.<br>Default value: **0**<br>Unit: vp|
+| right  | [Length](ts-types.md#length)   | No    | Distance between the navigation point indicator and the right edge of the **\<Swiper>** component.<br>Default value: **0**<br>Unit: vp|
+| bottom | [Length](ts-types.md#length)   | No    | Distance between the navigation point indicator and the bottom edge of the **\<Swiper>** component.<br>Default value: **0**<br>Unit: vp|
 
 ### DotIndicator