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 fe4eb89ce3fae06af85c16a82ef2270b2fc3a88f..80fc6ed023a69e45d1bd50ca37d460cde2649799 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<void>): void + +拉起一个卡片所属应用的Ability。 + +**系统能力**:SystemCapability.Ability.Form + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------| --------------------------------- | ---- | -------------------------------------- | +| want| [Want](js-apis-application-Want.md) | 是 | 包含bundleName,abilityName以及用户自定参数用于拉起Ability。 | +| callback| AsyncCallback<void> | 是 | 回调函数,返回接口调用是否成功的结果。 | + +**示例:** + +```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<void> + +**系统能力**:SystemCapability.Ability.Form + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------| --------------------------------- | ---- | -------------------------------------- | +| want| [Want](js-apis-application-Want.md) | 是 | 包含bundleName,abilityName以及用户自定参数用于拉起Ability。 | + +**返回值:** + +| 类型 | 说明 | +| ------------ | ---------------------------------- | +| Promise<void< | 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