!12784 翻译完成 10367+11364

Merge pull request !12784 from ester.zhou/C1-1221

en/application-dev/reference/apis/js-apis-inputmethod.md

 # Input Method Framework
 
-> **NOTE**
+The **inputMethod** module provides an input method framework, which can be used to hide the keyboard, obtain the list of installed input methods, display the dialog box for input method selection, and more.
+
+>**NOTE**
 >
-> The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+>The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
 
 ## Modules to Import
 
-```
+```js
 import inputMethod from '@ohos.inputmethod';
 ```
 
-## inputMethod<sup>6+</sup>
+## Constants
 
 Provides the constants.
 
-**System capability**: SystemCapability.MiscServices.InputMethodFramework
-
-| Name| Type| Readable| Writable| Description|
-| -------- | -------- | -------- | -------- | -------- |
-| MAX_TYPE_NUM | number | Yes| No| Maximum number of supported input methods.|
+**System capability**: SystemCapability.Miscservices.InputMethodFramework
 
+| Name| Type| Value| Description|
+| -------- | -------- | -------- | -------- |
+| MAX_TYPE_NUM | number | 128 | Maximum number of supported input methods.|
 
-## InputMethodProperty<sup>6+</sup>
+## InputMethodProperty
 
 Describes the input method application attributes.
 
-**System capability**: SystemCapability.MiscServices.InputMethodFramework
+**System capability**: SystemCapability.Miscservices.InputMethodFramework
 
 | Name| Type| Readable| Writable| Description|
 | -------- | -------- | -------- | -------- | -------- |
-| packageName | string | Yes| No| Package name.|
-| methodId | string | Yes| No| Ability name.|
+| packageName | string | Yes| No| Name of the input method package.<br>**NOTE**<br>This API is supported since API version 8 and deprecated since API version 9. You are advised to use **name**.|
+| methodId | string | Yes| No| Unique ID of the input method.<br>**NOTE**<br>This API is supported since API version 8 and deprecated since API version 9. You are advised to use **id**.|
+
+
 
 ## inputMethod.getInputMethodController
 
 getInputMethodController(): InputMethodController
 
-Obtains an [InputMethodController](#InputMethodController) instance.
+Obtains an **[InputMethodController](#inputmethodcontroller)** instance.
 
-**System capability**: SystemCapability.MiscServices.InputMethodFramework
+**System capability**: SystemCapability.Miscservices.InputMethodFramework
 
 **Return value**
 
-| Type| Description|
-| -------- | -------- |
-| [InputMethodController](#InputMethodController) | Returns the current **InputMethodController** instance.|
+| Type                                           | Description                    |
+| ----------------------------------------------- | ------------------------ |
+| [InputMethodController](#inputmethodcontroller) | Current **InputMethodController** instance.|
 
 **Example**
 
 ```js
-  var InputMethodController = inputMethod.getInputMethodController();
+let inputMethodController = inputMethod.getInputMethodController();
 ```
 
-## inputMethod.getInputMethodSetting<sup>6+</sup>
+## inputMethod.getInputMethodSetting
 
 getInputMethodSetting(): InputMethodSetting
 
-Obtains an [InputMethodSetting](#InputMethodSetting) instance.
+Obtains an **[InputMethodSetting](#inputmethodsetting)** instance.
 
-**System capability**: SystemCapability.MiscServices.InputMethodFramework
+**System capability**: SystemCapability.Miscservices.InputMethodFramework
 
 **Return value**
 
 | Type                                     | Description                        |
 | ----------------------------------------- | ---------------------------- |
-| [InputMethodSetting](#InputMethodSetting) | Returns the current **InputMethodSetting** instance.|
+| [InputMethodSetting](#inputmethodsetting) | Current **InputMethodSetting** instance.|
 
 **Example**
 
 ```js
-  var InputMethodSetting = inputMethod.getInputMethodSetting();
+let inputMethodSetting = inputMethod.getInputMethodSetting();
 ```
 
 ## InputMethodController
 
-In the following API examples, you must first use [getInputMethodController](#getInputMethodController) to obtain an **InputMethodController** instance, and then call the APIs using the obtained instance.
+In the following API examples, you must first use [getInputMethodController](#inputmethodgetinputmethodcontroller) to obtain an **InputMethodController** instance, and then call the APIs using the obtained instance.
 
 ### stopInput
 
 stopInput(callback: AsyncCallback&lt;boolean&gt;): void
 
-Hides the keyboard. This API uses an asynchronous callback to return the result.
+Ends this input session. The invoking of this API takes effect only after the input session is enabled by clicking the text box. This API uses an asynchronous callback to return the result.
 
-**System capability**: SystemCapability.MiscServices.InputMethodFramework
+**System capability**: SystemCapability.Miscservices.InputMethodFramework
 
 **Parameters**
 
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| callback | AsyncCallback&lt;boolean&gt; | Yes| Callback used to return whether the keyboard is successfully hidden.|
+| callback | AsyncCallback&lt;boolean&gt; | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object. |
 
 **Example**
 
 ```js
- InputMethodController.stopInput((error)=>{
-     console.info('stopInput');
- });
+inputMethodController.stopInput((error, result) => {
+    if (error) {
+        console.error('Failed to stop inputmethod session: ' + JSON.stringify(error));
+        return;
+    }
+    if (result) {
+        console.info('Succeeded in stopping inputmethod session.');
+    } else {
+        console.error('Failed to stop inputmethod session.');
+    }
+});
 ```
 
 ### stopInput
 
 stopInput(): Promise&lt;boolean&gt;
 
-Hides the keyboard. This API uses an asynchronous callback to return the result.
+Ends this input session. The invoking of this API takes effect only after the input session is enabled by clicking the text box. This API uses a promise to return the result.
 
-**System capability**: SystemCapability.MiscServices.InputMethodFramework
+**System capability**: SystemCapability.Miscservices.InputMethodFramework
 
 **Return value**
 
 | Type| Description|
 | -------- | -------- |
-| Promise&lt;boolean&gt; | Promise used to return whether the keyboard is successfully hidden.|
+| Promise&lt;boolean&gt; | Promise used to return the result. The value **true** means that the hiding is successful, and **false** means the opposite.|
 
 **Example**
 
-
 ```js
-  var isSuccess = InputMethodController.stopInput();
-  console.info('stopInput isSuccess = ' + isSuccess);
+inputMethodController.stopInput().then((result) => {
+    if (result) {
+        console.info('Succeeded in stopping inputmethod session.');
+    } else {
+        console.error('Failed to stop inputmethod session');
+    }
+})
 ```
 
-## InputMethodSetting<sup>6+</sup>
+## InputMethodSetting
 
-In the following API examples, you must first use [getInputMethodSetting](#getInputMethodSetting) to obtain an **InputMethodSetting** instance, and then call the APIs using the obtained instance.
+In the following API examples, you must first use [getInputMethodSetting](#inputmethodgetinputmethodsetting) to obtain an **InputMethodSetting** instance, and then call the APIs using the obtained instance.
 
 ### listInputMethod
 
 listInputMethod(callback: AsyncCallback&lt;Array&lt;InputMethodProperty&gt;&gt;): void
 
-Obtains the list of installed input methods. This API uses an asynchronous callback to return the result.
+Obtains a list of installed input methods. This API uses an asynchronous callback to return the result.
 
-**System capability**: SystemCapability.MiscServices.InputMethodFramework
+**System capability**: SystemCapability.Miscservices.InputMethodFramework
 
 **Parameters**
 
 | Name  | Type                                              | Mandatory| Description                  |
 | -------- | -------------------------------------------------- | ---- | ---------------------- |
-| callback | Array<[InputMethodProperty](#InputMethodProperty)> | Yes  | Callback used to return the list of installed input methods.|
+| callback | AsyncCallback&lt;Array<[InputMethodProperty](#inputmethodproperty)>&gt; | Yes  | Callback used to return the list of installed input methods.|
 
 **Example**
 
 ```js
-  InputMethodSetting.listInputMethod((properties)=>{
-    for (var i = 0;i < properties.length; i++) {
-     var property = properties[i];
-     console.info(property.packageName + "/" + property.methodId);
+inputMethodSetting.listInputMethod((err, data) => {
+    if(err) {
+        console.error('Failed to list inputmethods: ' + JSON.stringify(err));
+        return;
     }
-  });
+    console.log('Succeeded in listing inputmethods, data: ' + JSON.stringify(data));
+ });
 ```
 
 ### listInputMethod
 
 listInputMethod(): Promise&lt;Array&lt;InputMethodProperty&gt;&gt;
 
-Obtains the list of installed input methods. This API uses an asynchronous callback to return the result.
+Obtains a list of installed input methods. This API uses a promise to return the result.
 
-**System capability**: SystemCapability.MiscServices.InputMethodFramework
+**System capability**: SystemCapability.Miscservices.InputMethodFramework
 
 **Return value**
 
 | Type                                                       | Description                  |
 | ----------------------------------------------------------- | ---------------------- |
-| Promise<Array<[InputMethodProperty](#InputMethodProperty)>> | Promise used to return the list of installed input methods.|
+| Promise<Array<[InputMethodProperty](#inputmethodproperty8)>> | Promise used to return the list of installed input methods.|
 
 **Example**
 
 ```js
-  var properties = InputMethodSetting.listInputMethod();
-  for (var i = 0;i < properties.length; i++) {
-    var property = properties[i];
-    console.info(property.packageName + "/" + property.methodId);
-  }
+inputMethodSetting.listInputMethod().then((data) => {
+    console.info('Succeeded in listing inputMethod.');
+}).catch((err) => {
+    console.error('Failed to list inputMethod: ' + JSON.stringify(err));
+})
 ```
 
 ### displayOptionalInputMethod
@@ -180,37 +196,46 @@ displayOptionalInputMethod(callback: AsyncCallback&lt;void&gt;): void
 
 Displays a dialog box for selecting an input method. This API uses an asynchronous callback to return the result.
 
-**System capability**: SystemCapability.MiscServices.InputMethodFramework
+**System capability**: SystemCapability.Miscservices.InputMethodFramework
 
-- Parameters
+**Parameters**
 
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the execution result.|
+| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined**. Otherwise, **err** is an error object. |
 
 **Example**
+
 ```js
-  InputMethodSetting.displayOptionalInputMethod(()=>{
-   console.info('displayOptionalInputMethod is called');
-   });
+inputMethodSetting.displayOptionalInputMethod((err) => {
+    if (err) {
+        console.error('Failed to display optionalInputMethod:' + JSON.stringify(err));
+        return;
+    }
+    console.info('Succeeded in displaying optionalInputMethod.');
+});
 ```
 
 ### displayOptionalInputMethod
 
 displayOptionalInputMethod(): Promise&lt;void&gt;
 
-Displays a dialog box for selecting an input method. This API uses an asynchronous callback to return the result.
+Displays a dialog box for selecting an input method. This API uses a promise to return the result.
 
-**System capability**: SystemCapability.MiscServices.InputMethodFramework
+**System capability**: SystemCapability.Miscservices.InputMethodFramework
 
 **Return value**
 
 | Type| Description|
 | -------- | -------- |
-| Promise&lt;void&gt; | Promise used to return the execution result.|
+| Promise&lt;void&gt; | Promise that returns no value.|
 
 **Example**
 
 ```js
-  InputMethodSetting.displayOptionalInputMethod();
-```
+inputMethodSetting.displayOptionalInputMethod().then(() => {
+    console.info('Succeeded in displaying optionalInputMethod.');
\ No newline at end of file
+}).catch((err) => {
+    console.error('Failed to display optionalInputMethod: ' + JSON.stringify(err));
+})
+```

en/application-dev/reference/arkui-ts/ts-universal-attributes-background.md

@@ -10,10 +10,10 @@ You can set the background of a component.
 
 | Name| Type| Description|
 | -------- | -------- | -------- |
-| backgroundColor | [ResourceColor](ts-types.md#resourcecolor) | Background color of the component. |
-| backgroundImage | src: [ResourceStr](ts-types.md#resourcestr),<br>repeat?: [ImageRepeat](ts-appendix-enums.md#imagerepeat) | Background image of the component.<br>**src**: image address, which can be the address of an Internet or a local image. (SVG images are not supported.)<br>**repeat**: whether the background image is repeatedly used. By default, the background image is not repeatedly used. |
+| backgroundColor | [ResourceColor](ts-types.md#resourcecolor) | Background color of the component.|
+| backgroundImage | src: [ResourceStr](ts-types.md#resourcestr),<br>repeat?: [ImageRepeat](ts-appendix-enums.md#imagerepeat) | **src**: image address, which can be the address of an Internet or a local image. (SVG images are not supported.)<br>**repeat**: whether the background image is repeatedly used. By default, the background image is not repeatedly used.|
 | backgroundImageSize | {<br>width?: [Length](ts-types.md#length),<br>height?: [Length](ts-types.md#length)<br>} \| [ImageSize](ts-appendix-enums.md#imagesize) | Width and height of the background image. If the input is a **{width: Length, height: Length}** object and only one attribute is set, the other attribute is the set value multiplied by the original aspect ratio of the image. By default, the original image aspect ratio remains unchanged.<br>Default value: **ImageSize.Auto**|
-| backgroundImagePosition | {<br/>x?: [Length](ts-types.md#length),<br/>y?: [Length](ts-types.md#length)<br/>} \| [Alignment](ts-appendix-enums.md#alignment) | Position of the background image in the component.<br>Default value:<br>**{<br>x: 0,<br>y: 0<br>}** |
+| backgroundImagePosition | [Position](ts-types.md#position8) \| [Alignment](ts-appendix-enums.md#alignment) | Position of the background image in the component.<br>Default value:<br>{<br>x: 0,<br>y: 0<br>} <br> When **x** and **y** are set in percentage, the offset is calculated based on the width and height of the component. |
 
 ## Example
 

en/application-dev/reference/arkui-ts/ts-universal-attributes-component-id.md

@@ -22,7 +22,8 @@
 getInspectorByKey(id: string): string
 
 Obtains all attributes of the component with the specified ID, excluding the information about child components.
-This is a system API. 
+
+This is a system API.
 
 **Parameters**
 
@@ -41,7 +42,8 @@ This is a system API.
 getInspectorTree(): string
 
 Obtains the component tree and component attributes.
-This is a system API. 
+
+This is a system API.
 
 **Return value**
 
@@ -54,6 +56,7 @@ This is a system API.
 sendEventByKey(id: string, action: number, params: string): boolean
 
 Sends an event to the component with the specified ID.
+
 This is a system API. 
 
 **Parameters**
@@ -75,7 +78,8 @@ This is a system API.
 sendTouchEvent(event: TouchObject): boolean
 
 Sends a touch event.
-This is a system API. 
+
+This is a system API.
 
 **Parameters**
 
@@ -95,6 +99,8 @@ sendKeyEvent(event: KeyEvent): boolean
 
 Sends a key event.
 
+This is a system API.
+
 **Parameters**
 
 | Name   | Type    | Mandatory     | Description                                                        |
@@ -113,6 +119,8 @@ sendMouseEvent(event: MouseEvent): boolean
 
 Sends a mouse event.
 
+This is a system API.
+
 **Parameters**
 
 | Name    | Type      | Mandatory      | Description                                    |

en/application-dev/reference/arkui-ts/ts-universal-attributes-gradient-color.md

@@ -4,17 +4,17 @@ Create a more gorgeous look for a component by applying a gradient color effect
 
 >  **NOTE**
 >
-> This attribute is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
+> The APIs of this module are supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
 ## Attributes
 
 
-| Name| Type| Default Value| Description|
-| -------- | -------- | -------- | -------- |
-| linearGradient | {<br>angle?: number \| string,<br>direction?: [GradientDirection](ts-appendix-enums.md#gradientdirection),<br>colors: Array&lt;[ColorStop](ts-basic-components-gauge.md#colorstop)&gt;,<br>repeating?: boolean<br>} | - | Linear gradient.<br>**angle**: angle of the linear gradient.<br>**direction**: direction of the linear gradient. It does not take effect when **angle** is set.<br>**colors**: description of the gradient colors.<br>**repeating**: whether the colors are repeated.|
-| sweepGradient | {<br>center: Point,<br>start?: number \| string,<br>end?: number \| string,<br>rotation?: number\|string,<br>colors: Array&lt;[ColorStop](ts-basic-components-gauge.md#colorstop)&gt;,<br>repeating?: boolean<br>} | - | Angle gradient.<br>**center**: center point of the angle gradient.<br>**start**: start point of the angle gradient.<br>**end**: end point of the angle gradient.<br>**rotation**: rotation angle of the angle gradient.<br>**colors**: description of the gradient colors.<br>**repeating**: whether the colors are repeated.|
-| radialGradient | {<br>center: Point,<br>radius: number \| string,<br>colors: Array&lt;[ColorStop](ts-basic-components-gauge.md#colorstop)&gt;,<br>repeating?: boolean<br>} | - | Radial gradient.<br>**center**: center point of the radial gradient.<br>**radius**: radius of the radial gradient.<br>**colors**: description of the gradient colors.<br>**repeating**: whether the colors are repeated.|
+| Name             | Type                                        | Description                              |
+| -------------- | -------------------------------------------- | ----------------------------------- |
+| linearGradient | {<br>angle?: number \| string,<br>direction?: [GradientDirection](ts-appendix-enums.md#gradientdirection),<br>colors: Array&lt;[ColorStop](ts-basic-components-gauge.md#colorstop)&gt;,<br>repeating?: boolean<br>} | Linear gradient.<br>- **angle**: start angle of the linear gradient. A positive value indicates a clockwise rotation from the origin, (0, 0).<br>  Default value: **180**<br>- **direction**: direction of the linear gradient. It does not take effect when **angle** is set.<br>  Default value: **GradientDirection.Bottom**<br>- **colors**: colors of the linear gradient.<br>- **repeating**: whether the colors are repeated.<br>  Default value: **false**|
+| sweepGradient  | {<br>center: Point,<br>start?: number \| string,<br>end?: number \| string,<br>rotation?: number\|string,<br>colors: Array&lt;[ColorStop](ts-basic-components-gauge.md#colorstop)&gt;,<br>repeating?: boolean<br>} | Angle gradient.<br>- **center**: center point of the angle gradient, that is, the coordinates relative to the upper left corner of the current component.<br>- **start**: start point of the angle gradient.<br>  Default value: **0**<br>- **end**: end point of the angle gradient.<br>  Default value: **0**<br>- **rotation**: rotation angle of the angle gradient.<br>  Default value: **0**<br>- **colors**: colors of the angle gradient.<br>- **repeating**: whether the colors are repeated.<br>  Default value: **false**|
+| radialGradient | {<br>center: Point,<br> radius: number \| string,<br>colors: Array&lt;[ColorStop](ts-basic-components-gauge.md#colorstop)&gt;,<br>repeating?: boolean<br>} | Radial gradient.<br>- **center**: center point of the radial gradient, that is, the coordinates relative to the upper left corner of the current component.<br>- **radius**: radius of the radial gradient.<br>- **colors**: colors of the radial gradient.<br>- **repeating**: whether the colors are repeated.<br>  Default value: **false**|
 
 
 ## Example
@@ -24,7 +24,6 @@ Create a more gorgeous look for a component by applying a gradient color effect
 @Entry
 @Component
 struct ColorGradientExample {
-  
   build() {
     Column({ space: 5 }) {
       Text('linearGradient').fontSize(12).width('90%').fontColor(0xCCCCCC)
@@ -33,8 +32,32 @@ struct ColorGradientExample {
         .height(50)
         .linearGradient({
           angle: 90,
-          colors: [[0xAEE1E1, 0.0], [0xD3E0DC, 0.3], [0xFCD1D1, 1.0]]
+          colors: [[0xff0000, 0.0], [0x0000ff, 0.3], [0xffff00, 1.0]]
         })
+      Text('linearGradient Repeat').fontSize(12).width('90%').fontColor(0xCCCCCC)
+      Row()
+        .width('90%')
+        .height(50)
+        .linearGradient({
+          direction: GradientDirection.Left, // Gradient direction.
+          repeating: true, // Whether the gradient colors are repeated.
+          colors: [[0xff0000, 0.0], [0x0000ff, 0.3], [0xffff00, 0.5]] // The gradient colors are repeated because the last color stop is less than 1.
+        })
+    }
+    .width('100%')
+    .padding({ top: 5 })
+  }
+}
+```
+
+![en-us_image_0000001219864149](figures/gradientColor1.png)
+
+```ts
+@Entry
+@Component
+struct ColorGradientExample {
+  build() {
+    Column({ space: 5 }) {
       Text('sweepGradient').fontSize(12).width('90%').fontColor(0xCCCCCC)
       Row()
         .width(100)
@@ -43,8 +66,37 @@ struct ColorGradientExample {
           center: [50, 50],
           start: 0,
           end: 359,
-          colors: [[0xAEE1E1, 0.0], [0xD3E0DC, 0.3], [0xFCD1D1, 1.0]]
+          colors: [[0xff0000, 0.0], [0x0000ff, 0.3], [0xffff00, 1.0]]
         })
+      
+      Text('sweepGradient Reapeat').fontSize(12).width('90%').fontColor(0xCCCCCC)
+      Row()
+        .width(100)
+        .height(100)
+        .sweepGradient({
+          center: [50, 50],
+          start: 0,
+          end: 359,
+          rotation: 45, // Rotation angle.
+          repeating: true, // Whether the gradient colors are repeated.
+          colors: [[0xff0000, 0.0], [0x0000ff, 0.3], [0xffff00, 0.5]] // The gradient colors are repeated because the last color stop is less than 1.
+        })
+    }
+    .width('100%')
+    .padding({ top: 5 })
+  }
+}
+```
+
+![en-us_image_0000001219864149](figures/gradientColor2.png)
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct ColorGradientExample {
+  build() {
+    Column({ space: 5 }) {
       Text('radialGradient').fontSize(12).width('90%').fontColor(0xCCCCCC)
       Row()
         .width(100)
@@ -52,7 +104,17 @@ struct ColorGradientExample {
         .radialGradient({
           center: [50, 50],
           radius: 60,
-          colors:[[0xAEE1E1, 0.0], [0xD3E0DC, 0.3], [0xFCD1D1, 1.0]]
+          colors: [[0xff0000, 0.0], [0x0000ff, 0.3], [0xffff00, 1.0]]
+        })
+      Text('radialGradient Repeat').fontSize(12).width('90%').fontColor(0xCCCCCC)
+      Row()
+        .width(100)
+        .height(100)
+        .radialGradient({
+          center: [50, 50],
+          radius: 60,
+          repeating: true,
+          colors: [[0xff0000, 0.0], [0x0000ff, 0.3], [0xffff00, 0.5]] // The gradient colors are repeated because the last color stop is less than 1.
         })
     }
     .width('100%')
@@ -61,4 +123,4 @@ struct ColorGradientExample {
 }
 ```
 
-![en-us_image_0000001212218484](figures/en-us_image_0000001212218484.png)
+![en-us_image_0000001219864149](figures/gradientColor3.png)