Merge branch 'OpenHarmony-3.2-Beta2' of gitee.com:openharmony/docs into OpenHarmony-3.2-Beta2

Signed-off-by: N王江颖 <wangjiangying@huawei.com>

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

 # Standard NFC Card Emulation
 
-The cardEmulation module implements Near-Field Communication (NFC) card emulation.
+The **cardEmulation** module implements Near-Field Communication (NFC) card emulation.
 
 > **NOTE**<br>
-> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+> The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
 
 ## Modules to Import
@@ -19,7 +19,7 @@ isSupported(feature: number): boolean
 
 Checks whether a certain type of card emulation is supported.
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Return value**
 
@@ -27,11 +27,11 @@ Checks whether a certain type of card emulation is supported.
   | -------- | -------- |
   | boolean | Returns **true** if the card emulation is supported; returns **false** otherwise.|
 
-## HceService
+## HceService<sup>8+</sup>
 
 Implements Host-based Card Emulation (HCE). Before calling any API in **HceService**, you must use **new cardEmulation.HceService()** to create an **HceService** instance.
 
-### startHCE
+### startHCE<sup>8+</sup>
 
 startHCE(aidList: string[]): boolean
 
@@ -39,7 +39,7 @@ Starts HCE.
 
 **Required permissions**: ohos.permission.NFC_CARD_EMULATION
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Parameters**
 
@@ -47,7 +47,7 @@ Starts HCE.
 | ------- | -------- | ---- | ----------------------- |
 | aidList | string[] | Yes  | Application ID (AID) list to be registered for card emulation.|
 
-### stopHCE
+### stopHCE<sup>8+</sup>
 
 stopHCE(): boolean
 
@@ -55,9 +55,9 @@ Stops HCE.
 
 **Required permissions**: ohos.permission.NFC_CARD_EMULATION
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
-### on
+### on<sup>8+</sup>
 
 on(type: "hceCmd", callback: AsyncCallback<number[]>): void;
 
@@ -65,7 +65,7 @@ Subscribes to messages from the peer device after **startHCE()**.
 
 **Required permissions**: ohos.permission.NFC_CARD_EMULATION
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Parameters**
 
@@ -74,7 +74,7 @@ Subscribes to messages from the peer device after **startHCE()**.
 | type     | string                  | Yes  | Event type to subscribe to. The value is **hceCmd**.                        |
 | callback | AsyncCallback<number[]> | Yes  | Callback invoked to return the subscribed event. The input parameter is a data array that complies with the Application Protocol Data Unit (APDU).|
 
-### sendResponse
+### sendResponse<sup>8+</sup>
 
 sendResponse(responseApdu: number[]): void;
 
@@ -82,7 +82,7 @@ Sends a response to the peer device.
 
 **Required permissions**: ohos.permission.NFC_CARD_EMULATION
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Parameters**
 

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

 # Active Tag
 
+The **connectedTag** module provides methods for using active tags. You can use the APIs provided by this module to initialize the active tag chip and read and write active tags.
+
 > **NOTE**<br>
 > The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
@@ -22,9 +24,9 @@ Initializes the active tag chip.
 **System capability**: SystemCapability.Communication.ConnectedTag
 
 - Return value
- | **Type** | **Description** |
+  | **Type**| **Description**|
   | -------- | -------- |
- | boolean | Returns **true** if the initialization is successful; returns **false** otherwise. |
+  | boolean | Returns **true** if the initialization is successful; returns **false** otherwise.|
 
 
 ## connectedTag.uninit
@@ -38,9 +40,9 @@ Uninitializes the active tag resources.
 **System capability**: SystemCapability.Communication.ConnectedTag
 
 - Return value
- | **Type** | **Description** |
+  | **Type**| **Description**|
   | -------- | -------- |
- | boolean | Returns **true** if the operation is successful; returns **false** otherwise. |
+  | boolean | Returns **true** if the operation is successful; returns **false** otherwise.|
 
 
 ## connectedTag.readNdefTag
@@ -54,9 +56,9 @@ Reads the content of this active tag. This method uses a promise to return the r
 **System capability**: SystemCapability.Communication.ConnectedTag
 
 - Return value
- | **Type** | **Description** |
+  | **Type**| **Description**|
   | -------- | -------- |
- | Promise&lt;string&gt; | Promise used to return the content of the active tag. |
+  | Promise&lt;string&gt; | Promise used to return the content of the active tag.|
 
 - Example
   ```
@@ -78,9 +80,9 @@ Reads the content of this active tag. This method uses an asynchronous callback
 **System capability**: SystemCapability.Communication.ConnectedTag
 
 - Parameters
- | **Name** | **Type** | **Mandatory** | **Description** |
+  | **Name**| **Type**| **Mandatory**| **Description**|
   | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback&lt;string&gt; | Yes | Callback invoked to return the active tag content obtained. |
+  | callback | AsyncCallback&lt;string&gt; | Yes| Callback invoked to return the active tag content obtained.|
 
 - Example
   ```
@@ -102,14 +104,14 @@ Writes data to this active tag. This method uses a promise to return the result.
 **System capability**: SystemCapability.Communication.ConnectedTag
 
 - Parameters
- | **Name** | **Type** | **Mandatory** | **Description** |
+  | **Name**| **Type**| **Mandatory**| **Description**|
   | -------- | -------- | -------- | -------- |
- | data | string | Yes | Data to write. The maximum length is 1024 bytes. |
+  | data | string | Yes| Data to write. The maximum length is 1024 bytes.|
 
 - Return value
- | **Type** | **Description** |
+  | **Type**| **Description**|
   | -------- | -------- |
- | Promise&lt;void&gt; | Promise used to return the result. This method returns no value. |
+  | Promise&lt;void&gt; | Promise used to return the result. This method returns no value.|
 
 - Example
   ```
@@ -127,7 +129,7 @@ Writes data to this active tag. This method uses a promise to return the result.
 
 ## connectedTag.writeNdefTag
 
-writeNdefTag(data: string, callback: AsyncCallback&lt;string&gt;): void
+writeNdefTag(data: string, callback: AsyncCallback&lt;void&gt;): void
 
 Writes data to this active tag. This method uses an asynchronous callback to return the result.
 
@@ -136,10 +138,10 @@ Writes data to this active tag. This method uses an asynchronous callback to ret
 **System capability**: SystemCapability.Communication.ConnectedTag
 
 - Parameters
- | **Name** | **Type** | **Mandatory** | **Description** |
+  | **Name**| **Type**| **Mandatory**| **Description**|
   | -------- | -------- | -------- | -------- |
- | data | string | Yes | Data to write. The maximum length is 1024 bytes. |
- | callback | AsyncCallback&lt;string&gt; | Yes | Callback invoked to return the operation result. |
+  | data | string | Yes| Data to write. The maximum length is 1024 bytes.|
+  | callback | AsyncCallback&lt;string&gt; | Yes| Callback invoked to return the active tag content obtained.|
 
 - Example
   ```
@@ -168,16 +170,16 @@ Registers the NFC field strength state events.
 **System capability**: SystemCapability.Communication.ConnectedTag
 
 - Parameters
- | **Name** | **Type** | **Mandatory** | **Description** |
+  | **Name**| **Type**| **Mandatory**| **Description**|
   | -------- | -------- | -------- | -------- |
- | type | string | Yes | Event type. The value is **notify**. |
- | callback | Callback&lt;number&gt; | Yes | Callback invoked to return the field strength state. |
+  | type | string | Yes| Event type. The value is **notify**.|
+  | callback | Callback&lt;number&gt; | Yes| Callback invoked to return the field strength state.|
 
 - Enumerates the field strength states.
- | **Value** | **Description** |
+  | **Value**| **Description**|
   | -------- | -------- |
- | 0 | Field off. |
- | 1 | Field on. |
+  | 0 | Field off.|
+  | 1 | Field on.|
 
 
 ## connectedTag.off('notify')
@@ -191,10 +193,10 @@ Unregisters the NFC field strength state events.
 **System capability**: SystemCapability.Communication.ConnectedTag
 
 - Parameters
- | **Name** | **Type** | **Mandatory** | **Description** |
+  | **Name**| **Type**| **Mandatory**| **Description**|
   | -------- | -------- | -------- | -------- |
- | type | string | Yes | Event type. The value is **notify**. |
- | callback | Callback&lt;number&gt; | No | Callback used to return the field strength state. If this parameter is not specified, all callbacks associated with the specified event will be unregistered. |
+  | type | string | Yes| Event type. The value is **notify**.|
+  | callback | Callback&lt;number&gt; | No| Callback used to return the field strength state. If this parameter is not specified, all callbacks associated with the specified event will be unregistered.|
 
 - Example
   ```
@@ -206,10 +208,10 @@ Unregisters the NFC field strength state events.
       console.info("nfc rf receive state: " + result);
   }
   
-  // Register event notification
+  // Register event notification.
   connectedTag.on(NFC_RF_NOTIFY, recvNfcRfNotifyFunc);
   
-  // Unregister event notification
+  // Unregister event notification.
   connectedTag.off(NFC_RF_NOTIFY, recvNfcRfNotifyFunc);
   ```
 
@@ -217,7 +219,9 @@ Unregisters the NFC field strength state events.
 
 Enumerates the NFC states.
 
- | Name | Default Value | Description |
- | -------- | -------- | -------- |
- | NFC_RF_LEAVE | 0 | Field off. |
- | NFC_RF_ENTER | 1 | Field on. |
+**System capability**: SystemCapability.Communication.ConnectedTag
+
+| Name| Default Value| Description|
+| -------- | -------- | -------- |
+| NFC_RF_LEAVE | 0 | Field on.|
+| NFC_RF_ENTER | 1 | Field on.|

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

 # Emitter
 
-> **NOTE**<br>
+The **Emitter** module provides APIs for sending and processing in-process events, including the APIs for processing events that are subscribed to in persistent or one-shot manner, unsubscribing from events, and emitting events to the event queue.
+
+> **NOTE**
+>
 > The initial APIs of this module are supported since API version 7.
 
 ## Modules to Import
@@ -17,12 +20,14 @@ None
 
 Enumerates the event emit priority levels.
 
- | Name | Value | Description |
- | --------- | ---- | ------------------------------------------------- |
- | IMMEDIATE | 0 | The event will be emitted immediately.<br>**System capability**: SystemCapability.Notification.Emitter |
- | HIGH | 1 | The event will be emitted before low-priority events.<br>**System capability**: SystemCapability.Notification.Emitter |
- | LOW | 2 | The event will be emitted before idle-priority events. By default, an event is in LOW priority.<br>**System capability**: SystemCapability.Notification.Emitter |
- | IDLE | 3 | The event will be emitted after all the other events.<br>**System capability**: SystemCapability.Notification.Emitter |
+**System capability**: SystemCapability.Notification.Emitter
+
+| Name     | Value  | Description                                             |
+| --------- | ---- | ------------------------------------------------- |
+| IMMEDIATE | 0    | The event will be emitted immediately.                               |
+| HIGH      | 1    | The event will be emitted before low-priority events.                        |
+| LOW       | 2    | The event will be emitted before idle-priority events. By default, an event is in LOW priority.  |
+| IDLE      | 3    | The event will be emitted after all the other events.           |
 
 ## emitter.on
 
@@ -34,10 +39,10 @@ Subscribes to an event in persistent manner. This API uses a callback to return
 
 **Parameters**
 
- | Name | Type | Mandatory | Description |
- | -------- | ----------------------------------- | ---- | ------------------------ |
- | event | [InnerEvent](#innerevent) | Yes | Event to subscribe to in persistent manner. |
- | callback | Callback\<[EventData](#eventdata)\> | Yes | Callback used to return the event. |
+| Name  | Type                               | Mandatory| Description                    |
+| -------- | ----------------------------------- | ---- | ------------------------ |
+| event    | [InnerEvent](#innerevent)           | Yes  | Event to subscribe to in persistent manner.          |
+| callback | Callback\<[EventData](#eventdata)\> | Yes  | Callback used to return the event.|
 
 **Example**
 
@@ -61,10 +66,10 @@ Subscribes to an event in one-shot manner and unsubscribes from it after the eve
 
 **Parameters**
 
- | Name | Type | Mandatory | Description |
- | -------- | ----------------------------------- | ---- | ------------------------ |
- | event | [InnerEvent](#innerevent) | Yes | Event to subscribe to in one-shot manner. |
- | callback | Callback\<[EventData](#eventdata)\> | Yes | Callback used to return the event. |
+| Name  | Type                               | Mandatory| Description                    |
+| -------- | ----------------------------------- | ---- | ------------------------ |
+| event    | [InnerEvent](#innerevent)           | Yes  | Event to subscribe to in one-shot manner.          |
+| callback | Callback\<[EventData](#eventdata)\> | Yes  | Callback used to return the event.|
 
 **Example**
 
@@ -88,9 +93,9 @@ Unsubscribes from an event.
 
 **Parameters**
 
- | Name | Type | Mandatory | Description |
- | ------- | ------ | ---- | ------ |
- | eventId | number | Yes | Event ID. |
+| Name | Type  | Mandatory| Description  |
+| ------- | ------ | ---- | ------ |
+| eventId | number | Yes  | Event ID.|
 
 **Example**
 
@@ -108,10 +113,10 @@ Emits an event to the event queue.
 
 **Parameters**
 
- | Name | Type | Mandatory | Description |
- | ------ | ------------------------- | ---- | -------------- |
- | event | [InnerEvent](#innerevent) | Yes | Event to emit. |
- | data | [EventData](#eventdata) | No | Data carried by the event. |
+| Name| Type                     | Mandatory| Description          |
+| ------ | ------------------------- | ---- | -------------- |
+| event  | [InnerEvent](#innerevent) | Yes  | Event to emit.    |
+| data   | [EventData](#eventdata)   | No  | Data carried by the event.|
 
 **Example**
 
@@ -130,17 +135,21 @@ emitter.emit(innerEvent, eventData);
 
 ## InnerEvent
 
-Describes an intra-process event.
+Describes an in-process event.
 
- | Name | Type | Readable | Writable | Description |
- | -------- | ------------------------------- | ---- | ---- | ---------------------------------- |
- | eventId | number | Yes | Yes | Event ID, which is used to identify an event.<br>**System capability**: SystemCapability.Notification.Emitter |
- | priority | [EventPriority](#eventpriority) | Yes | Yes | Emit priority of the event.<br>**System capability**: SystemCapability.Notification.Emitter |
+**System capability**: SystemCapability.Notification.Emitter
+
+| Name    | Type                       | Readable| Writable| Description                              |
+| -------- | ------------------------------- | ---- | ---- | ---------------------------------- |
+| eventId  | number                          | Yes  | Yes  | Event ID, which is used to identify an event.|
+| priority | [EventPriority](#eventpriority) | Yes  | Yes  | Emit priority of the event.        |
 
 ## EventData
 
 Describes the data passed in the event.
 
- | Name | Type | Readable | Writable | Description |
- | ---- | ------------------ | ---- | ---- | -------------- |
- | data | [key: string]: any | Yes | Yes | Data carried by the event. The data type can be String, Integer, or Boolean.<br>**System capability**: SystemCapability.Notification.Emitter |
+**System capability**: SystemCapability.Notification.Emitter
+
+| Name| Type          | Readable| Writable| Description          |
+| ---- | ------------------ | ---- | ---- | -------------- |
+| data | [key: string]: any | Yes  | Yes  | Data carried by the event. The data type can be String, Integer, or Boolean.|

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

 # Input Method Framework
 
+The **inputMethod** module provides an input method framework, which can be used to hide the keyboard, obtain the list of installed input methods, display the dialog box for input method selection, and more.
+
 >  **NOTE**
 >
 > The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.
@@ -8,14 +10,14 @@
 ## Modules to Import
 
 ```
-import inputMethod from '@ohos.inputMethod';
+import inputMethod from '@ohos.inputmethod';
 ```
 
 ## inputMethod<sup>8+</sup>
 
 Provides the constants.
 
-**System capability**: SystemCapability.Miscservices.InputMethodFramework
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
 
 | Name| Type| Readable| Writable| Description|
 | -------- | -------- | -------- | -------- | -------- |
@@ -26,7 +28,7 @@ Provides the constants.
 
 Describes the input method application attributes.
 
-**System capability**: SystemCapability.Miscservices.InputMethodFramework
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
 
 | Name| Type| Readable| Writable| Description|
 | -------- | -------- | -------- | -------- | -------- |
@@ -37,15 +39,15 @@ Describes the input method application attributes.
 
 getInputMethodController(): InputMethodController
 
-Obtains an [InputMethodController](#InputMethodController) instance.
+Obtains an **[InputMethodController](#inputmethodcontroller)** instance.
 
-**System capability**: SystemCapability.Miscservices.InputMethodFramework
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
 
 **Return value**
 
-| Type| Description|
-| -------- | -------- |
-| [InputMethodController](#InputMethodController) | Returns the current **InputMethodController** instance.|
+| Type                                     | Description                        |
+| ----------------------------------------- | ---------------------------- |
+| [InputMethodController](#inputmethodcontroller) | Returns the current **InputMethodController** instance.|
 
 **Example**
 
@@ -57,25 +59,74 @@ Obtains an [InputMethodController](#InputMethodController) instance.
 
 getInputMethodSetting(): InputMethodSetting
 
-Obtains an [InputMethodSetting](#InputMethodSetting) instance.
+Obtains an **[InputMethodSetting](#inputmethodsetting8)** instance.
 
-**System capability**: SystemCapability.Miscservices.InputMethodFramework
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
 
 **Return value**
 
 | Type                                     | Description                        |
 | ----------------------------------------- | ---------------------------- |
-| [InputMethodSetting](#InputMethodSetting) | Returns the current **InputMethodSetting** instance.|
+| [InputMethodSetting](#inputmethodsetting8) | Returns the current **InputMethodSetting** instance.|
+
 
 **Example**
 
 ```js
   var InputMethodSetting = inputMethod.getInputMethodSetting();
 ```
+## inputMethod.switchInputMethod<sup>9+</sup>
+
+switchInputMethod(target: InputmethodProperty, callback: AsyncCallback&lt;boolean&gt;): void;
+
+Switches to another input method. This API uses an asynchronous callback to return the result. This API can be used only in the stage model.
+
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
+
+**Parameters**
+
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+|target | [InputmethodProperty](#inputmethodproperty8) | Yes| Input method to switch to.|
+| callback | AsyncCallback&lt;boolean&gt; | Yes| Callback used to return the execution result. |
+
+
+**Example**
+
+```js
+  inputMethod.switchInputMethod({packageName:"com.ohos.inputApp", methodId:"InputDemoService"}).then(res => {
+     prompt.showToast({message:"Input method switched." + this.imeList[this.flag].packageName, duration: 200});
+ });
+```
+## inputMethod.switchInputMethod<sup>9+</sup>
+switchInputMethod(target: InputmethodProperty): Promise&lt;boolean&gt;
 
+Switches to another input method. This API uses a promise to return the result. This API can be used only in the stage model.
+
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
+
+**Parameters**
+
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+|target |  [InputmethodProperty](#inputmethodproperty8)| Yes| Input method to switch to.|
+
+**Return value**
+| Type                                     | Description                        |
+| ----------------------------------------- | ---------------------------- |
+| Promise\<boolean> | Promise used to return the execution result. |
+
+**Example**
+
+
+```js
+  inputMethod.switchInputMethod({packageName:"com.ohos.inputApp", methodId:"InputDemoService"}).then(res => {
+     prompt.showToast({message:"Input method switched." + this.imeList[this.flag].packageName, duration: 200});
+ });
+```
 ## InputMethodController
 
-In the following API examples, you must first use [getInputMethodController](#getInputMethodController) to obtain an **InputMethodController** instance, and then call the APIs using the obtained instance.
+In the following API examples, you must first use **[getInputMethodController](#inputmethodgetinputmethodcontroller)** to obtain an **InputMethodController** instance, and then call the APIs using the obtained instance.
 
 ### stopInput
 
@@ -83,7 +134,7 @@ stopInput(callback: AsyncCallback&lt;boolean&gt;): void
 
 Hides the keyboard. This API uses an asynchronous callback to return the result.
 
-**System capability**: SystemCapability.Miscservices.InputMethodFramework
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
 
 **Parameters**
 
@@ -105,13 +156,13 @@ stopInput(): Promise&lt;boolean&gt;
 
 Hides the keyboard. This API uses an asynchronous callback to return the result.
 
-**System capability**: SystemCapability.Miscservices.InputMethodFramework
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
 
 **Return value**
 
 | Type| Description|
 | -------- | -------- |
-| Promise&lt;boolean&gt; | Promise used to return whether the keyboard is successfully hidden.|
+| Promise&lt;boolean&gt; | Promise used to return whether the keyboard is successfully hidden. |
 
 **Example**
 
@@ -123,7 +174,7 @@ Hides the keyboard. This API uses an asynchronous callback to return the result.
 
 ## InputMethodSetting<sup>8+</sup>
 
-In the following API examples, you must first use [getInputMethodSetting](#getInputMethodSetting) to obtain an **InputMethodSetting** instance, and then call the APIs using the obtained instance.
+In the following API examples, you must first use **[getInputMethodSetting](#inputmethodgetinputmethodsetting8)** to obtain an **InputMethodSetting** instance, and then call the APIs using the obtained instance.
 
 ### listInputMethod
 
@@ -131,13 +182,12 @@ listInputMethod(callback: AsyncCallback&lt;Array&lt;InputMethodProperty&gt;&gt;)
 
 Obtains the list of installed input methods. This API uses an asynchronous callback to return the result.
 
-**System capability**: SystemCapability.Miscservices.InputMethodFramework
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
 
 **Parameters**
-
 | Name  | Type                                              | Mandatory| Description                  |
 | -------- | -------------------------------------------------- | ---- | ---------------------- |
-| callback | Array<[InputMethodProperty](#InputMethodProperty)> | Yes  | Callback used to return the list of installed input methods.|
+| callback | Array<[InputMethodProperty](#inputmethodproperty8)> | Yes  | Callback used to return the list of installed input methods.|
 
 **Example**
 
@@ -156,13 +206,12 @@ listInputMethod(): Array&lt;InputMethodProperty&gt;
 
 Obtains the list of installed input methods. This API uses an asynchronous callback to return the result.
 
-**System capability**: SystemCapability.Miscservices.InputMethodFramework
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
 
 **Return value**
-
 | Type                                                       | Description                  |
 | ----------------------------------------------------------- | ---------------------- |
-| Promise<Array<[InputMethodProperty](#InputMethodProperty)>> | Promise used to return the list of installed input methods.|
+| Promise<Array<[InputMethodProperty](#inputmethodproperty8)>> | Promise used to return the list of installed input methods. |
 
 **Example**
 
@@ -180,15 +229,16 @@ displayOptionalInputMethod(callback: AsyncCallback&lt;void&gt;): void
 
 Displays a dialog box for selecting an input method. This API uses an asynchronous callback to return the result.
 
-**System capability**: SystemCapability.Miscservices.InputMethodFramework
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
 
-- Parameters
+**Parameters**
 
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
 | callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the execution result.|
 
 **Example**
+
 ```js
   InputMethodSetting.displayOptionalInputMethod(()=>{
     console.info('displayOptionalInputMethod is called');
@@ -197,17 +247,17 @@ Displays a dialog box for selecting an input method. This API uses an asynchrono
 
 ### displayOptionalInputMethod
 
-  displayOptionalInputMethod(): Promise&lt;void&gt;
+displayOptionalInputMethod(): Promise&lt;void&gt;
 
 Displays a dialog box for selecting an input method. This API uses an asynchronous callback to return the result.
 
-**System capability**: SystemCapability.Miscservices.InputMethodFramework
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
 
 **Return value**
 
 | Type| Description|
 | -------- | -------- |
-| Promise&lt;void&gt; | Promise used to return the execution result.|
+| Promise&lt;void&gt; | Promise used to return the execution result. |
 
 **Example**
 

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

 # Standard NFC
 
-Implements Near-Field Communication (NFC).
+The **nfcController** module implements Near-Field Communication (NFC).
 
 > **NOTE**<br>
-> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+> The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
 
 ## **Modules to Import**
@@ -19,6 +19,8 @@ isNfcAvailable(): boolean
 
 Checks whether NFC is available.
 
+**System capability**: SystemCapability.Communication.NFC.Core
+
 **Return value**
 
 | **Type**| **Description**|
@@ -34,7 +36,7 @@ Opens NFC.
 
 **Required permissions**: ohos.permission.MANAGE_SECURE_SETTINGS
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Return value**
 
@@ -50,7 +52,7 @@ Closes NFC.
 
 **Required permissions**: ohos.permission.MANAGE_SECURE_SETTINGS
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Return value**
 
@@ -64,7 +66,7 @@ isNfcOpen(): boolean
 
 Checks whether NFC is open.
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Return value**
 
@@ -78,7 +80,7 @@ getNfcState(): NfcState
 
 Obtains the NFC state.
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Return value**
 
@@ -92,7 +94,7 @@ on(type: "nfcStateChange", callback: Callback&lt;NfcState&gt;): void
 
 Subscribes to NFC state changes.
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Parameter**
   
@@ -109,7 +111,7 @@ off(type: "nfcStateChange", callback?: Callback&lt;NfcState&gt;): void
 
 Unsubscribes from the NFC state changes.
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Parameter**
   
@@ -140,6 +142,8 @@ Unsubscribes from the NFC state changes.
 
 Enumerates the NFC states.
 
+**System capability**: SystemCapability.Communication.NFC.Core
+
 | Name| Default Value| Description|
 | -------- | -------- | -------- |
 | STATE_OFF | 1 | Off|

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

 # Standard NFC Tag
 
-Manages Near-Field Communication (NFC) tags.
+The **nfcTag** module provides methods for managing Near-Field Communication (NFC) tags.
 
 > **NOTE**<br>
-> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
-
+> The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
 ## **Modules to Import**
 
@@ -12,7 +11,6 @@ Manages Near-Field Communication (NFC) tags.
 import tag from '@ohos.nfc.tag';
 ```
 
-
 ## tag.getNfcATag
 
 getNfcATag(tagInfo: TagInfo): NfcATag
@@ -21,7 +19,7 @@ Obtains an **NfcATag** object, which allows access to the tags that use the NFC-
 
 **Required permissions**: ohos.permission.NFC_TAG
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Return value**
 
@@ -37,7 +35,7 @@ Obtains an **NfcBTag** object, which allows access to the tags that use the NFC-
 
 **Required permissions**: ohos.permission.NFC_TAG
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Return value**
 
@@ -53,7 +51,7 @@ Obtains an **NfcFTag** object, which allows access to the tags that use the NFC-
 
 **Required permissions**: ohos.permission.NFC_TAG
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Return value**
 
@@ -69,10 +67,11 @@ Obtains an **NfcVTag** object, which allows access to the tags that use the NFC-
 
 **Required permissions**: ohos.permission.NFC_TAG
 
-**System capability**: SystemCapability.Communication.NFC
+**System capability**: SystemCapability.Communication.NFC.Core
 
 **Return value**
 
 | **Type**| **Description**        |
 | -------- | ---------------- |
 | NfcVTag  | **NfcVTag** object obtained.|
+

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

 # Button
 
+The **\<Button>** component can be used to create different types of buttons.
 
-> **NOTE**<br>
+> **NOTE**
+>
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **&lt;Button&gt;** component represents a component that can trigger actions.
-
-
 ## Required Permissions
 
 None
@@ -30,15 +29,15 @@ Supported
   | stateEffect | boolean | No | true | Whether to enable the state switchover effect when a button is pressed. When the state is set to **false**, the state switchover effect is disabled. |
 
 
-- Button(label?: string, options?: { type?: ButtonType, stateEffect?: boolean })
+- Button(label?: ResourceStr, options?: { type?: ButtonType, stateEffect?: boolean })
   
-  Creates a button component based on text content. In this case, the **&lt;Button&gt;** component cannot contain child components.
+  Creates a button component based on text content. In this case, the **\<Button>** component cannot contain child components.
 
-  **Table 2** value parameters
+  **Table 2** Parameters
 
   | Name | Type | Mandatory | Default Value | Description |
   | -------- | -------- | -------- | -------- | -------- |
-  | label | string | No | - | Button text. |
+  | label | [ResourceStr](../../ui/ts-types.md) | No | - | Button text. |
   | options | Object | No | - | For details, see the **options** parameters. |
 
 
@@ -67,7 +66,8 @@ Supported
 ## Example
 
 
-```
+```ts
+// xxx.ets
 @Entry
 @Component
 struct ButtonExample {
@@ -78,6 +78,7 @@ struct ButtonExample {
         Button('Ok', { type: ButtonType.Normal, stateEffect: true }).borderRadius(8).backgroundColor(0x317aff).width(90)
         Button({ type: ButtonType.Normal, stateEffect: true }) {
           Row() {
+            // You are advised to reference an image by using $r to create a Resource object.
             Image($r('app.media.loading')).width(20).height(20).margin({ left: 12 })
             Text('loading').fontSize(12).fontColor(0xffffff).margin({ left: 5, right: 12 })
           }.alignItems(VerticalAlign.Center)

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

@@ -91,7 +91,11 @@ struct ProgressExample {
       Text('Capsule Progress').fontSize(9).fontColor(0xCCCCCC).width('90%')
       Row({ space: 40 }) {
         Progress({ value: 10, type: ProgressType.Capsule }).width(100).height(50)
-        Progress({ value: 20, total: 150, type: ProgressType.Capsule }).color(Color.Grey).value(50).width(100).height(50)
+        Progress({ value: 20, total: 150, type: ProgressType.Capsule })
+          .color(Color.Grey)
+          .value(50)
+          .width(100)
+          .height(50)
       }
     }.width('100%').margin({ top: 30 })
   }

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

 # Slider
 
 
-> **NOTE**<br>
+> **NOTE**
+>
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **&lt;Slider&gt;** component is used to quickly adjust settings, such as the volume and brightness.
+The *\<Slider>** component is used to quickly adjust settings, such as the volume and brightness.
 
 
 ## Required Permissions
@@ -15,7 +16,7 @@ None
 
 ## Child Components
 
-None
+Not supported
 
 
 ## APIs
@@ -45,7 +46,7 @@ Slider(value:{value?: number, min?: number, max?: number, step?: number, style?:
 Touch target configuration is not supported.
 
 | Name          | Type    | Default Value | Description                              |
-| ------------- | ------- | ------------- | -------------------------------------------------------------------- |
+| ------------- | ------- | ------------- | ---------------------------------------- |
 | blockColor    | Color   | -             | Color of the slider.                     |
 | trackColor    | Color   | -             | Background color of the slider.          |
 | selectedColor | Color   | -             | Color of the slider rail that has been slid. |
@@ -62,17 +63,18 @@ Among all the universal events, only **OnAppear** and **OnDisAppear** are suppor
 | onChange(callback: (value: number, mode: SliderChangeMode) =&gt; void) | Callback invoked when the slider slides.<br/>**value**: current progress.<br/>**mode**: dragging state. |
 
 - SliderChangeMode enums
-    | Name   | Description                         |
-    | ------ | ----------------------------------- |
-    | Begin  | The user starts to drag the slider. |
-    | Moving | The user is dragging the slider.    |
-    | End    | The user stops dragging the slider. |
+    | Name   | Value | Description                         |
+    | ------ | ----- | ----------------------------------- |
+    | Begin  | 0     | The user starts to drag the slider. |
+    | Moving | 1     | The user is dragging the slider.    |
+    | End    | 2     | The user stops dragging the slider. |
 
 
 ## Example
 
 
-```
+```ts
+// xxx.ets
 @Entry
 @Component
 struct SliderExample {

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

 # CanvasGradient
 
 
-> **NOTE**<br>
+> **NOTE**
+>
 > This component is supported since API version 8. Updates will be marked with a superscript to indicate their earliest API version.
 
 
@@ -18,11 +19,11 @@ Adds a color stop for the **CanvasGradient** object based on the specified offse
   | Name | Type | Mandatory | Default Value | Description |
   | -------- | -------- | -------- | -------- | -------- |
   | offset   | number   | Yes      | 0        | Proportion of the distance between the color stop and the start point to the total length. The value ranges from 0 to 1. |
-  | color | string | Yes | 'ffffff' | Gradient color to set. |
+  | color    | string   | Yes      | '#ffffff'| Gradient color to set. |
 
 - Example
-    
-  ```
+  ```ts
+  // xxx.ets
   @Entry
   @Component
   struct Page45 {
@@ -37,9 +38,9 @@ Adds a color stop for the **CanvasGradient** object based on the specified offse
           .backgroundColor('#ffff00')
           .onReady(() =>{
             var grad = this.context.createLinearGradient(50,0, 300,100)
-            this.grad.addColorStop(0.0, 'red')
-            this.grad.addColorStop(0.5, 'white')
-            this.grad.addColorStop(1.0, 'green')
+            grad.addColorStop(0.0, 'red')
+            grad.addColorStop(0.5, 'white')
+            grad.addColorStop(1.0, 'green')
             this.context.fillStyle = grad
             this.context.fillRect(0, 0, 500, 500)
           })

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

 # Scroll
 
+>  **NOTE**
+> - This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
+> - When a **\<List>** is nested in this component, you are advised to specify the width and height of the **\<List>** under scenarios where consistently high performance is required. If the width and height are not specified, this component will load all content of the **\<List>**.
 
-> **NOTE**<br>
-> This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
-
-The **<Scroll\>** component scrolls the content when the layout size of a component exceeds the viewport of its parent component.
+The **\<Scroll>** component scrolls the content when the layout size of a component exceeds the viewport of its parent component.
 
 
 ## Required Permissions
 
-None
+None.
 
 
 ## Child Components
@@ -26,34 +26,44 @@ Scroll(scroller?: Scroller)
 ## Attributes
 
 | Name            | Type                                    | Default Value                     | Description       |
-| -------- | -------- | -------- | -------- |
+| -------------- | ---------------------------------------- | ------------------------ | --------- |
 | scrollable     | ScrollDirection                          | ScrollDirection.Vertical | Scroll method.  |
-| scrollBar      | [BarState](ts-appendix-enums.md#barstate-enums) | Auto | Scroll bar status. |
-| scrollBarColor | Color | - | Color of the scroll bar. |
-| scrollBarWidth | Length | - | Width of the scrollbar. |
+| scrollBar      | [BarState](ts-appendix-enums.md#barstate-enums)| ScrollDirection.Auto     | Scrollbar status. |
+| scrollBarColor | Color                                    | -                        | Color of the scrollbar.|
+| scrollBarWidth | Length                                   | -                        | Width of the scrollbar.|
 
-- ScrollDirection
+- ScrollDirection enums
   | Name        | Description        |
-  | -------- | -------- |
-  | Horizontal | Only horizontal scrolling is supported. |
-  | Vertical | Only vertical scrolling is supported. |
+  | ---------- | ---------- |
+  | Horizontal | Only horizontal scrolling is supported.|
+  | Vertical   | Only vertical scrolling is supported.|
   | None       | Scrolling is disabled.     |
 
+## Events
+
+| Name                                      | Description                         |
+| ---------------------------------------- | ----------------------------- |
+| onScrollBegin<sup>9+</sup>(dx: number, dy: number)&nbsp;=&gt;&nbsp;{ dxRemain: number, dyRemain: number } | Invoked when scrolling starts.<br>Parameters:<br>- **dx**: amount to scroll by in the horizontal direction.<br>- **dy**: amount to scroll by in the vertical direction.<br>Return value:<br>- **dxRemain**: remaining amount to scroll by in the horizontal direction.<br>- **dyRemain**: remaining amount to scroll by in the vertical direction.|
+| onScroll(xOffset:&nbsp;number,&nbsp;yOffset:&nbsp;number)&nbsp;=&gt;&nbsp;void | Invoked to return the horizontal and vertical offsets during scrolling when the specified scroll event occurs.|
+| onScrollEdge(side:&nbsp;Edge)&nbsp;=&gt;&nbsp;void | Invoked when scrolling reaches the edge.                   |
+| onScrollEnd()&nbsp;=&gt;&nbsp;void       | Invoked when scrolling stops.                    |
+
+>  **NOTE**
+> If the **onScrollBegin** event and **scrollBy** API are used to implement nested scrolling, you must set **edgeEffect** of the scrolling child node to **None**. For example, if a **\<List>** is nested in the **\<Scroll>** component, the **edgeEffect** attribute of the **\<List>** must be set to **EdgeEffect.None**.
 
 ## Scroller
 
-Controller of the scrollable container component. You can bind this component to the container component and use it to control the scrolling of the container component. Currently, this component can be bound to the **<List\>** and **<Scroll\>** components.
+Controller of the scrollable container component. You can bind this component to a container component and use it to control the scrolling of that component. Currently, this component can be bound to the **\<List>** and **\<Scroll>** components.
 
 
 ### Objects to Import
 
-
 ```
 scroller: Scroller = new Scroller()
 ```
 
 
-### scroller.scrollTo
+### scrollTo
 
 scrollTo(value: { xOffset: number | string, yOffset: number | string, animation?: { duration: number, curve: Curve } }): void
 
@@ -63,13 +73,13 @@ Scrolls to the specified position.
 
 - Parameters
   | Name      | Type                                    | Mandatory  | Default Value | Description                                    |
-  | -------- | -------- | -------- | -------- | -------- |
+  | --------- | ---------------------------------------- | ---- | ---- | ---------------------------------------- |
   | xOffset   | Length                                   | Yes   | -    | Horizontal scrolling offset.                                 |
   | yOffset   | Length                                   | Yes   | -    | Vertical scrolling offset.                                 |
-  | animation | {<br/>duration: number,<br/>curve: Curve \|<br/>CubicBezier \|<br/>SpringCurve<br/>} | No |  | Animation configuration, which includes the following:<br/>- **duration**: scrolling duration.<br/>- **curve**: scrolling curve. |
+  | animation | {<br>duration:&nbsp;number,<br>curve:&nbsp;[Curve](ts-animatorproperty.md)&nbsp;\|<br>CubicBezier&nbsp;\|<br>SpringCurve<br>} | No   |      | Animation configuration, which includes the following:<br>- **duration**: scrolling duration.<br>- **curve**: scrolling curve.|
 
 
-### scroller.scrollEdge
+### scrollEdge
 
 scrollEdge(value: Edge): void
 
@@ -78,12 +88,13 @@ Scrolls to the edge of the container.
 
 
 - Parameters
-  | Name | Type | Mandatory | Default Value | Description |
-  | -------- | -------- | -------- | -------- | -------- |
-  | value | Edge | Yes | - | Edge position to scroll to. |
+  | Name  | Type| Mandatory  | Default Value | Description     |
+  | ----- | ---- | ---- | ---- | --------- |
+  | value | Edge | Yes   | -    | Edge position to scroll to.|
+
 
 
-### scroller.scrollPage
+### scrollPage
 
 scrollPage(value: { next: boolean, direction?: Axis }): void
 
@@ -91,13 +102,14 @@ Scrolls to the next or previous page.
 
 - Parameters
   | Name      | Type   | Mandatory  | Default Value | Description                          |
-  | -------- | -------- | -------- | -------- | -------- |
-  | next | boolean | Yes | - | Whether to turn to the next page. The value **true** means to scroll to the next page, and the value **false** means to scroll to the previous page. |
+  | --------- | ------- | ---- | ---- | ------------------------------ |
+  | next      | boolean | Yes   | -    | Whether to turn to the next page. The value **true** means to scroll to the next page, and **false** means to scroll to the previous page.|
+  | direction | Axis    | No   | -    | Scrolling direction: horizontal or vertical.               |
 
 
-### scroller.currentOffset
+### currentOffset
 
-scroller.currentOffset(): Object
+currentOffset(): Object
 
 
 Obtains the scrolling offset.
@@ -105,41 +117,51 @@ Obtains the scrolling offset.
 
 - Return value
   | Type                                                    | Description                                                  |
-  | -------- | -------- |
-  | {<br/>xOffset: number,<br/>yOffset: number<br/>} | - **xOffset**: horizontal scrolling offset.<br/>- **yOffset**: vertical scrolling offset. |
+  | ------------------------------------------------------- | ------------------------------------------------------------ |
+  | {<br>xOffset:&nbsp;number,<br>yOffset:&nbsp;number<br>} | **xOffset**: horizontal scrolling offset.<br>**yOffset**: vertical scrolling offset. |
 
 
-### scroller.scrollToIndex
+### scrollToIndex
 
-scroller.scrollToIndex(value: number): void
+scrollToIndex(value: number): void
 
 
-Scrolls to the specified index.
+Scrolls to the item with the specified index.
 
 
-> **NOTE**<br>
-> Only the **<List\>** component is supported.
+>  **NOTE**
+> Only the **\<List>** component is supported.
 
 
 - Parameters
   | Name  | Type  | Mandatory  | Default Value | Description             |
-  | -------- | -------- | -------- | -------- | -------- |
-  | value | number | Yes | - | Index of the item to be scrolled to in the list. |
+  | ----- | ------ | ---- | ---- | ----------------- |
+  | value | number | Yes   | -    | Index of the item to be scrolled to in the list.|
 
 
-## Events
+### scrollBy
 
-| Name | Description |
-| -------- | -------- |
-| onScroll(xOffset: number, yOffset: number) =&gt; void | Invoked to return the horizontal and vertical scrolling offsets when the specified scroll event occurs. |
-| onScrollEdge(side: Edge) =&gt; void | Invoked when an item is scrolled to the edge. |
-| onScrollEnd() =&gt; void | Invoked when scrolling stops. |
+scrollBy(dx: Length, dy: Length): void
 
 
-## Example
+Scrolls by the specified amount.
 
 
-```
+>  **NOTE**
+> Only the **\<Scroll>** component is supported.
+
+
+- Parameters
+  | Name  | Type  | Mandatory  | Default Value | Description             |
+  | ----- | ------ | ---- | ---- | ----------------- |
+  | dx | Length | Yes   | -    | Amount to scroll by in the horizontal direction.|
+  | dy | Length | Yes   | -    | Amount to scroll by in the vertical direction.|
+
+
+## Example
+
+```ts
+// xxx.ets
 @Entry
 @Component
 struct ScrollExample {
@@ -152,14 +174,20 @@ struct ScrollExample {
         Column() {
           ForEach(this.arr, (item) => {
             Text(item.toString())
-              .width('90%').height(150).backgroundColor(0xFFFFFF)
-              .borderRadius(15).fontSize(16).textAlign(TextAlign.Center)
+              .width('90%')
+              .height(150)
+              .backgroundColor(0xFFFFFF)
+              .borderRadius(15)
+              .fontSize(16)
+              .textAlign(TextAlign.Center)
               .margin({ top: 10 })
           }, item => item)
         }.width('100%')
       }
-      .scrollable(ScrollDirection.Vertical).scrollBar(BarState.On)
-      .scrollBarColor(Color.Gray).scrollBarWidth(30)
+      .scrollable(ScrollDirection.Vertical)
+      .scrollBar(BarState.On)
+      .scrollBarColor(Color.Gray)
+      .scrollBarWidth(30)
       .onScroll((xOffset: number, yOffset: number) => {
         console.info(xOffset + ' ' + yOffset)
       })
@@ -171,17 +199,17 @@ struct ScrollExample {
       })
 
       Button('scroll 100')
-        .onClick(() => {// Click to scroll down 100.0.
+        .onClick(() => { // Click to scroll down 100.0.
           this.scroller.scrollTo({ xOffset: 0, yOffset: this.scroller.currentOffset().yOffset + 100 })
         })
         .margin({ top: 10, left: 20 })
       Button('back top')
-        .onClick(() => {// Click to go back to the top.
+        .onClick(() => { // Click to go back to the top.
           this.scroller.scrollEdge(Edge.Top)
         })
         .margin({ top: 60, left: 20 })
       Button('next page')
-        .onClick(() => {// Click to scroll down to the bottom.
+        .onClick(() => { // Click to scroll down to the bottom.
           this.scroller.scrollPage({ next: true })
         })
         .margin({ top: 110, left: 20 })
@@ -191,3 +219,58 @@ struct ScrollExample {
 ```
 
 ![en-us_image_0000001256978363](figures/en-us_image_0000001256978363.gif)
+
+
+```ts
+@Entry
+@Component
+struct NestedScroll {
+  @State listPosition: number = 0 // 0 indicates scrolling to the top of the list, 1 indicates scrolling to the center of the list, and 2 indicates scrolling to the bottom of the list.
+  private arr: number[] = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+  private scroller: Scroller = new Scroller()
+
+  build() {
+    Flex() {
+      Scroll(this.scroller) {
+        Column() {
+          Text("Scroll Area")
+            .width("100%").height("40%").backgroundColor(0X330000FF)
+            .fontSize(16).textAlign(TextAlign.Center)
+
+          List({ space: 20 }) {
+            ForEach(this.arr, (item) => {
+              ListItem() {
+                Text("ListItem" + item)
+                  .width("100%").height("100%").borderRadius(15)
+                  .fontSize(16).textAlign(TextAlign.Center).backgroundColor(Color.White)
+              }.width("100%").height(100)
+            }, item => item)
+          }
+          .width("100%").height("50%").edgeEffect(EdgeEffect.None)
+          .onReachStart(() => {
+            this.listPosition = 0
+          })
+          .onReachEnd(() => {
+            this.listPosition = 2
+          })
+          .onScrollBegin((dx: number, dy: number) => {
+            if ((this.listPosition == 0 && dy >= 0) || (this.listPosition == 2 && dy <= 0)) {
+              this.scroller.scrollBy(0, -dy)
+              return { dxRemain: dx, dyRemain: 0 }
+            }
+            this.listPosition = 1;
+            return { dxRemain: dx, dyRemain: dy }
+          })
+
+          Text("Scroll Area")
+            .width("100%").height("40%").backgroundColor(0X330000FF)
+            .fontSize(16).textAlign(TextAlign.Center)
+        }
+      }
+      .width("100%").height("100%")
+    }.width('100%').height('100%').backgroundColor(0xDCDCDC).padding(20)
+  }
+}
+```
+
+![NestedScroll](figures/NestedScroll.gif)

zh-cn/application-dev/ability/fa-brief.md

@@ -29,9 +29,9 @@ Ability框架在API 8及更早版本使用FA模型。FA模型中Ability分为Pag
 ## 相关实例
 针对Ability开发，有以下相关实例可供参考：
 
-- [`DistributeCalc`：分布式计算器（eTS）（API8）](https://gitee.com/openharmony/app_samples/tree/master/Preset/DistributeCalc)
-- [`DistributeGraffiti`：分布式涂鸦（eTS）（API8）](https://gitee.com/openharmony/app_samples/tree/master/ability/DistributedGraffiti)
-
+- [`DistributedCalc`：分布式计算器（JS）（API8）（Full SDK）](https://gitee.com/openharmony/applications_app_samples/tree/master/common/DistributeCalc)
+- [`DistributedCalc`：分布式计算器（eTS）（API8）（Full SDK）](https://gitee.com/openharmony/applications_app_samples/tree/master/Preset/DistributeCalc)
+- [`DistributeGraffiti`：分布式涂鸦（eTS）（API8）（Full SDK）](https://gitee.com/openharmony/applications_app_samples/tree/master/ability/DistributedGraffiti)
 - [分布式调度启动远程FA（JS）（API8）](https://gitee.com/openharmony/codelabs/tree/master/Distributed/RemoteStartFA)
 - [分布式新闻客户端（JS）（API8）](https://gitee.com/openharmony/codelabs/tree/master/Distributed/NewsDemo)
 - [分布式手写板（eTS）（API8）](https://gitee.com/openharmony/codelabs/tree/master/Distributed/DistributeDatabaseDrawEts)

zh-cn/application-dev/ability/fa-dataability.md

@@ -311,4 +311,4 @@ URI示例：
 
 针对DataAbility开发，有以下相关实例可供参考：
 
-- [`DataAbility`：DataAbility的创建与访问（eTS）（API8）](https://gitee.com/openharmony/app_samples/tree/master/ability/DataAbility)
+- [`DataAbility`：DataAbility的创建与访问（eTS）（API8）](https://gitee.com/openharmony/applications_app_samples/tree/master/ability/DataAbility)

zh-cn/application-dev/ability/fa-formability.md

@@ -350,5 +350,5 @@ onUpdate(formId) {
 ## 相关实例
 
 针对FA模型卡片提供方的开发，有以下相关实例可供参考：
-- [`FormAbility`：FA模型卡片（JS）（API8）](https://gitee.com/openharmony/app_samples/tree/master/ability/FormAbility)
-- [`FormLauncher`：卡片使用方（eTS）（API8）](https://gitee.com/openharmony/app_samples/tree/master/ability/FormLauncher)
+- [`FormAbility`：FA模型卡片（eTS）（API8）](https://gitee.com/openharmony/applications_app_samples/tree/master/ability/FormAbility)
+- [`FormLauncher`：卡片使用方（eTS）（API8）（Full SDK）](https://gitee.com/openharmony/applications_app_samples/tree/master/ability/FormLauncher)
\ No newline at end of file

zh-cn/application-dev/ability/fa-pageability.md

@@ -227,4 +227,4 @@ export default {
 
 针对PageAbility开发，有以下相关实例可供参考：
 
-- [`DMS`：分布式Demo（eTS）（API8）](https://gitee.com/openharmony/app_samples/tree/master/ability/DMS)
+- [`DMS`：分布式Demo（eTS）（API8）（Full SDK）](https://gitee.com/openharmony/applications_app_samples/tree/master/ability/DMS)
\ No newline at end of file