From d85e6a597b5bad2e11dd2a9fcf518971544afd62 Mon Sep 17 00:00:00 2001
From: yanwenhao <yanwenhao9@huawei.com>
Date: Wed, 29 Jun 2022 14:45:31 +0800
Subject: [PATCH] Add formExtensionContext::startAbility reference

Signed-off-by: yanwenhao <yanwenhao9@huawei.com>
Change-Id: I6deadd129f442e2da06ea13028f9e7ac9acc9d5a
---
 .../apis/js-apis-formextensioncontext.md      | 77 ++++++++++++++++++-
 1 file changed, 74 insertions(+), 3 deletions(-)

diff --git a/zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md b/zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md
index fe4eb89ce3..80fc6ed023 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md
@@ -5,8 +5,8 @@ FormExtensionContext模块是FormExtension的上下文环境，继承自Extensio
 FormExtensionContext模块提供FormExtension具有的接口和能力。
 
 > **说明：**
-> 
-> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。  
+>
+> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
 > 本模块接口仅可在Stage模型下使用。
 
 ## 导入模块
@@ -85,4 +85,75 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr
       }
   }
 
-  ```
\ No newline at end of file
+  ```
+
+## FormExtensionContext.startAbility
+
+startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void
+
+拉起一个卡片所属应用的Ability。
+
+**系统能力**：SystemCapability.Ability.Form
+
+**参数：**
+
+| 参数名 |                类型               | 必填 |              说明               |
+| ------| --------------------------------- | ---- | -------------------------------------- |
+| want| [Want](js-apis-application-Want.md) | 是  | 包含bundleName，abilityName以及用户自定参数用于拉起Ability。 |
+| callback| AsyncCallback&lt;void&gt;       | 是  | 回调函数，返回接口调用是否成功的结果。 |
+
+**示例：**
+
+```js
+var want = {
+    deviceId: "",
+    bundleName: "com.example.formstartability",
+    abilityName: "MainAbility",
+    action: "action1",
+    entities: ["entity1"],
+    type: "MIMETYPE",
+    uri: "key={true,true,false}",
+    parameters: {}
+}
+this.context.startAbility(want, function(err) {
+    console.info(err.code);
+})
+```
+
+## FormExtensionContext.startAbility
+
+startAbility(want: Want): Promise&lt;void&gt;
+
+**系统能力**：SystemCapability.Ability.Form
+
+**参数：**
+
+| 参数名 |                类型               | 必填 |              说明               |
+| ------| --------------------------------- | ---- | -------------------------------------- |
+| want| [Want](js-apis-application-Want.md) | 是  | 包含bundleName，abilityName以及用户自定参数用于拉起Ability。 |
+
+**返回值：**
+
+| 类型          | 说明                                |
+| ------------ | ---------------------------------- |
+| Promise&lt;void&lt; | Promise实例，返回接口调用是否成功的结果。 |
+
+**示例：**
+
+```js
+var want = {
+    deviceId: "",
+    bundleName: "com.example.formstartability",
+    abilityName: "MainAbility",
+    action: "action1",
+    entities: ["entity1"],
+    type: "MIMETYPE",
+    uri: "key={true,true,false}",
+    parameters: {}
+}
+this.context.startAbility(want).then(() => {
+    console.info("StartAbility Success");
+}).catch((error) => {
+    console.info("StartAbility failed");
+});
+```
\ No newline at end of file
-- 
GitLab