!10684 翻译完成 10429/9887/9895

Merge pull request !10684 from ester.zhou/TR-10429

en/application-dev/reference/apis/js-apis-accessibility-config.md

@@ -22,7 +22,7 @@ import config from "@ohos.accessibility.config";
 | -------- | -------- | -------- | -------- | -------- |
 | highContrastText | [Config](#config)\<boolean>| Yes| Yes| Whether to enable high-contrast text.|
 | invertColor | [Config](#config)\<boolean>| Yes| Yes| Whether to enable color inversion.|
-| daltonizationColorFilter | [Config](#config)&lt;[DaltonizationColorFilter](#daltonizationcolorfilter)&gt;| Yes| Yes| Configuration of the daltonization filter.|
+| daltonizationColorFilter | [Config](#config)\<[DaltonizationColorFilter](#daltonizationcolorfilter)>| Yes| Yes| Daltonization filter. |
 | contentTimeout | [Config](#config)\<number>| Yes| Yes| Recommended duration for content display. The value ranges from 0 to 5000, in milliseconds.|
 | animationOff | [Config](#config)\<boolean>| Yes| Yes| Whether to enable animation.|
 | brightnessDiscount | [Config](#config)\<number>| Yes| Yes| Brightness discount. The value ranges from 0 to 1.0.|
@@ -163,7 +163,7 @@ Adds a listener for changes in the list of enabled accessibility extension abili
 
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| type | string | Yes| Listening type. The value is fixed at **'enableAbilityListsStateChanged'**, indicating that the changes in the list of enabled accessibility extension abilities.|
+| type | string | Yes| Listening type. The value is fixed at **'enableAbilityListsStateChanged'**, indicating the changes in the list of enabled accessibility extension abilities. |
 | callback | Callback&lt;void&gt; | Yes| Callback invoked when the list of enabled accessibility extension abilities changes.|
 
 **Example**
@@ -186,7 +186,7 @@ Cancels the listener for changes in the list of enabled accessibility extension
 
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| type |  string | No| Listening type. The value is fixed at **'enableAbilityListsStateChanged'**, indicating that the changes in the list of enabled accessibility extension abilities.|
+| type |  string | No| Listening type. The value is fixed at **'enableAbilityListsStateChanged'**, indicating the changes in the list of enabled accessibility extension abilities. |
 | callback | Callback&lt;void&gt; | No| Callback invoked when the list of enabled accessibility extension abilities changes.|
 
 **Example**

en/application-dev/reference/apis/js-apis-accessibility-extension-context.md

@@ -34,13 +34,13 @@ Enumerates the focus directions.
 | up       | Search for the next focusable item above the current item in focus.|
 | down     | Search for the next focusable item below the current item in focus.|
 | left     | Search for the next focusable item on the left of the current item in focus.|
-| right    | Search for the next focusable item on the right the current item in focus.|
+| right    | Search for the next focusable item on the right of the current item in focus.|
 | forward  | Search for the next focusable item before the current item in focus.|
 | backward | Search for the next focusable item after the current item in focus.|
 
 ## FocusType
 
-Enumerates of the focus types.
+Enumerates the focus types.
 
 **System capability**: SystemCapability.BarrierFree.Accessibility.Core
 
@@ -55,8 +55,6 @@ Defines a rectangle.
 
 **System capability**: SystemCapability.BarrierFree.Accessibility.Core
 
-**Parameters**
-
 | Name    | Type  | Readable  | Writable  | Description       |
 | ------ | ------ | ---- | ---- | --------- |
 | left   | number | Yes   | No   | Left boundary of the rectangle.|
@@ -75,35 +73,9 @@ Enumerates the window types.
 | application | Application window.|
 | system      | System window.|
 
-## AccessibilityExtensionContext.setEventTypeFilter
-
-setEventTypeFilter(type: Array<accessibility.EventType>): Promise\<boolean>;
-
-Sets the concerned event type.
-
-**System capability**: SystemCapability.BarrierFree.Accessibility.Core
-
-**Parameters**
-
-| Name | Type                                    | Mandatory  | Description      |
-| ---- | ---------------------------------------- | ---- | -------- |
-| type | Array&lt;[EventType](js-apis-accessibility.md#EventType)&gt; | Yes   | Event type.|
-
-**Return value**
-
-| Type                    | Description                   |
-| ---------------------- | --------------------- |
-| Promise&lt;boolean&gt; | Promise used to return the result.|
-
-**Example**
-
-```ts
-this.context.setEventTypeFilter(['click', 'longClick']);
-```
-
 ## AccessibilityExtensionContext.setTargetBundleName
 
-setTargetBundleName(targetNames: Array\<string>): Promise\<boolean>;
+setTargetBundleName(targetNames: Array\<string>): Promise\<void>;
 
 Sets the concerned target bundle.
 
@@ -139,7 +111,7 @@ Obtains the focus element.
 
 | Name                 | Type   | Mandatory  | Description                 |
 | -------------------- | ------- | ---- | ------------------- |
-| isAccessibilityFocus | boolean | No   | Whether the obtained focus element is an accessibility focus. The default value is false.|
+| isAccessibilityFocus | boolean | No   | Whether the obtained focus element is an accessibility focus. The default value is **false**.|
 
 **Return value**
 
@@ -213,7 +185,7 @@ this.context.getWindows().then(windows => {
 
 ## AccessibilityExtensionContext.injectGesture
 
-injectGesture(gesturePath: GesturePath, listener: Callback\<boolean>): Promise\<boolean
+injectGesture(gesturePath: GesturePath, callback: AsyncCallback\<void>): void
 
 Injects a gesture.
 
@@ -224,13 +196,7 @@ Injects a gesture.
 | Name        | Type                                    | Mandatory  | Description            |
 | ----------- | ---------------------------------------- | ---- | -------------- |
 | gesturePath | [GesturePath](js-apis-application-AccessibilityExtensionAbility.md#GesturePath) | Yes   | Path of the gesture to inject.    |
-| listener    | Callback&lt;boolean&gt;                  | Yes   | Callback used to return the result.|
-
-**Return value**
-
-| Type                    | Description                    |
-| ---------------------- | ---------------------- |
-| Promise&lt;boolean&gt; | Promise used to return the result.|
+| callback    | AsyncCallback&lt;void&gt;                  | Yes   | Callback used to return the result.|
 
 **Example**
 
@@ -244,3 +210,170 @@ this.context.gestureInject(gesturePath, (result) => {
     console.info('gestureInject result: ' + result);
 })
 ```
+## AccessibilityElement.attributeNames
+
+attributeNames\<T extends keyof ElementAttributeValues>(): Promise\<Array\<T>>;
+
+Obtains all attribute names of this element.
+
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
+
+**Return value**
+
+| Type                                      | Description                      |
+| ---------------------------------------- | ------------------------ |
+| Promise&lt;Array&lt;T&gt;&gt; | Promise used to return all attribute names of the element.|
+
+**Example**
+
+```ts
+let accessibilityElement;
+try {
+    accessibilityElement.attributeNames().then((values) => {
+        console.log("get attribute names success");
+    }).catch((err) => {
+        console.log("get attribute names err: "  + JSON.stringify(err));
+    });
+} catch (e) {
+    console.log("An unexpected error occurred. Error:" + e);
+}
+```
+
+## AccessibilityElement.attributeValue
+
+attributeValue\<T extends keyof ElementAttributeValues>(attributeName: T): Promise\<ElementAttributeValues[T]>;
+
+Obtains the attribute value based on an attribute name.
+
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
+
+**Parameters**
+
+| Name        | Type                                    | Mandatory  | Description            |
+| ----------- | ---------------------------------------- | ---- | -------------- |
+| attributeName | T | Yes   | Attribute name.    |
+
+**Return value**
+
+| Type                                      | Description                      |
+| ---------------------------------------- | ------------------------ |
+| Promise&lt;Array&lt;ElementAttributeValues[T]&gt;&gt; | Promise used to return the attribute value.|
+
+**Example**
+
+```ts
+let accessibilityElement;
+try {
+    let attributeName = 'name';
+    accessibilityElement.attributeValue(attributeName).then((value) => {
+        console.log("get attribute value by name success");
+    }).catch((err) => {
+        console.log("get attribute value by name err: "  + JSON.stringify(err));
+    });
+} catch (e) {
+    console.log("An unexpected error occurred. Error:" + e);
+}
+```
+
+## AccessibilityElement.actionNames
+
+actionNames(): Promise\<Array\<string>>;
+
+Obtains the names of all actions supported by this element.
+
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
+
+**Return value**
+
+| Type                                      | Description                      |
+| ---------------------------------------- | ------------------------ |
+| Promise&lt;Array&lt;string&gt;&gt; | Promise used to return the names of all actions supported by the element.|
+
+**Example**
+
+```ts
+let accessibilityElement;
+try {
+    accessibilityElement.actionNames().then((values) => {
+        console.log("get action names success");
+    }).catch((err) => {
+        console.log("get action names err: "  + JSON.stringify(err));
+    });
+} catch (e) {
+    console.log("An unexpected error occurred. Error:" + e);
+}
+```
+
+## AccessibilityElement.performAction
+
+performAction(actionName: string, parameters?: object): Promise\<boolean>;
+
+Performs an action based on the specified action name.
+
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
+
+**Parameters**
+
+| Name        | Type                                    | Mandatory  | Description            |
+| ----------- | ---------------------------------------- | ---- | -------------- |
+| actionName | string | Yes   | Action name.    |
+| parameters | object | No   | Parameter required for performing the target action.    |
+
+**Return value**
+
+| Type                                      | Description                      |
+| ---------------------------------------- | ------------------------ |
+| Promise&lt;Array&lt;boolean&gt;&gt; | Promise used to return the result.|
+
+**Example**
+
+```ts
+let accessibilityElement;
+try {
+
+    accessibilityElement.performAction('action').then((result) => {
+        console.info('perform action result: ' + result);
+    }).catch((err) => {
+        console.log("perform action err: "  + JSON.stringify(err));
+    });
+} catch (e) {
+    console.log("An unexpected error occurred. Error:" + e);
+}
+```
+
+## AccessibilityElement.findElement
+
+findElement(type: 'content', condition: string): Promise\<Array\<AccessibilityElement>>;
+
+Queries the information about this element based on the specified information type and condition.
+
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
+
+**Parameters**
+
+| Name        | Type                                    | Mandatory  | Description            |
+| ----------- | ---------------------------------------- | ---- | -------------- |
+| type | string | Yes   | Information type. The value is fixed at **'content'**.    |
+| condition | string | Yes   | Search criteria.    |
+
+**Return value**
+
+| Type                                      | Description                      |
+| ---------------------------------------- | ------------------------ |
+| Promise&lt;Array&lt;T&gt;&gt; | Promise used to return the result.|
+
+**Example**
+
+```ts
+let accessibilityElement;
+try {
+    let condition = 'keyword';
+    accessibilityElement.findElement('content', condition).then((values) => {
+        console.log("find element success");
+    }).catch((err) => {
+        console.log("find element err: "  + JSON.stringify(err));
+    });
+} catch (e) {
+    console.log("An unexpected error occurred. Error:" + e);
+}
+```

en/application-dev/reference/apis/js-apis-device-info.md

 # Device Information
 
+The **deviceInfo** module provides product information.
+
 > **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.

en/application-dev/ui/ts-component-based-builder.md

 # @Builder
 
 
-The **@Builder** decorated method is used to define the declarative UI description of a component and quickly generate multiple layouts in a custom component. The functionality and syntax of the **@Builder** decorator are the same as those of the [build Function](ts-function-build.md).
+The **@Builder** decorated method is used to define the declarative UI description of a component and quickly generate multiple layouts in a custom component. If a custom component is used in the **@Builder** decorated method, this component will be re-created each time the method is invoked. The functionality and syntax of the **@Builder** decorator are the same as those of the **build** function.
 
 
 ```ts
 // xxx.ets
+
+@Component
+struct CompB {
+  @State CompValue: string = '';
+
+  aboutToAppear() {
+    console.info('CompB aboutToAppear.');
+  }
+
+  aboutToDisappear() {
+    console.info('CompB aboutToDisappear.');
+  }
+
+  build() {
+    Column() {
+      Button(this.CompValue);
+    }
+  }
+}
+
 @Entry
 @Component
 struct CompA {
-  size1 : number = 100;
+  size1: number = 100;
+  @State CompValue1: string = "Hello,CompValue1";
+  @State CompValue2: string = "Hello,CompValue2";
+  @State CompValue3: string = "Hello,CompValue3";
+
+  // Use a custom component in the @Builder decorated method.
+  @Builder CompC(value: string) {
+    CompB({ CompValue: value });
+  }
 
   @Builder SquareText(label: string) {
     Text(label)
@@ -35,7 +63,16 @@ struct CompA {
       }
       .width(2 * this.size1)
       .height(1 * this.size1)
+
       this.RowOfSquareTexts("C", "D")
+      Column() {
+        // Use the custom component in the @Builder decorated method three times.
+        this.CompC(this.CompValue1);
+        this.CompC(this.CompValue2);
+        this.CompC(this.CompValue3);
+      }
+      .width(2 * this.size1)
+      .height(2 * this.size1)
     }
     .width(2 * this.size1)
     .height(2 * this.size1)
@@ -99,7 +136,7 @@ struct CustomContainerUser {
 }
 ```
 ### Component Initialization Through Trailing Closure
-In a custom component, use the **@BuilderParam** decorated attribute to receive a trailing closure. When the custom component is initialized, the component name is followed by a pair of braces ({}) to form a trailing closure (`CustomComponent(){}`). You can consider a trailing closure as a container and add content to it. For example, you can add a component (`{Column(){Text("content")}`) to a trailing closure. The syntax of the closure is the same as that of [build](../ui/ts-function-build.md). In this scenario, the custom component has one and only one **@BuilderParam** decorated attribute.
+In a custom component, use the **@BuilderParam** decorated attribute to receive a trailing closure. When the custom component is initialized, the component name is followed by a pair of braces ({}) to form a trailing closure (`CustomComponent(){}`). You can consider a trailing closure as a container and add content to it. For example, you can add a component (`{Column(){Text("content")}`) to a trailing closure. The syntax of the closure is the same as that of the **build** function. In this scenario, the custom component has one and only one **@BuilderParam** decorated attribute.
 
 Example: Add a **\<Column>** component and a click event to the closure, and call the **specificParam** method decorated by **@Builder** in the new **\<Column>** component. After the **\<Column>** component is clicked, the value of the component's `header` attribute will change to `changeHeader`. In addition, when the component is initialized, the content of the trailing closure will be assigned to the `closer` attribute decorated by **@BuilderParam**.
 ```ts