diff --git a/en/application-dev/Readme-EN.md b/en/application-dev/Readme-EN.md
index 429326b5e46c404784224fc8fad1d88d98334914..32d357ba419d3cde2750011141449e2129133a5d 100644
--- a/en/application-dev/Readme-EN.md
+++ b/en/application-dev/Readme-EN.md
@@ -7,16 +7,15 @@
- [OpenHarmony Release Notes](../release-notes/Readme.md)
- Quick Start
- Getting Started
- - [Preparations](quick-start/start-overview.md)
- - [Getting Started with eTS in the Traditional Coding Approach](quick-start/start-with-ets.md)
- - [Getting Started with eTS in the Low-Code Approach](quick-start/start-with-ets-low-code.md)
- - [Getting Started with JavaScript in the Traditional Coding Approach](quick-start/start-with-js.md)
- - [Getting Started with JavaScript in the Low-Code Approach](quick-start/start-with-js-low-code.md)
+ - [Preparations](quick-start/start-overview.md)
+ - [Getting Started with eTS in the Traditional Coding Approach](quick-start/start-with-ets.md)
+ - [Getting Started with eTS in the Low-Code Approach](quick-start/start-with-ets-low-code.md)
+ - [Getting Started with JavaScript in the Traditional Coding Approach](quick-start/start-with-js.md)
+ - [Getting Started with JavaScript in the Low-Code Approach](quick-start/start-with-js-low-code.md)
- Development Fundamentals
- - [Application Package Structure Configuration File (FA Model)](quick-start/package-structure.md)
- - [Application Package Structure Configuration File (Stage Model)](quick-start/stage-structure.md)
- - [Resource File Categories](quick-start/basic-resource-file-categories.md)
- - [SysCap](quick-start/syscap.md)
+ - [Application Package Structure Configuration File (FA Model)](quick-start/package-structure.md)
+ - [Application Package Structure Configuration File (Stage Model)](quick-start/stage-structure.md)
+ - [SysCap](quick-start/syscap.md)
- Development
- [Ability Development](ability/Readme-EN.md)
- [UI Development](ui/Readme-EN.md)
@@ -33,20 +32,16 @@
- [Device Usage Statistics](device-usage-statistics/Readme-EN.md)
- [DFX](dfx/Readme-EN.md)
- [Internationalization](internationalization/Readme-EN.md)
- - [Native APIs](napi/Readme-EN.md)
+ - [Using Native APIs in Application Projects](napi/Readme-EN.md)
- Tools
- [DevEco Studio (OpenHarmony) User Guide](quick-start/deveco-studio-user-guide-for-openharmony.md)
- Hands-On Tutorials
- [Samples](https://gitee.com/openharmony/app_samples/blob/master/README.md)
- - [Codelabs](https://gitee.com/openharmony/codelabs/blob/master)
+ - [Codelabs](https://gitee.com/openharmony/codelabs)
- API References
- [Component Reference (TypeScript-based Declarative Development Paradigm)](reference/arkui-ts/Readme-EN.md)
- [Component Reference (JavaScript-based Web-like Development Paradigm)](reference/arkui-js/Readme-EN.md)
- APIs
- - [JS and TS APIs](reference/apis/Readme-EN.md)
- - Native APIs
- - [Standard Libraries](reference/native-lib/third_party_libc/musl.md)
- - [Node_API](reference/native-lib/third_party_napi/napi.md)
+ - [JS and TS APIs](reference/apis/Readme-EN.md)
- Contribution
- [How to Contribute](../contribute/documentation-contribution.md)
-
diff --git a/en/application-dev/database/database-relational-guidelines.md b/en/application-dev/database/database-relational-guidelines.md
index c0b2a5328d8ab9f2458bbebbb96b214e04b04653..c8ff6bc64eeccb90c131d5ac4e799b09e6293b9c 100644
--- a/en/application-dev/database/database-relational-guidelines.md
+++ b/en/application-dev/database/database-relational-guidelines.md
@@ -6,57 +6,52 @@ A relational database (RDB) store allows you to operate local data with or witho
## Available APIs
-For details about RDB APIs, see [Relational Database](../reference/apis/js-apis-data-rdb.md).
+Most of the RDB store APIs are asynchronous interfaces, which can use a callback or promise to return the result. This document uses the promise-based APIs as an example. For details about the APIs, see [Relational Database](../reference/apis/js-apis-data-rdb.md).
### Creating or Deleting an RDB Store
-The following table describes the APIs available for creating and deleting an RDB store.
+The table below describes the APIs available for creating and deleting an RDB store.
**Table 1** APIs for creating and deleting an RDB store
| API| Description|
| -------- | -------- |
-|getRdbStore(config: StoreConfig, version: number, callback: AsyncCallback<RdbStore>): void | Obtains an RDB store. This API uses a callback to return the result. You can set parameters for the RDB store based on service requirements, and then call APIs to perform data operations. - **config**: configuration of the RDB store. - **version**: RDB version. - **callback**: callback invoked to return the RDB store obtained.|
-|getRdbStore(config: StoreConfig, version: number): Promise<RdbStore> | Obtains an RDB store. This API uses a promise to return the result. You can set parameters for the RDB store based on service requirements, and then call APIs to perform data operations. - **config**: configuration of the RDB store. - **version**: RDB version.|
-|deleteRdbStore(name: string, callback: AsyncCallback<void>): void | Deletes an RDB store. This API uses a callback to return the result. - **name**: RDB store to delete. - **callback**: callback invoked to return the result.|
-| deleteRdbStore(name: string): Promise<void> | Deletes an RDB store. This API uses a promise to return the result. - **name**: RDB store to delete.|
+|getRdbStore(config:StoreConfig,version:number):Promise<RdbStore> | Obtains an RDB store. This API uses a promise to return the result. You can set parameters for the RDB store based on service requirements and call APIs to perform data operations. - **config**: configuration of the RDB store. - **version**: version of the RDB store.|
+| deleteRdbStore(name:string):Promise<void> | Deletes an RDB store. This API uses a promise to return the result. - **name**: name of the RDB store to delete.|
### Managing Data in an RDB Store
The RDB provides APIs for inserting, deleting, updating, and querying data in the local RDB store.
-- **Inserting data**
+- **Inserting Data**
The RDB provides APIs for inserting data through a **ValuesBucket** in a data table. If the data is inserted, the row ID of the data inserted will be returned; otherwise, **-1** will be returned.
- **Table 2** APIs for inserting data
+ **Table 2** API for inserting data
| Class| API| Description|
| -------- | -------- | -------- |
- | RdbStore | insert(name: string, values: ValuesBucket, callback: AsyncCallback<number>):void | Inserts a row of data into a table. This API uses a callback to return the result. - **name**: name of the target table. - **values**: data to be inserted into the table. - **callback**: callback invoked to return the result. If the operation is successful, the row ID will be returned; otherwise, **-1** will be returned.|
- | RdbStore | insert(name: string, values: ValuesBucket): Promise<number> | Inserts a row of data into a table. This API uses a promise to return the result. - **name**: name of the target table. - **values**: data to be inserted into the table.|
+ | RdbStore | insert(name:string,values:ValuesBucket):Promise<number> | Inserts a row of data into a table. This API uses a promise to return the result. If the operation is successful, the row ID will be returned; otherwise, **-1** will be returned. - **name**: name of the target table. - **values**: data to be inserted into the table.|
-- **Updating data**
+- **Updating Data**
Call the **update()** method to pass new data and specify the update conditions by using **RdbPredicates**. If the data is updated, the number of rows of the updated data will be returned; otherwise, **0** will be returned.
- **Table 3** APIs for updating data
+ **Table 3** API for updating data
| Class| API| Description|
| -------- | -------- | -------- |
- | RdbStore | update(values: ValuesBucket, rdbPredicates: RdbPredicates, callback: AsyncCallback<number>):void | Updates data in the RDB store based on the specified **RdbPredicates** object. This API uses a callback to return the result. - **values**: data to update, which is stored in a **ValuesBucket**. - **rdbPredicates**: conditions for updating data. - **callback**: callback invoked to return the number of rows updated.|
- | RdbStore | update(values: ValuesBucket, rdbPredicates: RdbPredicates): Promise\ | Updates data in the RDB store based on the specified **RdbPredicates** object. This API uses a promise to return the result. - **values**: data to update, which is stored in a **ValuesBucket**. - **rdbPredicates**: conditions for updating data.|
+ | RdbStore | update(values:ValuesBucket,rdbPredicates:RdbPredicates):Promise\ | Updates data based on the specified **RdbPredicates** object. This API uses a promise to return the result. Return value: number of rows updated. - **values**: data to update, which is stored in **ValuesBucket**. - **rdbPredicates**: conditions for updating data. |
-- **Deleting data**
+- **Deleting Data**
Call the **delete()** method to delete data meeting the conditions specified by **RdbPredicates**. If the data is deleted, the number of rows of the deleted data will be returned; otherwise, **0** will be returned.
- **Table 4** APIs for deleting data
+ **Table 4** API for deleting data
| Class| API| Description|
| -------- | -------- | -------- |
- | RdbStore | delete(rdbPredicates: RdbPredicates, callback: AsyncCallback<number>):void | Deletes data from the database based on the specified **RdbPredicates** object. This API uses a callback to return the result. - **rdbPredicates**: conditions for deleting data. - **callback**: callback invoked to return the number of rows updated.|
- | RdbStore | delete(rdbPredicates: RdbPredicates): Promise\ | Deletes data from the RDB store based on the specified **RdbPredicates** object. This API uses a promise to return the result. - **rdbPredicates**: conditions for deleting data.|
+ | RdbStore | delete(rdbPredicates:RdbPredicates):Promise\ | Deletes data from the RDB store based on the specified **RdbPredicates** object. This API uses a promise to return the result. Return value: number of rows updated. - **rdbPredicates**: conditions for deleting data. |
- **Querying data**
@@ -69,74 +64,45 @@ The RDB provides APIs for inserting, deleting, updating, and querying data in th
| Class| API| Description|
| -------- | -------- | -------- |
- | RdbStore | query(rdbPredicates: RdbPredicates, columns: Array, callback: AsyncCallback<ResultSet>): void | Queries data in the RDB store based on the specified **RdbPredicates** object. This API uses a callback to return the result. - **rdbPredicates**: conditions for querying data. - **columns**: columns to query. If this parameter is not specified, the query applies to all columns. - **callback**: callback invoked to return the result. If the operation is successful, a **ResultSet** object will be returned.|
- | RdbStore | query(rdbPredicates: RdbPredicates, columns: Array): Promise<ResultSet> | Queries data in the RDB store based on the specified **RdbPredicates** object. This API uses a promise to return the result. - **rdbPredicates**: conditions for querying data. - **columns**: columns to query. If this parameter is not specified, the query applies to all columns.|
- | RdbStore | querySql(sql: string, bindArgs: Array<ValueType>, callback: AsyncCallback<ResultSet>):void | Queries data in the RDB store using the specified SQL statement. This API uses a callback to return the result. - **sql**: SQL statement. - **bindArgs**: arguments in the SQL statement. - **callback**: callback invoked to return the result. If the operation is successful, a **ResultSet** object will be returned.|
- | RdbStore | querySql(sql: string, bindArgs?: Array<ValueType>):Promise<ResultSet> | Queries data in the RDB store using the specified SQL statement. This API uses a promise to return the result. - **sql**: SQL statement. - **bindArgs**: arguments in the SQL statement.|
+ | RdbStore | query(rdbPredicates:RdbPredicates,columns:Array):Promise<ResultSet> | Queries data from the RDB store based on specified conditions. This API uses a promise to return the result. - **rdbPredicates**: conditions for querying data. - **columns**: columns to query. If this parameter is not specified, the query applies to all columns.|
+ | RdbStore | querySql(sql:string,bindArgs?:Array<ValueType>):Promise<ResultSet> | Queries data using the specified SQL statement. This API uses a promise to return the result. - **sql**: SQL statement. - **bindArgs**: arguments in the SQL statement.|
### Using Predicates
The RDB provides **RdbPredicates** for you to set database operation conditions.
+The following lists common predicates. For more information about predicates, see [**RdbPredicates**](../reference/apis/js-apis-data-rdb.md#rdbpredicates).
+
**Table 6** APIs for using RDB store predicates
| Class| API| Description|
| -------- | -------- | -------- |
-| RdbPredicates |inDevices(devices: Array\): RdbPredicates | Specifies remote devices on the network with RDB stores to be synchronized. - **devices**: IDs of the remote devices on the network. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates |inAllDevices(): RdbPredicates | Connects to all remote devices on the network with RDB stores to be synchronized. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | equalTo(field: string, value: ValueType): RdbPredicates | Sets the **RdbPredicates** to match the field with data type **ValueType** and value equal to the specified value. - **field**: column name in the database table. - **value**: value specified. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | notEqualTo(field: string, value: ValueType): RdbPredicates | Sets the **RdbPredicates** to match the field with data type **ValueType** and value not equal to the specified value. - **field**: column name in the database table. - **value**: value specified. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | beginWrap(): RdbPredicates | Adds a left parenthesis to the **RdbPredicates**. - **RdbPredicates**: returns a **RdbPredicates** with a left parenthesis.|
-| RdbPredicates | endWrap(): RdbPredicates | Adds a right parenthesis to the **RdbPredicates**. - **RdbPredicates**: returns a **RdbPredicates** with a right parenthesis.|
-| RdbPredicates | or(): RdbPredicates | Adds the OR condition to the **RdbPredicates**. - **RdbPredicates**: returns a **RdbPredicates** with the OR condition.|
-| RdbPredicates | and(): RdbPredicates | Adds the AND condition to the **RdbPredicates**. - **RdbPredicates**: returns a **RdbPredicates** with the AND condition.|
-| RdbPredicates | contains(field: string, value: string): RdbPredicats | Sets the **RdbPredicates** to match a string containing the specified value. - **field**: column name in the database table. - **value**: value specified. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified string.|
-| RdbPredicates | beginsWith(field: string, value: string): RdbPredicates | Sets the **RdbPredicates** to match a string that starts with the specified value. - **field**: column name in the database table. - **value**: value specified. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | endsWith(field: string, value: string): RdbPredicates | Sets the **RdbPredicates** to match a string that ends with the specified value. - **field**: column name in the database table. - **value**: value specified. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | isNull(field: string): RdbPredicates | Sets the **RdbPredicates** to match the field whose value is null. - **field**: column name in the database table. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | isNotNull(field: string): RdbPredicates | Sets the **RdbPredicates** to match the field whose value is not null. - **field**: column name in the database table. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | like(field: string, value: string): RdbPredicates | Sets the **RdbPredicates** to match a string that is similar to the specified value. - **field**: column name in the database table. - **value**: value specified. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | glob(field: string, value: string): RdbPredicates | Sets the **RdbPredicates** to match the specified string. - **field**: column name in the database table. - **value**: value specified. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | between(field: string, low: ValueType, high: ValueType): RdbPredicates | Sets the **RdbPredicates** to match the field with data type **ValueType** and value within the specified range. - **field**: column name in the database table. - **low**: minimum value that matches the **RdbPredicates**. - **high**: maximum value that matches the **RdbPredicates**. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | notBetween(field: string, low: ValueType, high: ValueType): RdbPredicates | Sets the **RdbPredicates** to match the field with data type **ValueType** and value out of the specified range. - **field**: column name in the database table. - **low**: minimum value that matches the **RdbPredicates**. - **high**: maximum value that matches the **RdbPredicates**. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | greaterThan(field: string, value: ValueType): RdbPredicatesgr | Sets the **RdbPredicates** to match the field with data type **ValueType** and value greater than the specified value. - **field**: column name in the database table. - **value**: value specified. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | lessThan(field: string, value: ValueType): RdbPredicates | Sets the **RdbPredicates** to match the field with data type **ValueType** and value less than the specified value. - **field**: column name in the database table. - **value**: value specified. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | greaterThanOrEqualTo(field: string, value: ValueType): RdbPredicates | Sets the **RdbPredicates** to match the field with data type **ValueType** and value greater than or equal to the specified value. - **field**: column name in the database table. - **value**: value specified. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | lessThanOrEqualTo(field: string, value: ValueType): RdbPredicates | Sets the **RdbPredicates** to match the field with data type **ValueType** and value less than or equal to the specified value. - **field**: column name in the database table. - **value**: value specified. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | orderByAsc(field: string): RdbPredicates | Sets the **RdbPredicates** to match the column with values sorted in ascending order. - **field**: column name in the database table. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | orderByDesc(field: string): RdbPredicates | Sets the **RdbPredicates** to match the column with values sorted in descending order. - **field**: column name in the database table. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | distinct(): RdbPredicates | Sets the **RdbPredicates** to filter out duplicate records. - **RdbPredicates**: returns a **RdbPredicates** object that can filter out duplicate records.|
-| RdbPredicates | limitAs(value: number): RdbPredicates | Sets the **RdbPredicates** to specify the maximum number of records. - **value**: maximum number of records. - **RdbPredicates**: returns a **RdbPredicates** object that can be used to set the maximum number of records.|
-| RdbPredicates | offsetAs(rowOffset: number): RdbPredicates | Sets the **RdbPredicates** to specify the start position of the returned result. - **rowOffset**: start position of the returned result. The value is a positive integer. - **RdbPredicates**: returns a **RdbPredicates** object that specifies the start position of the returned result.|
-| RdbPredicates | groupBy(fields: Array<string>): RdbPredicates | Sets the **RdbPredicates** to group rows that have the same value into summary rows. - **fields**: names of the columns grouped for querying data. - **RdbPredicates**: returns a **RdbPredicates** object that groups rows with the same value.|
-| RdbPredicates | indexedBy(indexName: string): RdbPredicates | Sets the **RdbPredicates** to specify the index column. - **indexName**: name of the index column. - **RdbPredicates**: returns a **RdbPredicates** object that specifies the index column.|
-| RdbPredicates | in(field: string, value: Array<ValueType>): RdbPredicates | Sets the **RdbPredicates** to match the field with data type **Array<ValueType>** and value within the specified range. - **field**: column name in the database table. - **value**: array of **ValueType** to match. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
-| RdbPredicates | notIn(field: string, value: Array<ValueType>): RdbPredicates | Sets the **RdbPredicates** to match the field with data type **Array<ValueType>** and value out of the specified range. - **field**: column name in the database table. - **value**: array of **ValueType** to match. - **RdbPredicates**: returns a **RdbPredicates** object that matches the specified field.|
+| RdbPredicates | equalTo(field:string,value:ValueType):RdbPredicates | Sets an **RdbPredicates** to match the field with data type **ValueType** and value equal to the specified value. - **field**: column name in the database table. - **value**: value to match the **RdbPredicates**. - **RdbPredicates**: **RdbPredicates** object that matches the specified field. |
+| RdbPredicates | notEqualTo(field:string,value:ValueType):RdbPredicates | Sets an **RdbPredicates** to match the field with data type **ValueType** and value not equal to the specified value. - **field**: column name in the database table. - **value**: value to match the **RdbPredicates**. - **RdbPredicates**: **RdbPredicates** object that matches the specified field. |
+| RdbPredicates | or():RdbPredicates | Adds the OR condition to the **RdbPredicates**. - **RdbPredicates**: **RdbPredicates** with the OR condition.|
+| RdbPredicates | and():RdbPredicates | Adds the AND condition to the **RdbPredicates**. - **RdbPredicates**: **RdbPredicates** with the AND condition.|
+| RdbPredicates | contains(field:string,value:string):RdbPredicats | Sets an **RdbPredicates** to match a string that contains the specified value. - **field**: column name in the database table. - **value**: value to match the **RdbPredicates**. - **RdbPredicates**: **RdbPredicates** object that matches the specified field. |
+
### Using the Result Set
-A result set can be regarded as a row of data in the queried results. It allows you to traverse and access the data you have queried. The following table describes the external APIs of **ResultSet**.
+A result set can be regarded as a row of data in the queried results. It allows you to traverse and access the data you have queried.
->  **NOTICE**
+For details about how to use result set APIs, see [Result Set](../reference/apis/js-apis-data-resultset.md).
+
+> **NOTICE**
> After a result set is used, you must call the **close()** method to close it explicitly.
**Table 7** APIs for using the result set
| Class| API| Description|
| -------- | -------- | -------- |
-| ResultSet | goTo(offset:number): boolean | Moves the result set forwards or backwards by the specified offset relative to its current position.|
-| ResultSet | goToRow(position: number): boolean | Moves the result set to the specified row.|
-| ResultSet | goToNextRow(): boolean | Moves the result set to the next row.|
-| ResultSet | goToPreviousRow(): boolean | Moves the result set to the previous row.|
-| ResultSet | getColumnIndex(columnName: string): number | Obtains the column index based on the specified column name.|
-| ResultSet | getColumnName(columnIndex: number): string | Obtains the column name based on the specified column index.|
-| ResultSet | goToFirstRow(): boolean | Moves to the first row of the result set.|
-| ResultSet | goToLastRow(): boolean | Moves to the last row of the result set.|
-| ResultSet | getString(columnIndex: number): string | Obtains the value in the specified column of the current row, in a string.|
-| ResultSet | getBlob(columnIndex: number): Uint8Array | Obtains the values in the specified column of the current row, in a byte array.|
-| ResultSet | getDouble(columnIndex: number): number | Obtains the values in the specified column of the current row, in double.|
-| ResultSet | isColumnNull(columnIndex: number): boolean | Checks whether the value in the specified column of the current row is null.|
-| ResultSet | close(): void | Closes the result set.|
+| ResultSet | goToFirstRow():boolean | Moves to the first row of the result set.|
+| ResultSet | getString(columnIndex:number):string | Obtains the value in the form of a string based on the specified column and current row.|
+| ResultSet | getBlob(columnIndex:number):Uint8Array | Obtains the value in the form of a byte array based on the specified column and the current row.|
+| ResultSet | getDouble(columnIndex:number):number | Obtains the value in the form of double based on the specified column and current row.|
+| ResultSet | getLong(columnIndex:number):number | Obtains the value in the form of a long integer based on the specified column and current row. |
+| ResultSet | close():void | Closes the result set.|
@@ -144,32 +110,29 @@ A result set can be regarded as a row of data in the queried results. It allows
**Setting Distributed Tables**
-**Table 8** APIs for setting distributed tables
+**Table 8** API for setting distributed tables
| Class| API| Description|
| -------- | -------- | -------- |
-| RdbStore | setDistributedTables(tables: Array\, callback: AsyncCallback\): void; | Sets a list of distributed tables. This API uses a callback to return the result. - **tables**: names of the distributed tables to set. - **callback**: callback invoked to return the result.|
-| RdbStore | setDistributedTables(tables: Array\): Promise\; | Sets a list of distributed tables. This API uses a promise to return the result. - **tables**: names of the distributed tables to set.|
+| RdbStore | setDistributedTables(tables: Array\): Promise\; | Sets distributed tables. This API uses a promise to return the result. - **tables**: names of the distributed tables to set.|
**Obtaining the Distributed Table Name for a Remote Device**
You can obtain the distributed table name for a remote device based on the local table name. The distributed table name can be used to query the RDB store of the remote device.
-**Table 9** APIs for obtaining the distributed table name of a remote device
+**Table 9** API for obtaining the distributed table name of a remote device
| Class| API| Description|
| -------- | -------- | -------- |
-| RdbStore | obtainDistributedTableName(device: string, table: string, callback: AsyncCallback\): void; | Obtains the distributed table name for a remote device based on the local table name. The distributed table name is required when the database of a remote device is queried. This API uses an asynchronous callback to return the result. - **device**: remote device. - **table**: local table name. - **callback**: callback used to return the result. If the operation is successful, the distributed table name of the remote device will be returned.|
-| RdbStore | obtainDistributedTableName(device: string, table: string): Promise\; | Obtains the distributed table name for a remote device based on the local table name. The distributed table name is used to query the RDB store of the remote device. This API uses a promise to return the result. - **device**: remote device. - **table**: local table name.|
+| RdbStore | obtainDistributedTableName(device: string, table: string): Promise\; | Obtains the distributed table name for a remote device based on the local table name. The distributed table name is required when the RDB store of a remote device is queried. - **device**: remote device. - **table**: local table name.|
**Synchronizing Data Between Devices**
-**Table 10** APIs for synchronizing data between devices
+**Table 10** API for synchronizing data between devices
| Class| API| Description|
| -------- | -------- | -------- |
-| RdbStore | sync(mode: SyncMode, predicates: RdbPredicates, callback: AsyncCallback>): void;| Synchronizes data between devices. This API uses a callback to return the result. - **mode**: data synchronization mode. **SYNC_MODE_PUSH** means to push data from the local device to a remote device. **SYNC_MODE_PULL** means to pull data from a remote device to the local device. - **predicates**: data and devices to be synchronized. - **callback**: callback invoked to return the result. In the result, **string** indicates the device ID, and **number** indicates the synchronization status of each device. The value **0** indicates a success, and other values indicate a failure.|
-| RdbStore | sync(mode: SyncMode, predicates: RdbPredicates): Promise>;| Synchronizes data between devices. This API uses a promise to return the result. - **mode**: data synchronization mode. **SYNC_MODE_PUSH** means to push data from the local device to a remote device. **SYNC_MODE_PULL** means to pull data from a remote device to the local device. - **predicates**: data and devices to be synchronized. |
+| RdbStore | sync(mode: SyncMode, predicates: RdbPredicates): Promise>;| Synchronizes data between devices. This API uses a promise to return the result. - **mode**: synchronization mode. **SYNC_MODE_PUSH** means to push data from the local device to a remote device. **SYNC_MODE_PULL** means to pull data from a remote device to the local device. - **predicates**: specifies the data and devices to synchronize. - **string**: device ID. - **number**: synchronization status of that device. The value **0** indicates a successful synchronization. Other values indicate a synchronization failure. |
**Registering an RDB Store Observer**
@@ -201,7 +164,7 @@ You can obtain the distributed table name for a remote device based on the local
import data_rdb from '@ohos.data.rdb'
const CREATE_TABLE_TEST = "CREATE TABLE IF NOT EXISTS test (" + "id INTEGER PRIMARY KEY AUTOINCREMENT, " + "name TEXT NOT NULL, " + "age INTEGER, " + "salary REAL, " + "blobType BLOB)";
- const STORE_CONFIG = {name: "rdbstore.db",}
+ const STORE_CONFIG = {name: "rdbstore.db"}
data_rdb.getRdbStore(STORE_CONFIG, 1, function (err, rdbStore) {
rdbStore.executeSql(CREATE_TABLE_TEST )
console.info('create table done.')
@@ -216,7 +179,7 @@ You can obtain the distributed table name for a remote device based on the local
```js
var u8 = new Uint8Array([1, 2, 3])
- const valueBucket = {"name": "Tom", "age": 18, "salary": 100.5, "blobType": u8,}
+ const valueBucket = {"name": "Tom", "age": 18, "salary": 100.5, "blobType": u8}
let insertPromise = rdbStore.insert("test", valueBucket)
```
@@ -253,7 +216,7 @@ You can obtain the distributed table name for a remote device based on the local
promise.then(() => {
console.info("setDistributedTables success.")
}).catch((err) => {
- console.info("setDistributedTables failed.")
+ console.info("Failed to set distributed tables.")
})
```
@@ -293,7 +256,7 @@ You can obtain the distributed table name for a remote device based on the local
try {
rdbStore.on('dataChange', rdb.SubscribeType.SUBSCRIBE_TYPE_REMOTE, storeObserver)
} catch (err) {
- console.log('register observer failed')
+ console.log('Failed to register observer')
}
```
@@ -307,4 +270,3 @@ You can obtain the distributed table name for a remote device based on the local
let tableName = rdbStore.obtainDistributedTableName(deviceId, "test");
let resultSet = rdbStore.querySql("SELECT * FROM " + tableName)
```
-
diff --git a/en/application-dev/quick-start/Readme-EN.md b/en/application-dev/quick-start/Readme-EN.md
index 5236153ea7f845936ee364213f1cf2aef4326770..709c419fc08b3035c6b2060fd9445fc351b869ea 100644
--- a/en/application-dev/quick-start/Readme-EN.md
+++ b/en/application-dev/quick-start/Readme-EN.md
@@ -6,10 +6,7 @@
- [Getting Started with eTS in the Low-Code Approach](start-with-ets-low-code.md)
- [Getting Started with JavaScript in the Traditional Coding Approach](start-with-js.md)
- [Getting Started with JavaScript in the Low-Code Approach](start-with-js-low-code.md)
-
- Development Fundamentals
- [Application Package Structure Configuration File (FA Model)](package-structure.md)
- [Application Package Structure Configuration File (Stage Model)](stage-structure.md)
- - [Resource File Categories](basic-resource-file-categories.md)
- [SysCap](syscap.md)
-
diff --git a/en/application-dev/quick-start/stage-structure.md b/en/application-dev/quick-start/stage-structure.md
index 7fe24ab3c28b8b1d94aa1cd7c258a32be9f126e9..2733f0f0a7bfbeebf646813ff1395cf36babe49d 100644
--- a/en/application-dev/quick-start/stage-structure.md
+++ b/en/application-dev/quick-start/stage-structure.md
@@ -99,50 +99,6 @@ Example of the **module.json** file:
"resource": "$profile:config_file2"
}
],
- "metadata": [
- {
- "name": "string",
- "value": "string",
- "resource": "$profile:config_file1"
- },
- {
- "name": "string",
- "value": "string",
- "resource": "$profile:config_file2"
- }
- ],
- "abilities": [
- {
- "name": "MainAbility",
- "srcEntrance" : "./login/MyMainAbility.ts",
- "description": "$string:description_main_ability",
- "icon": "$media:icon",
- "label": "HiMusic",
- "visible": true,
- "skills": [
- {
- "actions": [
- "action.system.home"
- ],
- "entities": [
- "entity.system.home"
- ],
- "uris": [ ]
- }
- ],
- "backgroundModes": [
- "dataTransfer",
- "audioPlayback",
- "audioRecording",
- "location",
- "bluetoothInteraction",
- "multiDeviceConnection",
- "wifiInteraction",
- "voip",
- "taskKeeping"
- ],
- }
- ],
"abilities": [
{
"name": "MainAbility",
diff --git a/en/application-dev/reference/apis/js-apis-accessibility.md b/en/application-dev/reference/apis/js-apis-accessibility.md
index c39e6e8f9437e64b3f05f59986ec08d35170eb71..dc2c79e0058293ddd2e1a9459b1962037e591aff 100644
--- a/en/application-dev/reference/apis/js-apis-accessibility.md
+++ b/en/application-dev/reference/apis/js-apis-accessibility.md
@@ -1,6 +1,9 @@
# Accessibility
->  **NOTE**
+The **Accessibility** module implements the accessibility functions, including obtaining the accessibility application list, accessibility application enabled status, and captions configuration.
+
+> **NOTE**
+>
> The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
## Modules to Import
@@ -13,7 +16,7 @@ import accessibility from '@ohos.accessibility';
Enumerates the states of an accessibility application.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
| Name| Description|
| -------- | -------- |
@@ -25,7 +28,7 @@ Enumerates the states of an accessibility application.
Enumerates the types of accessibility applications.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
| Name| Description|
| -------- | -------- |
@@ -34,12 +37,13 @@ Enumerates the types of accessibility applications.
| haptic | The accessibility application provides haptic feedback.|
| spoken | The accessibility application provides spoken feedback.|
| visual | The accessibility application provides visual feedback.|
+| all9+ | All the preceding types.|
## AccessibilityAbilityInfo
Provides information about an accessibility application.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
### Attributes
@@ -48,6 +52,7 @@ Provides information about an accessibility application.
| id | number | Yes| No| Ability ID.|
| name | string | Yes| No| Ability name.|
| bundleName | string | Yes| No| Bundle name.|
+| targetBundleNames9+ | Array<string> | Yes| No| Name of the target bundle.|
| abilityTypes | Array<[AbilityType](#abilitytype)> | Yes| No| Accessibility application type.|
| capabilities | Array<[Capability](#capability)> | Yes| No| Capabilities list of the accessibility application.|
| description | string | Yes| No| Description of the accessibility application.|
@@ -57,7 +62,7 @@ Provides information about an accessibility application.
Describes the target action supported by an accessibility application.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
| Name| Description|
| -------- | -------- |
@@ -82,7 +87,7 @@ Describes the target action supported by an accessibility application.
Enumerates the capabilities of an auxiliary application.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
| Name| Description|
| -------- | -------- |
@@ -94,9 +99,9 @@ Enumerates the capabilities of an auxiliary application.
## CaptionsFontEdgeType8+
-Enumerates the caption font edge type.
+Enumerates the font edge types of captions.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Hearing
+**System capability**: SystemCapability.BarrierFree.Accessibility.Hearing
| Name| Description|
| -------- | -------- |
@@ -108,9 +113,9 @@ Enumerates the caption font edge type.
## CaptionsFontFamily8+
-Enumerates the caption font families.
+Enumerates the font families of captions.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Hearing
+**System capability**: SystemCapability.BarrierFree.Accessibility.Hearing
| Name| Description|
| -------- | -------- |
@@ -125,50 +130,49 @@ Enumerates the caption font families.
## CaptionsStyle8+
-Describes the caption style.
+Describes the style of captions.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Hearing
+**System capability**: SystemCapability.BarrierFree.Accessibility.Hearing
| Name| Type| Readable| Writable| Description|
| -------- | -------- | -------- | -------- | -------- |
-| fontFamily | [CaptionsFontFamily](#captionsfontfamily8) | Yes| No| Font family of the captions.|
-| fontScale | number | Yes| No| Font scale of the captions.|
-| fontColor | number \| string | Yes| No| Font color of the captions.|
-| fontEdgeType | [CaptionsFontEdgeType](#captionsfontedgetype8) | Yes| No| Font edge type of the captions.|
-| backgroundColor | number \| string | Yes| No| Background color of the captions.|
-| windowColor | number \| string | Yes| No| Window color of the captions.|
+| fontFamily | [CaptionsFontFamily](#captionsfontfamily8) | Yes| No| Font family of captions.|
+| fontScale | number | Yes| No| Font scale of captions.|
+| fontColor | number \| string | Yes| No| Font color of captions.|
+| fontEdgeType | [CaptionsFontEdgeType](#captionsfontedgetype8) | Yes| No| Font edge type of captions.|
+| backgroundColor | number \| string | Yes| No| Background color of captions.|
+| windowColor | number \| string | Yes| No| Window color of captions.|
## CaptionsManager8+
-Implements caption configuration management.
+Implements configuration management for captions.
+
+**System capability**: SystemCapability.BarrierFree.Accessibility.Hearing
### Attributes
| Name| Type| Readable| Writable| Description|
| -------- | -------- | -------- | -------- | -------- |
-| enabled | boolean | Yes| No| Whether to enable caption configuration.|
-| style | [CaptionsStyle](#captionsstyle8) | Yes| No| Caption style.|
+| enabled | boolean | Yes| No| Whether to enable captions configuration.|
+| style | [CaptionsStyle](#captionsstyle8) | Yes| No| Style of captions.|
### Methods
-In the following API examples, you must first use the [accessibility.getCaptionsManager()](#accessibilitygetcaptionsmanager8) method to obtain a **captionsManager** instance, and then call the methods using the obtained instance.
-
+In the following API examples, you must first use the [accessibility.getCaptionsManager()](#accessibilitygetcaptionsmanager8) API to obtain a **captionsManager** instance, and then call the methods using the obtained instance.
#### on('enableChange')
on(type: 'enableChange', callback: Callback<boolean>): void;
-Enables listening for enable status changes of caption configuration.
-
-**System capability**: SystemCapability.Barrierfree.Accessibility.Hearing
+Enables listening for enabled status changes of captions configuration.
- **Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| type | string | Yes| Type of the event to listen for, which is set to **enableChange** in this API.|
- | callback | Callback<boolean> | Yes| Callback invoked when the enable status of caption configuration changes.|
+ | callback | Callback<boolean> | Yes| Callback invoked when the enabled status of captions configuration changes.|
-- Example
+- **Example**
```typescript
captionsManager.on('enableChange',(data) => {
@@ -180,18 +184,16 @@ Enables listening for enable status changes of caption configuration.
on(type: 'styleChange', callback: Callback<CaptionsStyle>): void;
-Enables listening for caption style changes.
-
-**System capability**: SystemCapability.Barrierfree.Accessibility.Hearing
+Enables listening for captions style changes.
- **Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| type | string | Yes| Type of the event to listen for, which is set to **styleChange** in this API.|
- | callback | Callback<[CaptionsStyle](#captionsstyle8)> | Yes| Callback invoked when the caption style changes.|
+ | callback | Callback<[CaptionsStyle](#captionsstyle8)> | Yes| Callback invoked when the style of captions changes.|
-- Example
+- **Example**
```typescript
captionsManager.on('styleChange',(data) => {
@@ -203,18 +205,16 @@ Enables listening for caption style changes.
off(type: 'enableChange', callback?: Callback<boolean>): void;
-Disables listening for enable status changes of caption configuration.
-
-**System capability**: SystemCapability.Barrierfree.Accessibility.Hearing
+Disables listening for enabled status changes of captions configuration.
- **Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| type | string | Yes| Type of the event to listen for, which is set to **enableChange** in this API.|
- | callback | Callback<boolean> | No| Callback invoked when the enable status of caption configuration changes.|
+ | callback | Callback<boolean> | No| Callback invoked when the enabled status of captions configuration changes.|
-- Example
+- **Example**
```typescript
captionsManager.off('enableChange')
@@ -224,18 +224,16 @@ Disables listening for enable status changes of caption configuration.
off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void;
-Disables listening for caption style changes.s is removed.
-
-**System capability**: SystemCapability.Barrierfree.Accessibility.Hearing
+Disables listening for captions style changes.
- **Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| type | string | Yes| Type of the event to listen for, which is set to **styleChange** in this API.|
- | callback | Callback<[CaptionsStyle](#captionsstyle8)> | No| Callback invoked when the caption style changes.|
+ | callback | Callback<[CaptionsStyle](#captionsstyle8)> | No| Callback invoked when the style of captions changes.|
-- Example
+- **Example**
```typescript
captionsManager.off('styleChange')
@@ -245,7 +243,7 @@ Disables listening for caption style changes.s is removed.
Describes a GUI change event.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
### Attributes
@@ -270,7 +268,7 @@ Describes a GUI change event.
Enumerates accessibility event types.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
| Name| Description|
| -------- | -------- |
@@ -290,7 +288,7 @@ Enumerates accessibility event types.
Enumerates the movement units for traversing the node text.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
| Name| Description|
| -------- | -------- |
@@ -304,7 +302,7 @@ Enumerates the movement units for traversing the node text.
Enumerates window update types.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
| Name| Description|
| -------- | -------- |
@@ -326,7 +324,7 @@ getAbilityLists(abilityType: AbilityType, stateType: AbilityState): Promise<A
Obtains the accessibility application list. This API uses a promise to return the result.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
- **Parameters**
@@ -335,13 +333,13 @@ Obtains the accessibility application list. This API uses a promise to return th
| abilityType | [AbilityType](#abilitytype) | Yes| Accessibility application type.|
| stateType | [AbilityState](#abilitystate) | Yes| Accessibility application status.|
-- Return value
+- **Return value**
| Type| Description|
| -------- | -------- |
| Promise<Array<[AccessibilityAbilityInfo](#accessibilityabilityinfo)>> | Promise used to return the accessibility application list.|
-- Example
+- **Example**
```typescript
accessibility.getAbilityLists("spoken", "enable")
@@ -369,7 +367,7 @@ getAbilityLists(abilityType: AbilityType, stateType: AbilityState,callback: Asyn
Obtains the accessibility application list. This API uses an asynchronous callback to return the result.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
- **Parameters**
@@ -379,7 +377,7 @@ Obtains the accessibility application list. This API uses an asynchronous callba
| stateType | [AbilityState](#abilitystate) | Yes| Accessibility application status.|
| callback | AsyncCallback<Array<[AccessibilityAbilityInfo](#accessibilityabilityinfo)>> | Yes| Callback used to return the accessibility application list.|
-- Example
+- **Example**
```typescript
accessibility.getAbilityLists("visual", "enable", (err, data) => {
@@ -406,17 +404,17 @@ Obtains the accessibility application list. This API uses an asynchronous callba
getCaptionsManager(): CaptionsManager
-Obtains the accessibility caption configuration.
+Obtains the captions configuration.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Hearing
+**System capability**: SystemCapability.BarrierFree.Accessibility.Hearing
-- Return value
+- **Return value**
| Type| Description|
| -------- | -------- |
- | [CaptionsManager](#captionsmanager8) | Accessibility caption configuration.|
+ | [CaptionsManager](#captionsmanager8) | Captions configuration.|
-- Example
+- **Example**
```typescript
captionsManager = accessibility.getCaptionsManager()
@@ -432,10 +430,10 @@ Enables listening for the accessibility application or touch guide mode status c
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
- | type | string | Yes| Type of the event to listen for. - **accessibilityStateChange** means to listen for enable status changes of the accessibility application. **System capability**: SystemCapability.Barrierfree.Accessibility.Core - **touchGuideStateChange** means to listen for enable status changes of the touch guide mode. **System capability**: SystemCapability.Barrierfree.Accessibility.Vision|
- | callback | Callback<boolean> | Yes| Callback invoked when the enable status changes.|
+ | type | string | Yes| Type of the event to listen for. - **'accessibilityStateChange'** means to listen for enabled status changes of the accessibility application. **System capability**: SystemCapability.BarrierFree.Accessibility.Core - **'touchGuideStateChange'** means to listen for enabled status changes of the touch guide mode. **System capability**: SystemCapability.BarrierFree.Accessibility.Vision|
+ | callback | Callback<boolean> | Yes| Callback invoked when the enabled status of captions configuration changes.|
-- Example
+- **Example**
```typescript
accessibility.on('accessibilityStateChange',(data) => {
@@ -447,18 +445,16 @@ Enables listening for the accessibility application or touch guide mode status c
off(type: 'accessibilityStateChange ' | 'touchGuideStateChange', callback?: Callback<boolean>): void
-Disables listening for the accessibility application or touch guide mode status changes.
-
-
+Disables listening for the accessibility application or touch guide mode status changes.
- **Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
- | type | string | No| Type of the event to listen for. - **accessibilityStateChange** means to listen for enable status changes of the accessibility application. **System capability**: SystemCapability.Barrierfree.Accessibility.Core - **touchGuideStateChange** means to listen for enable status changes of the touch guide mode. **System capability**: SystemCapability.Barrierfree.Accessibility.Vision|
- | callback | Callback<boolean> | No| Callback invoked when the enable status changes.|
+ | type | string | No| Type of the event to listen for. - **'accessibilityStateChange'** means to listen for enabled status changes of the accessibility application. **System capability**: SystemCapability.BarrierFree.Accessibility.Core - **'touchGuideStateChange'** means to listen for enabled status changes of the touch guide mode. **System capability**: SystemCapability.BarrierFree.Accessibility.Vision|
+ | callback | Callback<boolean> | No| Callback invoked when the enabled status changes.|
-- Example
+- **Example**
```typescript
accessibility.off('accessibilityStateChange',(data) => {
@@ -472,15 +468,15 @@ isOpenAccessibility(): Promise<boolean>
Checks whether accessibility is enabled. This API uses a promise to return the result.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
-- Return value
+- **Return value**
| Type| Description|
| -------- | -------- |
| Promise<boolean> | Returns **true** if accessibility is enabled; returns **false** otherwise.|
-- Example
+- **Example**
```typescript
accessibility.isOpenAccessibility()
@@ -497,15 +493,15 @@ isOpenAccessibility(callback: AsyncCallback<boolean>): void
Checks whether accessibility is enabled. This API uses an asynchronous callback to return the result.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
-- Parameters
+- **Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. Returns **true** if accessibility is enabled; returns **false** otherwise.|
-- Example
+- **Example**
```typescript
accessibility.isOpenAccessibility((err, data) => {
@@ -523,15 +519,15 @@ isOpenTouchGuide(): Promise<boolean>
Checks whether touch guide mode is enabled. This API uses a promise to return the result.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Vision
-- Return value
+- **Return value**
| Type| Description|
| -------- | -------- |
| Promise<boolean> | Returns **true** if touch guide mode is enabled; returns **false** otherwise.|
-- Example
+- **Example**
```typescript
accessibility.isOpenTouchGuide()
@@ -548,15 +544,15 @@ isOpenTouchGuide(callback: AsyncCallback<boolean>): void
Checks whether touch guide mode is enabled. This API uses an asynchronous callback to return the result.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Vision
-- Parameters
+- **Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. Returns **true** if touch guide mode is enabled; returns **false** otherwise.|
-- Example
+- **Example**
```typescript
accessibility.isOpenTouchGuide((err, data) => {
@@ -574,7 +570,7 @@ sendEvent(event: EventInfo): Promise<void>
Sends an accessibility event. This API uses a promise to return the result.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
- **Parameters**
@@ -582,13 +578,13 @@ Sends an accessibility event. This API uses a promise to return the result.
| -------- | -------- | -------- | -------- |
| event | [EventInfo](#eventinfo) | Yes| Accessibility event.|
-- Return value
+- **Return value**
| Type| Description|
| -------- | -------- |
| Promise<void> | Promise used to return the result. Returns data if the accessibility event is sent successfully; returns an error otherwise.|
-- Example
+- **Example**
```typescript
accessibility.sendEvent(this.eventInfo)
@@ -605,7 +601,7 @@ sendEvent(event: EventInfo, callback: AsyncCallback<void>): void
Sends an accessibility event. This API uses an asynchronous callback to return the result.
-**System capability**: SystemCapability.Barrierfree.Accessibility.Core
+**System capability**: SystemCapability.BarrierFree.Accessibility.Core
- **Parameters**
@@ -614,7 +610,7 @@ Sends an accessibility event. This API uses an asynchronous callback to return t
| event | [EventInfo](#eventinfo) | Yes| Accessibility event.|
| callback | AsyncCallback<void> | Yes| Callback used to return the result. Returns data if the accessibility event is sent successfully; returns an error otherwise.|
-- Example
+- **Example**
```typescript
accessibility.sendEvent(this.eventInfo,(err, data) => {
diff --git a/en/application-dev/reference/apis/js-apis-data-rdb.md b/en/application-dev/reference/apis/js-apis-data-rdb.md
index 4c2ca88c5439546097f53460099297a0bbf5049c..1b17be0e8011b117e821248ce9bd0c07d1165d47 100644
--- a/en/application-dev/reference/apis/js-apis-data-rdb.md
+++ b/en/application-dev/reference/apis/js-apis-data-rdb.md
@@ -4,10 +4,10 @@ The relational database (RDB) manages data based on relational models. With the
This module provides the following RDB-related functions:
-- [RdbPredicates](#rdbpredicates): predicates indicating the nature, feature, or relationship of a data entity in an RDB store. It is used to define the operation conditions for an RDB store.
+- [RdbPredicates](#rdbpredicates): provides predicates indicating the nature, feature, or relationship of a data entity in an RDB store. It is used to define the operation conditions for an RDB store.
- [RdbStore](#rdbstore): provides APIs for managing an RDB store.
-> **NOTE**
+> **NOTE**
>
> The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
@@ -51,7 +51,7 @@ data_rdb.getRdbStore(this.context, STORE_CONFIG, 1, function (err, rdbStore) {
getRdbStore(context: Context, config: StoreConfig, version: number): Promise<RdbStore>
-Obtains an RDB store. This API uses a promise to return the result. You can set parameters for the RDB store based on service requirements and call APIs to perform data operations.
+Obtains an RDB store. This API uses a promise to return the result. You can set parameters for the RDB store based on service requirements, and then call APIs to perform data operations.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -85,7 +85,7 @@ promise.then(async (rdbStore) => {
deleteRdbStore(context: Context, name: string, callback: AsyncCallback<void>): void
-Deletes an RDB store. This API uses an asynchronous callback to return the result.
+Deletes an RDB store. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -166,14 +166,14 @@ let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
inDevices(devices: Array<string>): RdbPredicates
-Specifies a remote device on the network during distributed database synchronization.
+Connects to the specified remote devices on the network during distributed database synchronization.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
-| devices | Array<string> | Yes| ID of the remote device to specify.|
+| devices | Array<string> | Yes| IDs of the remote devices in the same network.|
**Return value**
| Type| Description|
@@ -211,7 +211,7 @@ predicates.inAllDevices()
equalTo(field: string, value: ValueType): RdbPredicates
-Sets the **RdbPredicates** to match the field with data type **ValueType** and value equal to the specified value.
+Sets an **RdbPredicates** to match the field with data type **ValueType** and value equal to the specified value.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -238,7 +238,7 @@ predicates.equalTo("NAME", "lisi")
notEqualTo(field: string, value: ValueType): RdbPredicates
-Sets the **RdbPredicates** to match the field with data type **ValueType** and value not equal to the specified value.
+Sets an **RdbPredicates** to match the field with data type **ValueType** and value not equal to the specified value.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -362,7 +362,7 @@ predicates.equalTo("NAME", "Lisa")
contains(field: string, value: string): RdbPredicates
-Sets the **RdbPredicates** to match a string containing the specified value.
+Sets an **RdbPredicates** to match a string containing the specified value.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -389,7 +389,7 @@ predicates.contains("NAME", "os")
beginsWith(field: string, value: string): RdbPredicates
-Sets the **RdbPredicates** to match a string that starts with the specified value.
+Sets an **RdbPredicates** to match a string that starts with the specified value.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -416,7 +416,7 @@ predicates.beginsWith("NAME", "os")
endsWith(field: string, value: string): RdbPredicates
-Sets the **RdbPredicates** to match a string that ends with the specified value.
+Sets an **RdbPredicates** to match a string that ends with the specified value.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -443,7 +443,7 @@ predicates.endsWith("NAME", "se")
isNull(field: string): RdbPredicates
-Sets the **RdbPredicates** to match the field whose value is null.
+Sets an **RdbPredicates** to match the field whose value is null.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -469,7 +469,7 @@ predicates.isNull("NAME")
isNotNull(field: string): RdbPredicates
-Sets the **RdbPredicates** to match the field whose value is not null.
+Sets an **RdbPredicates** to match the field whose value is not null.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -495,7 +495,7 @@ predicates.isNotNull("NAME")
like(field: string, value: string): RdbPredicates
-Sets the **RdbPredicates** to match a string that is similar to the specified value.
+Sets an **RdbPredicates** to match a string that is similar to the specified value.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -522,7 +522,7 @@ predicates.like("NAME", "%os%")
glob(field: string, value: string): RdbPredicates
-Sets the **RdbPredicates** to match the specified string.
+Sets an **RdbPredicates** to match the specified string.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -549,7 +549,7 @@ predicates.glob("NAME", "?h*g")
between(field: string, low: ValueType, high: ValueType): RdbPredicates
-Sets the **RdbPredicates** to match the field with data type **ValueType** and value within the specified range.
+Sets an **RdbPredicates** to match the field with data type **ValueType** and value within the specified range.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -577,7 +577,7 @@ predicates.between("AGE", 10, 50)
notBetween(field: string, low: ValueType, high: ValueType): RdbPredicates
-Sets the **RdbPredicates** to match the field with data type **ValueType** and value out of the specified range.
+Sets an **RdbPredicates** to match the field with data type **ValueType** and value out of the specified range.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -604,7 +604,7 @@ predicates.notBetween("AGE", 10, 50)
greaterThan(field: string, value: ValueType): RdbPredicates
-Sets the **RdbPredicates** to match the field with data type **ValueType** and value greater than the specified value.
+Sets an **RdbPredicates** to match the field with data type **ValueType** and value greater than the specified value.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -631,7 +631,7 @@ predicates.greaterThan("AGE", 18)
lessThan(field: string, value: ValueType): RdbPredicates
-Sets the **RdbPredicates** to match the field with data type **ValueType** and value less than the specified value.
+Sets an **RdbPredicates** to match the field with data type **ValueType** and value less than the specified value.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -659,7 +659,7 @@ predicates.lessThan("AGE", 20)
greaterThanOrEqualTo(field: string, value: ValueType): RdbPredicates
-Sets the **RdbPredicates** to match the field with data type **ValueType** and value greater than or equal to the specified value.
+Sets an **RdbPredicates** to match the field with data type **ValueType** and value greater than or equal to the specified value.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -687,7 +687,7 @@ predicates.greaterThanOrEqualTo("AGE", 18)
lessThanOrEqualTo(field: string, value: ValueType): RdbPredicates
-Sets the **RdbPredicates** to match the field with data type **ValueType** and value less than or equal to the specified value.
+Sets an **RdbPredicates** to match the field with data type **ValueType** and value less than or equal to the specified value.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -715,7 +715,7 @@ predicates.lessThanOrEqualTo("AGE", 20)
orderByAsc(field: string): RdbPredicates
-Sets the **RdbPredicates** to match the column with values sorted in ascending order.
+Sets an **RdbPredicates** to match the column with values sorted in ascending order.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -742,7 +742,7 @@ predicates.orderByAsc("NAME")
orderByDesc(field: string): RdbPredicates
-Sets the **RdbPredicates** to match the column with values sorted in descending order.
+Sets an **RdbPredicates** to match the column with values sorted in descending order.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -768,7 +768,7 @@ predicates.orderByDesc("AGE")
distinct(): RdbPredicates
-Sets the **RdbPredicates** to filter out duplicate records.
+Sets an **RdbPredicates** to filter out duplicate records.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -796,7 +796,7 @@ promise.then((resultSet) => {
limitAs(value: number): RdbPredicates
-Sets the **RdbPredicates** to specify the maximum number of records.
+Sets an **RdbPredicates** to specify the maximum number of records.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -822,7 +822,7 @@ predicates.equalTo("NAME", "Rose").limitAs(3)
offsetAs(rowOffset: number): RdbPredicates
-Sets the **RdbPredicates** to specify the start position of the returned result.
+Sets an **RdbPredicates** to specify the start position of the returned result.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -848,7 +848,7 @@ predicates.equalTo("NAME", "Rose").offsetAs(3)
groupBy(fields: Array<string>): RdbPredicates
-Sets the **RdbPredicates** to group rows that have the same value into summary rows.
+Sets an **RdbPredicates** to group rows that have the same value into summary rows.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -873,7 +873,7 @@ predicates.groupBy(["AGE", "NAME"])
indexedBy(field: string): RdbPredicates
-Sets the **RdbPredicates** object to specify the index column.
+Sets an **RdbPredicates** object to specify the index column.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -900,7 +900,7 @@ predicates.indexedBy("SALARY_INDEX")
in(field: string, value: Array<ValueType>): RdbPredicates
-Sets the **RdbPredicates** to match the field with data type **Array<ValueType>** and value within the specified range.
+Sets an **RdbPredicates** to match the field with data type **Array<ValueType>** and value within the specified range.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -928,7 +928,7 @@ predicates.in("AGE", [18, 20])
notIn(field: string, value: Array<ValueType>): RdbPredicates
-Sets the **RdbPredicates** to match the field with data type **Array<ValueType>** and value out of the specified range.
+Sets an **RdbPredicates** to match the field with data type **Array<ValueType>** and value out of the specified range.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -955,6 +955,8 @@ predicates.notIn("NAME", ["Lisa", "Rose"])
Provides methods to manage an RDB store.
+Before using the following APIs, use [executeSql](#executesql) to initialize the database table structure and related data. For details, see [RDB Development](../../database/database-relational-guidelines.md).
+
### insert
@@ -984,7 +986,7 @@ rdbStore.insert("EMPLOYEE", valueBucket, function (err, ret) {
console.info("Failed to insert data, err: " + err)
return
}
- console.log("Insert first done: " + ret)
+ console.log("Inserted first row: " + ret)
})
```
@@ -1018,7 +1020,7 @@ const valueBucket = {
}
let promise = rdbStore.insert("EMPLOYEE", valueBucket)
promise.then(async (ret) => {
- console.log("Insert first done: " + ret)
+ console.log("Inserted first row: " + ret)
}).catch((err) => {
console.log("Failed to insert data, err: " + err)
})
@@ -1029,7 +1031,7 @@ promise.then(async (ret) => {
update(values: ValuesBucket, rdbPredicates: RdbPredicates, callback: AsyncCallback<number>):void
-Updates data in the database based on the specified RdbPredicates object. This API uses an asynchronous callback to return the result.
+Updates data in the RDB store based on the specified **RdbPredicates** object. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -1037,7 +1039,7 @@ Updates data in the database based on the specified RdbPredicates object. This A
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| values | [ValuesBucket](#valuesbucket) | Yes| Data to update. The value specifies the row of data to be updated in the database. The key-value pair is associated with the column name in the target table.|
-| rdbPredicates | [RdbPredicates](#rdbpredicates) | Yes| Row of data to insert.|
+| rdbPredicates | [RdbPredicates](#rdbpredicates) | Yes| Update conditions specified by the **RdbPredicates** object.|
| callback | AsyncCallback<number> | Yes| Callback invoked to return the number of rows updated.|
**Example**
@@ -1064,7 +1066,7 @@ rdbStore.update(valueBucket, predicates, function (err, ret) {
update(values: ValuesBucket, rdbPredicates: RdbPredicates):Promise<number>
-Updates data in the database based on the specified RdbPredicates object. This API uses a promise to return the result.
+Updates data in the RDB store based on the specified **RdbPredicates** object. This API uses a promise to return the result.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -1072,7 +1074,7 @@ Updates data in the database based on the specified RdbPredicates object. This A
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| values | [ValuesBucket](#valuesbucket) | Yes| Data to update. The value specifies the row of data to be updated in the database. The key-value pair is associated with the column name in the target table.|
-| rdbPredicates | [RdbPredicates](#rdbpredicates) | Yes| Row of data to insert.|
+| rdbPredicates | [RdbPredicates](#rdbpredicates) | Yes| Update conditions specified by the **RdbPredicates** object.|
**Return value**
| Type| Description|
@@ -1103,7 +1105,7 @@ promise.then(async (ret) => {
delete(rdbPredicates: RdbPredicates, callback: AsyncCallback<number>):void
-Deletes data from the database based on the specified **RdbPredicates** object. This API uses a callback to return the result.
+Deletes data from the RDB store based on the specified **RdbPredicates** object. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -1122,7 +1124,7 @@ rdbStore.delete(predicates, function (err, rows) {
console.info("Failed to delete data, err: " + err)
return
}
- console.log("Delete rows: " + rows)
+ console.log("Deleted rows: " + rows)
})
```
@@ -1131,7 +1133,7 @@ rdbStore.delete(predicates, function (err, rows) {
delete(rdbPredicates: RdbPredicates):Promise<number>
-Deletes data from the database based on the specified **RdbPredicates** object. This API uses a promise to return the result.
+Deletes data from the RDB store based on the specified **RdbPredicates** object. This API uses a promise to return the result.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -1151,7 +1153,7 @@ let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Lisa")
let promise = rdbStore.delete(predicates)
promise.then((rows) => {
- console.log("Delete rows: " + rows)
+ console.log("Deleted rows: " + rows)
}).catch((err) => {
console.info("Failed to delete data, err: " + err)
})
@@ -1162,7 +1164,7 @@ promise.then((rows) => {
query(rdbPredicates: RdbPredicates, columns: Array<string>, callback: AsyncCallback<ResultSet>):void
-Queries data in the database based on specified conditions. This API uses an asynchronous callback to return the result.
+Queries data in the RDB store based on specified conditions. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -1192,7 +1194,7 @@ rdbStore.query(predicates, ["ID", "NAME", "AGE", "SALARY", "CODES"], function (e
query(rdbPredicates: RdbPredicates, columns?: Array<string>):Promise<ResultSet>
-Queries data in the database based on specified conditions. This API uses a promise to return the result.
+Queries data in the RDB store based on specified conditions. This API uses a promise to return the result.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -1205,7 +1207,7 @@ Queries data in the database based on specified conditions. This API uses a prom
**Return value**
| Type| Description|
| -------- | -------- |
-| Promise<[ResultSet](../apis/js-apis-data-resultset.md)> | Promise used to return the result. If the operation is successful, a **ResultSet** object will be returned.|
+| Promise<[ResultSet](js-apis-data-resultset.md)> | Promise used to return the result. If the operation is successful, a **ResultSet** object will be returned.|
**Example**
```js
@@ -1233,7 +1235,7 @@ Queries data in the RDB store using the specified SQL statement. This API uses a
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| sql | string | Yes| SQL statement to run.|
-| bindArgs | Array<[ValueType](#valuetype)> | Yes| Values of the parameters in the SQL statement.|
+| bindArgs | Array<[ValueType](#valuetype)> | Yes| Arguments in the SQL statement.|
| callback | AsyncCallback<[ResultSet](js-apis-data-resultset.md)> | Yes| Callback invoked to return the result. If the operation is successful, a **ResultSet** object will be returned.|
**Example**
@@ -1261,12 +1263,12 @@ Queries data in the RDB store using the specified SQL statement. This API uses a
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| sql | string | Yes| SQL statement to run.|
-| bindArgs | Array<[ValueType](#valuetype)> | No| Values of the parameters in the SQL statement.|
+| bindArgs | Array<[ValueType](#valuetype)> | No| Arguments in the SQL statement.|
**Return value**
| Type| Description|
| -------- | -------- |
-| Promise<[ResultSet](../apis/js-apis-data-resultset.md)> | Promise used to return the result. If the operation is successful, a **ResultSet** object will be returned.|
+| Promise<[ResultSet](js-apis-data-resultset.md)> | Promise used to return the result. If the operation is successful, a **ResultSet** object will be returned.|
**Example**
```js
@@ -1292,7 +1294,7 @@ Runs the SQL statement that contains the specified parameters but does not retur
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| sql | string | Yes| SQL statement to run.|
-| bindArgs | Array<[ValueType](#valuetype)> | Yes| Values of the parameters in the SQL statement.|
+| bindArgs | Array<[ValueType](#valuetype)> | Yes| Arguments in the SQL statement.|
| callback | AsyncCallback<void> | Yes| Callback invoked to return the result.|
**Example**
@@ -1303,7 +1305,7 @@ rdbStore.executeSql(SQL_CREATE_TABLE, null, function(err) {
console.info("Failed to execute SQL, err: " + err)
return
}
- console.info('create table done.')
+ console.info('Created table successfully.')
})
```
@@ -1320,7 +1322,7 @@ Runs the SQL statement that contains the specified parameters but does not retur
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| sql | string | Yes| SQL statement to run.|
-| bindArgs | Array<[ValueType](#valuetype)> | No| Values of the parameters in the SQL statement.|
+| bindArgs | Array<[ValueType](#valuetype)> | No| Arguments in the SQL statement.|
**Return value**
| Type| Description|
@@ -1332,7 +1334,7 @@ Runs the SQL statement that contains the specified parameters but does not retur
const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)"
let promise = rdbStore.executeSql(SQL_CREATE_TABLE)
promise.then(() => {
- console.info('create table done.')
+ console.info('Created table successfully.')
}).catch((err) => {
console.info("Failed to execute SQL, err: " + err)
})
@@ -1449,7 +1451,7 @@ rdbStore.setDistributedTables(["EMPLOYEE"], function (err) {
console.info('Failed to set distributed tables, err: ' + err)
return
}
- console.info('setDistributedTables successfully.')
+ console.info('Set distributed tables successfully.')
})
```
@@ -1476,7 +1478,7 @@ Sets a list of distributed tables. This API uses a promise to return the result.
```js
let promise = rdbStore.setDistributedTables(["EMPLOYEE"])
promise.then(() => {
- console.info("setDistributedTables successfully.")
+ console.info("Set distributed tables successfully.")
}).catch((err) => {
console.info('Failed to set distributed tables, err: ' + err)
})
@@ -1486,7 +1488,7 @@ promise.then(() => {
obtainDistributedTableName(device: string, table: string, callback: AsyncCallback<string>): void
-Obtains the distributed table name for a remote device based on the local table name. The distributed table name is required when the database of a remote device is queried. This API uses an asynchronous callback to return the result.
+Obtains the distributed table name for a remote device based on the local table name. This API uses an asynchronous callback to return the result. The distributed table name is required when the database of a remote device is queried.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -1504,7 +1506,7 @@ rdbStore.obtainDistributedTableName("12345678abcde", "EMPLOYEE", function (err,
console.info('Failed to obtain DistributedTableName, err: ' + err)
return
}
- console.info('obtainDistributedTableName successfully, tableName=.' + tableName)
+ console.info('Obtained DistributedTableName successfully, tableName=.' + tableName)
})
```
@@ -1513,7 +1515,7 @@ rdbStore.obtainDistributedTableName("12345678abcde", "EMPLOYEE", function (err,
obtainDistributedTableName(device: string, table: string): Promise<string>
-Obtains the distributed table name for a remote device based on the local table name. The distributed table name is required when the database of a remote device is queried. This API uses a promise to return the result.
+Obtains the distributed table name for a remote device based on the local table name. This API uses a promise to return the result. The distributed table name is used to query the RDB store of the remote device.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -1532,7 +1534,7 @@ Obtains the distributed table name for a remote device based on the local table
```js
let promise = rdbStore.obtainDistributedTableName("12345678abcde", "EMPLOYEE")
promise.then((tableName) => {
- console.info('obtainDistributedTableName successfully, tableName=' + tableName)
+ console.info('Obtained DistributedTableName successfully, tableName=' + tableName)
}).catch((err) => {
console.info('Failed to obtain DistributedTableName, err: ' + err)
})
@@ -1551,7 +1553,7 @@ Synchronizes data between devices. This API uses an asynchronous callback to ret
| -------- | -------- | -------- | -------- |
| mode | [SyncMode](#syncmode8) | Yes| Data synchronization mode. The value can be **push** or **pull**.|
| predicates | [RdbPredicates](#rdbpredicates) | Yes| **RdbPredicates** object that specifies the data and devices to synchronize.|
-| callback | AsyncCallback<Array<[string, number]>> | Yes| Callback invoked to send the synchronization result to the caller. **string** indicates the device ID. **number** indicates the synchronization status of each device. The value **0** indicates a successful synchronization. Other values indicate a synchronization failure. |
+| callback | AsyncCallback<Array<[string, number]>> | Yes| Callback invoked to send the synchronization result to the caller. **string** indicates the device ID. **number** indicates the synchronization status of that device. The value **0** indicates a successful synchronization. Other values indicate a synchronization failure. |
**Example**
```js
@@ -1588,7 +1590,7 @@ Synchronizes data between devices. This API uses a promise to return the result.
| Type| Description|
| -------- | -------- |
-| Promise<Array<[string, number]>> | Promise used to return the synchronization result to the caller. **string** indicates the device ID. **number** indicates the synchronization status of each device. The value **0** indicates a successful synchronization. Other values indicate a synchronization failure. |
+| Promise<Array<[string, number]>> | Promise used to return the synchronization result to the caller. **string** indicates the device ID. **number** indicates the synchronization status of that device. The value **0** indicates a successful synchronization. Other values indicate a synchronization failure. |
**Example**
```js
@@ -1639,7 +1641,7 @@ try {
off(event:'dataChange', type: SubscribeType, observer: Callback<Array<string>>): void
-Deletes the specified observer of the RDB store. This API uses a callback to return the result.
+Unregisters the specified observer of the RDB store. This API uses a callback to return the result.
**System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core
@@ -1697,7 +1699,7 @@ Defines the types of the key and value in a KV pair.
| Key Type| Value Type|
| -------- | -------- |
-| string | [ValueType](#valuetype)\| Uint8Array \| null |
+| string | [ValueType](#valuetype)\| Uint8Array \| null |
## SyncMode8+
diff --git a/en/application-dev/reference/arkui-js/Readme-EN.md b/en/application-dev/reference/arkui-js/Readme-EN.md
index f0b0e7b6c9d76f3380dd78f21c92108c969f9e77..a34f071f9db1d0b438bfad4ac0461ef2ef7e0b25 100644
--- a/en/application-dev/reference/arkui-js/Readme-EN.md
+++ b/en/application-dev/reference/arkui-js/Readme-EN.md
@@ -1,110 +1,103 @@
# JavaScript-based Web-like Development Paradigm
-- Components
- - Common
- - [Universal Attributes](js-components-common-attributes.md)
- - [Universal Styles](js-components-common-styles.md)
- - [Universal Events](js-components-common-events.md)
- - [Universal Methods](js-components-common-methods.md)
- - [Animation Styles](js-components-common-animation.md)
- - [Gradient Styles](js-components-common-gradient.md)
- - [Transition Styles](js-components-common-transition.md)
- - [Media Query](js-components-common-mediaquery.md)
- - [Custom Font Styles](js-components-common-customizing-font.md)
- - [Atomic Layout](js-components-common-atomic-layout.md)
+- Universal Component Information
+ - [Universal Attributes](js-components-common-attributes.md)
+ - [Universal Styles](js-components-common-styles.md)
+ - [Universal Events](js-components-common-events.md)
+ - [Universal Methods](js-components-common-methods.md)
+ - [Animation Styles](js-components-common-animation.md)
+ - [Gradient Styles](js-components-common-gradient.md)
+ - [Transition Styles](js-components-common-transition.md)
+ - [Media Query](js-components-common-mediaquery.md)
+ - [Custom Font Styles](js-components-common-customizing-font.md)
+ - [Atomic Layout](js-components-common-atomic-layout.md)
+- Container Components
+ - [badge](js-components-container-badge.md)
+ - [dialog](js-components-container-dialog.md)
+ - [div](js-components-container-div.md)
+ - [form](js-components-container-form.md)
+ - [list](js-components-container-list.md)
+ - [list-item](js-components-container-list-item.md)
+ - [list-item-group](js-components-container-list-item-group.md)
+ - [panel](js-components-container-panel.md)
+ - [popup](js-components-container-popup.md)
+ - [refresh](js-components-container-refresh.md)
+ - [stack](js-components-container-stack.md)
+ - [stepper](js-components-container-stepper.md)
+ - [stepper-item](js-components-container-stepper-item.md)
+ - [swiper](js-components-container-swiper.md)
+ - [tabs](js-components-container-tabs.md)
+ - [tab-bar](js-components-container-tab-bar.md)
+ - [tab-content](js-components-container-tab-content.md)
+- Basic Components
+ - [button](js-components-basic-button.md)
+ - [chart](js-components-basic-chart.md)
+ - [divider](js-components-basic-divider.md)
+ - [image](js-components-basic-image.md)
+ - [image-animator](js-components-basic-image-animator.md)
+ - [input](js-components-basic-input.md)
+ - [label](js-components-basic-label.md)
+ - [marquee](js-components-basic-marquee.md)
+ - [menu](js-components-basic-menu.md)
+ - [option](js-components-basic-option.md)
+ - [picker](js-components-basic-picker.md)
+ - [picker-view](js-components-basic-picker-view.md)
+ - [piece](js-components-basic-piece.md)
+ - [progress](js-components-basic-progress.md)
+ - [qrcode](js-components-basic-qrcode.md)
+ - [rating](js-components-basic-rating.md)
+ - [richtext](js-components-basic-richtext.md)
+ - [search](js-components-basic-search.md)
+ - [select](js-components-basic-select.md)
+ - [slider](js-components-basic-slider.md)
+ - [span](js-components-basic-span.md)
+ - [switch](js-components-basic-switch.md)
+ - [text](js-components-basic-text.md)
+ - [textarea](js-components-basic-textarea.md)
+ - [toolbar](js-components-basic-toolbar.md)
+ - [toolbar-item](js-components-basic-toolbar-item.md)
+ - [toggle](js-components-basic-toggle.md)
+ - [web](js-components-basic-web.md)
+- Media Components
+ - [video](js-components-media-video.md)
+- Canvas Components
+ - [canvas](js-components-canvas-canvas.md)
+ - [CanvasRenderingContext2D](js-components-canvas-canvasrenderingcontext2d.md)
+ - [Image](js-components-canvas-image.md)
+ - [CanvasGradient](js-components-canvas-canvasgradient.md)
+ - [ImageData](js-components-canvas-imagedata.md)
+ - [Path2D](js-components-canvas-path2d.md)
+ - [ImageBitmap](js-components-canvas-imagebitmap.md)
+ - [OffscreenCanvas](js-components-canvas-offscreencanvas.md)
+ - [OffscreenCanvasRenderingContext2D](js-offscreencanvasrenderingcontext2d.md)
+- Grid Components
+ - [Basic Concepts](js-components-grid-basic-concepts.md)
+ - [grid-container](js-components-grid-container.md)
+ - [grid-row](js-components-grid-row.md)
+ - [grid-col](js-components-grid-col.md)
+- SVG Components
+ - [Universal Attributes](js-components-svg-common-attributes.md)
+ - [svg](js-components-svg.md)
+ - [rect](js-components-svg-rect.md)
+ - [circle](js-components-svg-circle.md)
+ - [ellipse](js-components-svg-ellipse.md)
+ - [path](js-components-svg-path.md)
+ - [line](js-components-svg-line.md)
+ - [polyline](js-components-svg-polyline.md)
+ - [polygon](js-components-svg-polygon.md)
+ - [text](js-components-svg-text.md)
+ - [tspan](js-components-svg-tspan.md)
+ - [textPath](js-components-svg-textpath.md)
+ - [animate](js-components-svg-animate.md)
+ - [animateMotion](js-components-svg-animatemotion.md)
+ - [animateTransform](js-components-svg-animatetransform.md)
- - Container Component
- - [badge](js-components-container-badge.md)
- - [dialog](js-components-container-dialog.md)
- - [div](js-components-container-div.md)
- - [form](js-components-container-form.md)
- - [list](js-components-container-list.md)
- - [list-item](js-components-container-list-item.md)
- - [list-item-group](js-components-container-list-item-group.md)
- - [panel](js-components-container-panel.md)
- - [popup](js-components-container-popup.md)
- - [refresh](js-components-container-refresh.md)
- - [stack](js-components-container-stack.md)
- - [stepper](js-components-container-stepper.md)
- - [stepper-item](js-components-container-stepper-item.md)
- - [swiper](js-components-container-swiper.md)
- - [tabs](js-components-container-tabs.md)
- - [tab-bar](js-components-container-tab-bar.md)
- - [tab-content](js-components-container-tab-content.md)
-
- - Basic Components
- - [button](js-components-basic-button.md)
- - [chart](js-components-basic-chart.md)
- - [divider](js-components-basic-divider.md)
- - [image](js-components-basic-image.md)
- - [image-animator](js-components-basic-image-animator.md)
- - [input](js-components-basic-input.md)
- - [label](js-components-basic-label.md)
- - [marquee](js-components-basic-marquee.md)
- - [menu](js-components-basic-menu.md)
- - [option](js-components-basic-option.md)
- - [picker](js-components-basic-picker.md)
- - [picker-view](js-components-basic-picker-view.md)
- - [piece](js-components-basic-piece.md)
- - [progress](js-components-basic-progress.md)
- - [qrcode](js-components-basic-qrcode.md)
- - [rating](js-components-basic-rating.md)
- - [richtext](js-components-basic-richtext.md)
- - [search](js-components-basic-search.md)
- - [select](js-components-basic-select.md)
- - [slider](js-components-basic-slider.md)
- - [span](js-components-basic-span.md)
- - [switch](js-components-basic-switch.md)
- - [text](js-components-basic-text.md)
- - [textarea](js-components-basic-textarea.md)
- - [toolbar](js-components-basic-toolbar.md)
- - [toolbar-item](js-components-basic-toolbar-item.md)
- - [toggle](js-components-basic-toggle.md)
- - [web](js-components-basic-web.md)
-
- - Media Components
- - [video](js-components-media-video.md)
-
- - Canvas Components
- - [canvas](js-components-canvas-canvas.md)
- - [CanvasRenderingContext2D](js-components-canvas-canvasrenderingcontext2d.md)
- - [Image](js-components-canvas-image.md)
- - [CanvasGradient](js-components-canvas-canvasgradient.md)
- - [ImageData](js-components-canvas-imagedata.md)
- - [Path2D](js-components-canvas-path2d.md)
- - [ImageBitmap](js-components-canvas-imagebitmap.md)
- - [OffscreenCanvas](js-components-canvas-offscreencanvas.md)
- - [OffscreenCanvasRenderingContext2D](js-offscreencanvasrenderingcontext2d.md)
-
- - Grid
- - [Basic Concepts](js-components-grid-basic-concepts.md)
- - [grid-container](js-components-grid-container.md)
- - [grid-row](js-components-grid-row.md)
- - [grid-col](js-components-grid-col.md)
-
- - SVG Components
- - [Universal Attributes](js-components-svg-common-attributes.md)
- - [svg](js-components-svg.md)
- - [rect](js-components-svg-rect.md)
- - [circle](js-components-svg-circle.md)
- - [ellipse](js-components-svg-ellipse.md)
- - [path](js-components-svg-path.md)
- - [line](js-components-svg-line.md)
- - [polyline](js-components-svg-polyline.md)
- - [polygon](js-components-svg-polygon.md)
- - [text](js-components-svg-text.md)
- - [tspan](js-components-svg-tspan.md)
- - [textPath](js-components-svg-textpath.md)
- - [animate](js-components-svg-animate.md)
- - [animateMotion](js-components-svg-animatemotion.md)
- - [animateTransform](js-components-svg-animatetransform.md)
- Custom Components
- - [Basic Usage](js-components-custom-basic-usage.md)
- - [Custom Events](js-components-custom-events.md)
- - [props](js-components-custom-props.md)
- - [Event Parameter](js-components-custom-event-parameter.md)
- - [slot](js-components-custom-slot.md)
- - [Lifecycle Definition](js-components-custom-lifecycle.md)
-- [Type Attributes](js-appendix-types.md)
-
+ - [Basic Usage](js-components-custom-basic-usage.md)
+ - [Custom Events](js-components-custom-events.md)
+ - [props](js-components-custom-props.md)
+ - [Event Parameter](js-components-custom-event-parameter.md)
+ - [slot](js-components-custom-slot.md)
+ - [Lifecycle Definition](js-components-custom-lifecycle.md)
+- [Data Type Attributes](js-appendix-types.md)
diff --git a/en/application-dev/reference/arkui-js/js-appendix-types.md b/en/application-dev/reference/arkui-js/js-appendix-types.md
index 66b9939d938719f5b5178d347309e58c9dd5c764..335bb726f6a1e9d3cd86adf0b5d54c493f4eb15e 100644
--- a/en/application-dev/reference/arkui-js/js-appendix-types.md
+++ b/en/application-dev/reference/arkui-js/js-appendix-types.md
@@ -1,169 +1,167 @@
-# Type Attributes
+# Data Type Attributes
## Length Type
-| Name | Type | Description |
-| ---------- | ---------------- | ------------------------------------------------------------ |
-| length | string \| number | Size unit. When the type is **number**, the unit is px. When the type is **string**, the pixel unit needs to be explicitly specified. Currently, the following pixel units are supported: - **px**: logical size unit. - **fp**6+: font size unit, which varies according to the system font size. Only text components support the setting of the font size. |
-| percentage | string | Unit in percentage, for example, **50%**. |
+| Name | Type | Description |
+| ---------- | -------------------------- | ---------------------------------------- |
+| length | string \| number | Size unit. When the type is **number**, the unit is px. When the type is **string**, the pixel unit needs to be explicitly specified. Currently, the following pixel units are supported: - **px**: logical size unit. - **fp**6+: font size unit, which varies with the system font size. This unit is only available for text components.|
+| percentage | string | Unit in percentage, for example, **50%**. |
-## Color Type
-
-| Name | Type | Description |
-| ----- | ---------------------------------- | ------------------------------------------------------------ |
-| color | string \| Color enumeration values | Color information. The String format is as follows: - 'rgb(255, 255, 255)' - 'rgba(255, 255, 255, 1.0)' - HEX formats: #rrggbb and #aarrggbb - Enumeration format: 'black' and 'white' NOTE: The enumeration format is not supported in the JS script. |
-**Table 1** Currently supported colors
-
-| Name | Hexadecimal Code | Color |
-| -------------------- | ---------------- | ------------------------------------------------------------ |
-| aliceblue | \#f0f8ff |  |
-| antiquewhite | \#faebd7 |  |
-| aqua | \#00ffff |  |
-| aquamarine | \#7fffd4 |  |
-| azure | \#f0ffff |  |
-| beige | \#f5f5dc |  |
-| bisque | \#ffe4c4 |  |
-| black | \#000000 |  |
-| blanchedalmond | \#ffebcd |  |
-| blue | \#0000ff |  |
-| blueviolet | \#8a2be2 |  |
-| brown | \#a52a2a |  |
-| burlywood | \#deB887 |  |
-| cadetblue | \#5f9ea0 |  |
-| chartreuse | \#7fff00 |  |
-| chocolate | \#d2691e |  |
-| coral | \#ff7f50 |  |
-| cornflowerblue | \#6495ed |  |
-| cornsilk | \#fff8dc |  |
-| crimson | \#dc143c |  |
-| cyan | \#00ffff |  |
-| darkblue | \#00008b |  |
-| darkcyan | \#008b8b |  |
-| darkgoldenrod | \#b8860b |  |
-| darkgray | \#a9a9a9 |  |
-| darkgreen | \#006400 |  |
-| darkgrey | \#a9a9a9 |  |
-| darkkhaki | \#bdb76b |  |
-| darkmagenta | \#8b008b |  |
-| darkolivegreen | \#556b2f |  |
-| darkorange | \#ff8c00 |  |
-| darkorchid | \#9932cc |  |
-| darkred | \#8b0000 |  |
-| darksalmon | \#e9967a |  |
-| darkseagreen | \#8fbc8f |  |
-| darkslateblue | \#483d8b |  |
-| darkslategray | \#2f4f4f |  |
-| darkslategrey | \#2f4f4f |  |
-| darkturquoise | \#00ced1 |  |
-| darkviolet | \#9400d3 |  |
-| deeppink | \#ff1493 |  |
-| deepskyblue | \#00bfff |  |
-| dimgray | \#696969 |  |
-| dimgrey | \#696969 |  |
-| dodgerblue | \#1e90ff |  |
-| firebrick | \#b22222 |  |
-| floralwhite | \#fffaf0 |  |
-| forestgreen | \#228b22 |  |
-| fuchsia | \#ff00ff |  |
-| gainsboro | \#dcdcdc |  |
-| ghostwhite | \#f8f8ff |  |
-| gold | \#ffd700 |  |
-| goldenrod | \#daa520 |  |
-| gray | \#808080 |  |
-| green | \#008000 |  |
-| greenyellow | \#adff2f |  |
-| grey | \#808080 |  |
-| honeydew | \#f0fff0 |  |
-| hotpink | \#ff69b4 |  |
-| indianred | \#cd5c5c |  |
-| indigo | \#4b0082 |  |
-| ivory | \#fffff0 |  |
-| khaki | \#f0e68c |  |
-| lavender | \#e6e6fa |  |
-| lavenderblush | \#fff0f5 |  |
-| lawngreen | \#7cfc00 |  |
-| lemonchiffon | \#fffacd |  |
-| lightblue | \#add8e6 |  |
-| lightcoral | \#f08080 |  |
-| lightcyan | \#e0ffff |  |
-| lightgoldenrodyellow | \#fafad2 |  |
-| lightgray | \#d3d3d3 |  |
-| lightgreen | \#90ee90 |  |
-| lightpink | \#ffb6c1 |  |
-| lightsalmon | \#ffa07a |  |
-| lightseagreen | \#20b2aa |  |
-| lightskyblue | \#87cefa |  |
-| lightslategray | \#778899 |  |
-| lightslategrey | \#778899 |  |
-| lightsteelblue | \#b0c4de |  |
-| lightyellow | \#ffffe0 |  |
-| lime | \#00ff00 |  |
-| limegreen | \#32cd32 |  |
-| linen | \#faf0e6 |  |
-| magenta | \#ff00ff |  |
-| maroon | \#800000 |  |
-| mediumaquamarine | \#66cdaa |  |
-| mediumblue | \#0000cd |  |
-| mediumorchid | \#ba55d3 |  |
-| mediumpurple | \#9370db |  |
-| mediumseagreen | \#3cb371 |  |
-| mediumslateblue | \#7b68ee |  |
-| mediumspringgreen | \#00fa9a |  |
-| mediumturquoise | \#48d1cc |  |
-| mediumvioletred | \#c71585 |  |
-| midnightblue | \#191970 |  |
-| mintcream | \#f5fffa |  |
-| mistyrose | \#ffe4e1 |  |
-| moccasin | \#ffe4b5 |  |
-| navajowhite | \#ffdead |  |
-| navy | \#000080 |  |
-| oldlace | \#fdf5e6 |  |
-| olive | \#808000 |  |
-| olivedrab | \#6b8e23 |  |
-| orange | \#ffa500 |  |
-| orangered | \#ff4500 |  |
-| orchid | \#da70d6 |  |
-| palegoldenrod | \#eee8aa |  |
-| palegreen | \#98fb98 |  |
-| paleturquoise | \#afeeee |  |
-| palevioletred | \#db7093 |  |
-| papayawhip | \#ffefd5 |  |
-| peachpuff | \#ffdab9 |  |
-| peru | \#cd853f |  |
-| pink | \#ffc0cb |  |
-| plum | \#dda0dd |  |
-| powderblue | \#b0e0e6 |  |
-| purple | \#800080 |  |
-| rebeccapurple | \#663399 |  |
-| red | \#ff0000 |  |
-| rosybrown | \#bc8f8f |  |
-| royalblue | \#4169e1 |  |
-| saddlebrown | \#8b4513 |  |
-| salmon | \#fa8072 |  |
-| sandybrown | \#f4a460 |  |
-| seagreen | \#2e8b57 |  |
-| seashell | \#fff5ee |  |
-| sienna | \#a0522d |  |
-| silver | \#c0c0c0 |  |
-| skyblue | \#87ceeb |  |
-| slateblue | \#6a5acd |  |
-| slategray | \#708090 |  |
-| slategrey | \#708090 |  |
-| snow | \#fffafa |  |
-| springgreen | \#00ff7f |  |
-| steelblue | \#4682b4 |  |
-| tan | \#d2b48c |  |
-| teal | \#008080 |  |
-| thistle | \#d8Bfd8 |  |
-| tomato | \#ff6347 |  |
-| turquoise | \#40e0d0 |  |
-| violet | \#ee82ee |  |
-| wheat | \#f5deb3 |  |
-| white | \#ffffff |  |
-| whitesmoke | \#f5f5f5 |  |
-| yellow | \#ffff00 |  |
-| yellowgreen | \#9acd32 |  |
+## Color Type
+| Name | Type | Description |
+| ----- | --------------------- | ---------------------------------------- |
+| color | string \| color enums| Color information. The color enums are not supported in JavaScript scripts. Available string formats are as follows: - 'rgb(255, 255, 255)' - 'rgba(255, 255, 255, 1.0)' - HEX format: '\#rrggbb', '\#aarrggbb' - Enumeration format: 'black','white'.|
+**Table 1** Color enums
+| Name | Hexadecimal Code | Color |
+| -------------------- | -------- | ---------------------------------------- |
+| aliceblue | \#f0f8ff |  |
+| antiquewhite | \#faebd7 |  |
+| aqua | \#00ffff |  |
+| aquamarine | \#7fffd4 |  |
+| azure | \#f0ffff |  |
+| beige | \#f5f5dc |  |
+| bisque | \#ffe4c4 |  |
+| black | \#000000 |  |
+| blanchedalmond | \#ffebcd |  |
+| blue | \#0000ff |  |
+| blueviolet | \#8a2be2 |  |
+| brown | \#a52a2a |  |
+| burlywood | \#deB887 |  |
+| cadetblue | \#5f9ea0 |  |
+| chartreuse | \#7fff00 |  |
+| chocolate | \#d2691e |  |
+| coral | \#ff7f50 |  |
+| cornflowerblue | \#6495ed |  |
+| cornsilk | \#fff8dc |  |
+| crimson | \#dc143c |  |
+| cyan | \#00ffff |  |
+| darkblue | \#00008b |  |
+| darkcyan | \#008b8b |  |
+| darkgoldenrod | \#b8860b |  |
+| darkgray | \#a9a9a9 |  |
+| darkgreen | \#006400 |  |
+| darkgrey | \#a9a9a9 |  |
+| darkkhaki | \#bdb76b |  |
+| darkmagenta | \#8b008b |  |
+| darkolivegreen | \#556b2f |  |
+| darkorange | \#ff8c00 |  |
+| darkorchid | \#9932cc |  |
+| darkred | \#8b0000 |  |
+| darksalmon | \#e9967a |  |
+| darkseagreen | \#8fbc8f |  |
+| darkslateblue | \#483d8b |  |
+| darkslategray | \#2f4f4f |  |
+| darkslategrey | \#2f4f4f |  |
+| darkturquoise | \#00ced1 |  |
+| darkviolet | \#9400d3 |  |
+| deeppink | \#ff1493 |  |
+| deepskyblue | \#00bfff |  |
+| dimgray | \#696969 |  |
+| dimgrey | \#696969 |  |
+| dodgerblue | \#1e90ff |  |
+| firebrick | \#b22222 |  |
+| floralwhite | \#fffaf0 |  |
+| forestgreen | \#228b22 |  |
+| fuchsia | \#ff00ff |  |
+| gainsboro | \#dcdcdc |  |
+| ghostwhite | \#f8f8ff |  |
+| gold | \#ffd700 |  |
+| goldenrod | \#daa520 |  |
+| gray | \#808080 |  |
+| green | \#008000 |  |
+| greenyellow | \#adff2f |  |
+| grey | \#808080 |  |
+| honeydew | \#f0fff0 |  |
+| hotpink | \#ff69b4 |  |
+| indianred | \#cd5c5c |  |
+| indigo | \#4b0082 |  |
+| ivory | \#fffff0 |  |
+| khaki | \#f0e68c |  |
+| lavender | \#e6e6fa |  |
+| lavenderblush | \#fff0f5 |  |
+| lawngreen | \#7cfc00 |  |
+| lemonchiffon | \#fffacd |  |
+| lightblue | \#add8e6 |  |
+| lightcoral | \#f08080 |  |
+| lightcyan | \#e0ffff |  |
+| lightgoldenrodyellow | \#fafad2 |  |
+| lightgray | \#d3d3d3 |  |
+| lightgreen | \#90ee90 |  |
+| lightpink | \#ffb6c1 |  |
+| lightsalmon | \#ffa07a |  |
+| lightseagreen | \#20b2aa |  |
+| lightskyblue | \#87cefa |  |
+| lightslategray | \#778899 |  |
+| lightslategrey | \#778899 |  |
+| lightsteelblue | \#b0c4de |  |
+| lightyellow | \#ffffe0 |  |
+| lime | \#00ff00 |  |
+| limegreen | \#32cd32 |  |
+| linen | \#faf0e6 |  |
+| magenta | \#ff00ff |  |
+| maroon | \#800000 |  |
+| mediumaquamarine | \#66cdaa |  |
+| mediumblue | \#0000cd |  |
+| mediumorchid | \#ba55d3 |  |
+| mediumpurple | \#9370db |  |
+| mediumseagreen | \#3cb371 |  |
+| mediumslateblue | \#7b68ee |  |
+| mediumspringgreen | \#00fa9a |  |
+| mediumturquoise | \#48d1cc |  |
+| mediumvioletred | \#c71585 |  |
+| midnightblue | \#191970 |  |
+| mintcream | \#f5fffa |  |
+| mistyrose | \#ffe4e1 |  |
+| moccasin | \#ffe4b5 |  |
+| navajowhite | \#ffdead |  |
+| navy | \#000080 |  |
+| oldlace | \#fdf5e6 |  |
+| olive | \#808000 |  |
+| olivedrab | \#6b8e23 |  |
+| orange | \#ffa500 |  |
+| orangered | \#ff4500 |  |
+| orchid | \#da70d6 |  |
+| palegoldenrod | \#eee8aa |  |
+| palegreen | \#98fb98 |  |
+| paleturquoise | \#afeeee |  |
+| palevioletred | \#db7093 |  |
+| papayawhip | \#ffefd5 |  |
+| peachpuff | \#ffdab9 |  |
+| peru | \#cd853f |  |
+| pink | \#ffc0cb |  |
+| plum | \#dda0dd |  |
+| powderblue | \#b0e0e6 |  |
+| purple | \#800080 |  |
+| rebeccapurple | \#663399 |  |
+| red | \#ff0000 |  |
+| rosybrown | \#bc8f8f |  |
+| royalblue | \#4169e1 |  |
+| saddlebrown | \#8b4513 |  |
+| salmon | \#fa8072 |  |
+| sandybrown | \#f4a460 |  |
+| seagreen | \#2e8b57 |  |
+| seashell | \#fff5ee |  |
+| sienna | \#a0522d |  |
+| silver | \#c0c0c0 |  |
+| skyblue | \#87ceeb |  |
+| slateblue | \#6a5acd |  |
+| slategray | \#708090 |  |
+| slategrey | \#708090 |  |
+| snow | \#fffafa |  |
+| springgreen | \#00ff7f |  |
+| steelblue | \#4682b4 |  |
+| tan | \#d2b48c |  |
+| teal | \#008080 |  |
+| thistle | \#d8Bfd8 |  |
+| tomato | \#ff6347 |  |
+| turquoise | \#40e0d0 |  |
+| violet | \#ee82ee |  |
+| wheat | \#f5deb3 |  |
+| white | \#ffffff |  |
+| whitesmoke | \#f5f5f5 |  |
+| yellow | \#ffff00 |  |
+| yellowgreen | \#9acd32 |  |
diff --git a/en/application-dev/reference/arkui-js/js-components-common-transition.md b/en/application-dev/reference/arkui-js/js-components-common-transition.md
index 7811dc68f1acc598847661c1b0ed55a7d5bf94c2..19e54ce8bb7cbbf8f417fb3623a0fbe6635f8f67 100644
--- a/en/application-dev/reference/arkui-js/js-components-common-transition.md
+++ b/en/application-dev/reference/arkui-js/js-components-common-transition.md
@@ -1,58 +1,77 @@
# Transition Styles
->  **NOTE** Supported since API version 4. Updates will be marked with a superscript to indicate their earliest API version.
+> **NOTE**
+>
+> Supported since API version 4. Updates will be marked with a superscript to indicate their earliest API version.
## Transition of Shared Elements
+
### Attributes
-| Name | Type | Default Value | Description |
-| ------- | ------ | ------------- | ------------------------------------------------------------ |
-| shareid | string | - | Used for the transition of shared elements and takes effect only when it is configured.**list-item**, **image**, **text**, **button**, and **label** components are supported for the transition of shared elements. |
+| Name | Type | Default Value | Description |
+| ------- | ------ | ---- | ---------------------------------------- |
+| shareid | string | - | Used for the transition of shared elements, which takes effect only when this attribute is set. **\**, **\**, **\**, **\