diff --git a/zh-cn/application-dev/form/arkts-form-overview.md b/zh-cn/application-dev/form/arkts-form-overview.md index b65519cad4c459462f1ce9372eddff399c8bed23..1b47314e228d95dcbec2a3ec207bb1458ac465ca 100644 --- a/zh-cn/application-dev/form/arkts-form-overview.md +++ b/zh-cn/application-dev/form/arkts-form-overview.md @@ -59,7 +59,7 @@ ArkTS卡片提供FormLink静态卡片交互组件，用于静态卡片内部和 请参见[FormLink](../reference/apis-arkui/arkui-ts/ts-container-formlink.md)。 ## 约束与限制 -ArkTS卡片相较于JS卡片具备了更加丰富的能力，但也增加了使用卡片进行恶意行为的风险。由于ArkTS卡片显示在卡片使用方应用中，卡片使用方应用一般为桌面应用，为确保桌面的使用体验以及功耗相关考虑，对ArkTS卡片的能力做了以下约束： +ArkTS卡片支持在UI内运行逻辑代码，相较于JS卡片具备了更加丰富的能力，但也增加了使用卡片进行恶意行为的风险。因为承载ArkTS卡片UI部分的widget.abc代码运行在系统公共的FRS进程内，并最终显示在卡片使用方应用中（一般为桌面应用），为确保系统渲染进程的稳定性、各卡片之间的隔离安全性，以及内存功耗等资源考虑，对ArkTS卡片UI可使用的能力做了以下约束： - 当前仅支持基于ArkUI开发卡片，不支持跨平台开发。 @@ -69,7 +69,7 @@ ArkTS卡片相较于JS卡片具备了更加丰富的能力，但也增加了使 - 不支持使用native语言开发，不支持加载native so。 -- 仅支持[声明式范式](../ui/arkts-ui-development-overview.md)的部分组件、事件、动效、数据管理、状态管理和API能力。对于支持在ArkTS卡片中使用的接口，会添加“卡片能力”的标记：从API version x开始，该接口支持在ArkTS卡片中使用。 +- 针对卡片UI页面开发，ArkTS卡片仅支持[声明式范式](../ui/arkts-ui-development-overview.md)的部分组件、事件、动效、数据管理、状态管理和API能力。对于支持在ArkTS卡片UI页面中使用的接口，会添加“卡片能力”的标记：从API version x开始，该接口支持在ArkTS卡片中使用。 - 卡片组件内容的事件处理和卡片使用方的事件处理是独立的，建议在使用方支持左右滑动的场景下卡片内容不要使用左右滑动功能的组件，以防手势冲突影响交互体验。 diff --git a/zh-cn/application-dev/form/arkts-ui-widget-page-overview.md b/zh-cn/application-dev/form/arkts-ui-widget-page-overview.md index d86803e2f427bd0339b0af6a85ad4dd47baf1bb1..7b3a001f5640b662d57973efa6abcfaa8e7bebaf 100644 --- a/zh-cn/application-dev/form/arkts-ui-widget-page-overview.md +++ b/zh-cn/application-dev/form/arkts-ui-widget-page-overview.md @@ -10,7 +10,7 @@ ArkTS卡片开发采用通用[ArkTS语言](../quick-start/arkts-get-st ArkTS卡片具备JS卡片的全量能力，并且新增了动效能力和自定义绘制的能力，支持[声明式范式](../ui/arkts-ui-development-overview.md)的部分组件、事件、动效、数据管理、状态管理能力。 -对于支持在ArkTS卡片中使用的接口，会添加“卡片能力”的标记：从API version x开始，该接口支持在ArkTS卡片中使用。同时请留意卡片场景下的能力差异说明。 +对于支持在ArkTS卡片UI界面中使用的接口，会添加“卡片能力”的标记：从API version x开始，该接口支持在ArkTS卡片中使用。同时请留意卡片场景下的能力差异说明。 例如：以下说明表示CircleShape可在ArkTS卡片中使用。 diff --git a/zh-cn/application-dev/form/formkit-overview.md b/zh-cn/application-dev/form/formkit-overview.md index cf62d295399a670e77aa6391b3a5886853ac4f19..8314049fab08f7569dc880d959769a8c1c9c5eb6 100644 --- a/zh-cn/application-dev/form/formkit-overview.md +++ b/zh-cn/application-dev/form/formkit-overview.md @@ -8,11 +8,13 @@ Form Kit（卡片开发框架）提供了一种在桌面、锁屏等系统入口 - 卡片使用步骤： 1. 长按“桌面图标”，弹出操作菜单。 -2. 点击“服务卡片”选项，进入卡片管理页面，可以预览卡片。 +2. 点击“服务卡片”选项，进入卡片管理页面，可以预览卡片。 3. 点击“添加到桌面”按钮，即可在桌面上看到并操作新添加的卡片。 **图1** 卡片常见使用步骤 + ![WidgetUse](figures/WidgetUse.png) + ## 服务卡片架构 **图2** 服务卡片架构 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ohos-arkui-advanced-formmenu.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ohos-arkui-advanced-formmenu.md index 47811d89b8820c7b54112b97e99ba1c626902215..afb5592d98c1d85eccb4c2cb45b32f532aed2909 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ohos-arkui-advanced-formmenu.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ohos-arkui-advanced-formmenu.md @@ -68,7 +68,7 @@ AddFormMenuItem( | 名称 | 类型 | 必填 | 说明 | | --------------- | ---- | ---- | ---------------------------------------------------------------- | | formBindingData | [formBindingData.FormBindingData](../../apis-form-kit/js-apis-app-form-formBindingData.md#formbindingdata) | 否 | 卡片数据。 | -| callback | AsyncCallback\ | 否 | 返回结果的回调。 | +| callback | AsyncCallback\ | 否 | 返回添加卡片是否成功的结果回调。回调中包含了卡片id和添加卡片是否成功的结果信息。如果是0表示卡片添加成功，非0参考[卡片错误码信息](../../apis-form-kit/errorcode-form.md) | | style | [FormMenuItemStyle](#formmenuitemstyle) | 否 | 菜单自定义样式信息。| diff --git a/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formHost-sys.md b/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formHost-sys.md index c9463f7245214dcbec35790942159f8af130224b..83b6eccc37ee42ed550454306ab026db6b051b23 100644 --- a/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formHost-sys.md +++ b/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formHost-sys.md @@ -186,7 +186,7 @@ releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback< | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------ | ---- | ----------- | | formId | string | 是 | 卡片标识。 | -| isReleaseCache | boolean | 是 | 是否释放缓存。 | +| isReleaseCache | boolean | 是 | 表示是否释放缓存。
true: 表示释放缓存。
false: 表示不释放缓存。 | | callback | AsyncCallback<void> | 是 | 回调函数。当释放指定的卡片成功，error为undefined；否则为错误对象。 | **错误码：** @@ -237,7 +237,7 @@ releaseForm(formId: string, isReleaseCache?: boolean): Promise<void> | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------ | ---- | ----------- | | formId | string | 是 | 卡片标识。 | -| isReleaseCache | boolean | 否 | 是否释放缓存，默认为false。 | +| isReleaseCache | boolean | 否 | 表示是否释放缓存，默认为false。
true: 表示释放缓存。
false: 表示不释放缓存。| **返回值：** @@ -1661,7 +1661,7 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: A | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | | formIds | Array<string> | 是 | 卡片标识列表。 | -| isVisible | boolean | 是 | 是否可见。 | +| isVisible | boolean | 是 | 表示卡片是否可见。
true: 表示卡片可见。
false: 表示卡片不可见。 | | callback | AsyncCallback<void> | 是 | 回调函数。当通知卡片是否可见成功，error为undefined，否则为错误对象。 | **错误码：** @@ -1711,7 +1711,7 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise< | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | | formIds | Array<string> | 是 | 卡片标识列表。 | -| isVisible | boolean | 是 | 是否可见。 | +| isVisible | boolean | 是 | 表示卡片是否可见。
true: 表示卡片可见。
false: 表示卡片不可见。 | **返回值：** @@ -1766,7 +1766,7 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, c | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | | formIds | Array<string> | 是 | 卡片标识列表。 | -| isEnableUpdate | boolean | 是 | 是否使能更新。 | +| isEnableUpdate | boolean | 是 | 表示卡片是否使能更新状态。
true: 表示卡片使能更新状态。false: 表示卡片没有使能更新状态。| | callback | AsyncCallback<void> | 是 | 回调函数。当通知卡片是否启用更新状态成功，error为undefined，否则为错误对象。 | **错误码：** @@ -1816,7 +1816,7 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean): | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | | formIds | Array<string> | 是 | 卡片标识列表。 | -| isEnableUpdate | boolean | 是 | 是否使能更新。 | +| isEnableUpdate | boolean | 是 | 表示卡片是否使能更新状态。
true: 表示卡片使能更新状态。
false: 表示卡片没有使能更新状态。 | **返回值：** @@ -1977,7 +1977,7 @@ notifyFormsPrivacyProtected(formIds: Array\, isProtected: boolean, callb | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | | formIds | Array\ | 是 | 需要修改隐私保护的卡片标识列表。 | -| isProtected | boolean | 是 | 是否进行隐私保护。 | +| isProtected | boolean | 是 | 表示卡片是否进行隐私保护状态。
true: 表示卡片要进行隐私保护状态。
false: 表示卡片不需要进行隐私保护状态。 | | callback | AsyncCallback\ | 是 | 回调函数。当指定卡片设置隐私保护属性成功，error为undefined，否则为错误对象。 | **错误码：** @@ -2026,7 +2026,7 @@ notifyFormsPrivacyProtected(formIds: Array\, isProtected: boolean): Pro | 参数名 | 类型 | 必填 | 说明 | | ----------- | --------------- | ---- | -------------------------------- | | formIds | Array\ | 是 | 需要修改隐私保护的卡片标识列表。 | -| isProtected | boolean | 是 | 是否进行隐私保护。 | +| isProtected | boolean | 是 | 表示卡片是否进行隐私保护状态。
true: 表示卡片要进行隐私保护状态。
false: 表示卡片不需要进行隐私保护状态。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formProvider-sys.md b/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formProvider-sys.md index 582deb4a46e4837be8fc3e60d5c2f1d28e1aea53..e2035ec5eef65ceab2c13fc6b9530de96a2964ef 100644 --- a/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formProvider-sys.md +++ b/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formProvider-sys.md @@ -199,7 +199,7 @@ try { isRequestPublishFormSupported(callback: AsyncCallback<boolean>): void -查询是否支持发布一张卡片到使用方，使用callback异步回调。 +查询是否支持静默添加卡片到使用方，使用callback异步回调。 **系统接口：** 此接口为系统接口。 @@ -209,7 +209,7 @@ isRequestPublishFormSupported(callback: AsyncCallback<boolean>): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | -| callback | AsyncCallback<boolean> | 是 | 回调函数。返回是否支持发布一张卡片到使用方。| +| callback | AsyncCallback<boolean> | 是 | 返回查询结果的回调函数。
true: 表示支持静默添加卡片到使用方。
false: 表示不支持静默添加卡片到使用方。| **错误码：** @@ -266,7 +266,7 @@ try { isRequestPublishFormSupported(): Promise<boolean> -查询是否支持发布一张卡片到使用方，使用Promise异步回调。 +查询是否支持静默添加到使用方，使用Promise异步回调。 **系统接口：** 此接口为系统接口。 @@ -276,7 +276,7 @@ isRequestPublishFormSupported(): Promise<boolean> | 类型 | 说明 | | :------------ | :---------------------------------- | -| Promise<boolean> | Promise对象。返回是否支持发布一张卡片到使用方。 | +| Promise<boolean> | Promise对象。返回是否支持静默添加卡片到使用方的结果。
true: 表示支持静默添加卡片到使用方。
false: 表示不支持静默添加卡片到使用方。| **错误码：** diff --git a/zh-cn/application-dev/reference/apis-form-kit/js-apis-inner-application-formExtensionContext.md b/zh-cn/application-dev/reference/apis-form-kit/js-apis-inner-application-formExtensionContext.md index 2877a782f2ca18f990a305a1d08c82ecf07def51..eac33014263ec0cea9fa3c73efedce6fb4527704 100644 --- a/zh-cn/application-dev/reference/apis-form-kit/js-apis-inner-application-formExtensionContext.md +++ b/zh-cn/application-dev/reference/apis-form-kit/js-apis-inner-application-formExtensionContext.md @@ -24,3 +24,22 @@ FormExtensionContext模块是[FormExtensionAbility](js-apis-app-form-formExtensi **模型约束：** 本模块接口仅可在Stage模型下使用。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 + +## 使用场景 +FormExtensionContext主要用于查询所属FormExtension的信息、Module的配置信息以及HAP包的信息，开发者可根据自身业务需求使用对应的信息。 +```ts +import { FormExtensionAbility, formBindingData } from '@kit.FormKit'; +import { Want } from '@kit.AbilityKit'; + +export default class MyFormExtensionAbility extends FormExtensionAbility { + onAddForm(want: Want) { + console.info(`FormExtensionAbility onAddForm, want: ${want.abilityName}`); + let formData: Record = { + 'temperature': '11c', + 'time': '11:00' + }; + console.info("current language is：", this.context.config.language); + return formBindingData.createFormBindingData(formData); + } +}; +``` \ No newline at end of file