未验证 提交 aaee875d 编写于 作者: O openharmony_ci 提交者: Gitee

!5079 【轻量级 PR】:【OpenHarmony开源贡献者计划2022】fa-formability.md描述优化

Merge pull request !5079 from gloria/N/A
...@@ -59,7 +59,7 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr ...@@ -59,7 +59,7 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr
创建FA模型的卡片,需实现LifecycleForm的生命周期接口。具体示例代码如下: 创建FA模型的卡片,需实现LifecycleForm的生命周期接口。具体示例代码如下:
1. 导入相关模块 1. 导入相关模块
```javascript ```javascript
import formBindingData from '@ohos.application.formBindingData' import formBindingData from '@ohos.application.formBindingData'
...@@ -67,7 +67,7 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr ...@@ -67,7 +67,7 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr
import formProvider from '@ohos.application.formProvider' import formProvider from '@ohos.application.formProvider'
``` ```
2. 实现LifecycleForm生命周期接口 2. 实现LifecycleForm生命周期接口
```javascript ```javascript
export default { export default {
...@@ -86,7 +86,7 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr ...@@ -86,7 +86,7 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr
console.log('FormAbility onCastToNormal'); console.log('FormAbility onCastToNormal');
}, },
onUpdate(formId) { onUpdate(formId) {
// 若卡片支持定时更新/定点更新/卡片使用方主动请求更新功能,则提供方需要写该方法以支持数据更新 // 若卡片支持定时更新/定点更新/卡片使用方主动请求更新功能,则提供方需要写该方法以支持数据更新
console.log('FormAbility onUpdate'); console.log('FormAbility onUpdate');
let obj = { let obj = {
"title": "titleOnUpdate", "title": "titleOnUpdate",
...@@ -102,7 +102,7 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr ...@@ -102,7 +102,7 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr
console.log('FormAbility onVisibilityChange'); console.log('FormAbility onVisibilityChange');
}, },
onEvent(formId, message) { onEvent(formId, message) {
// 若卡片支持触发事件,则需要写该方法并实现对事件的触发 // 若卡片支持触发事件,则需要写该方法并实现对事件的触发
console.log('FormAbility onEvent'); console.log('FormAbility onEvent');
}, },
onDestroy(formId) { onDestroy(formId) {
...@@ -219,7 +219,7 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr ...@@ -219,7 +219,7 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr
} }
``` ```
需要适配onDestroy卡片删除通知接口,在其中实现卡片实例数据的删除。 同时需要适配onDestroy卡片删除通知接口,在其中实现卡片实例数据的删除。
```javascript ```javascript
onDestroy(formId) { onDestroy(formId) {
...@@ -234,10 +234,10 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr ...@@ -234,10 +234,10 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr
具体的持久化方法可以参考[轻量级数据存储开发指导](../database/database-preference-guidelines.md) 具体的持久化方法可以参考[轻量级数据存储开发指导](../database/database-preference-guidelines.md)
需要注意的是,卡片使用方在请求卡片时传递给提供方应用的Want数据中存在临时标记字段,表示此次请求的卡片是否为临时卡片: 需要注意的是,卡片使用方在请求卡片时传递给提供方应用的Want数据中存在临时标记字段,表示此次请求的卡片是否为临时卡片:
- 常态卡片:卡片使用方会持久化的卡片;
常态卡片:卡片使用方会持久化的卡片; - 临时卡片:卡片使用方不会持久化的卡片;
临时卡片:卡片使用方不会持久化的卡片;
由于临时卡片的数据具有非持久化的特殊性,某些场景比如卡片服务框架死亡重启,此时临时卡片数据在卡片管理服务中已经删除,且对应的卡片ID不会通知到提供方,所以卡片提供方需要自己负责清理长时间未删除的临时卡片数据。同时对应的卡片使用方可能会将之前请求的临时卡片转换为常态卡片。如果转换成功,卡片提供方也需要对对应的临时卡片ID进行处理,把卡片提供方记录的临时卡片数据转换为常态卡片数据,防止提供方在清理长时间未删除的临时卡片时,把已经转换为常态卡片的临时卡片信息删除,导致卡片信息丢失。 由于临时卡片的数据具有非持久化的特殊性,某些场景比如卡片服务框架死亡重启,此时临时卡片数据在卡片管理服务中已经删除,且对应的卡片ID不会通知到提供方,所以卡片提供方需要自己负责清理长时间未删除的临时卡片数据。同时对应的卡片使用方可能会将之前请求的临时卡片转换为常态卡片。如果转换成功,卡片提供方也需要对对应的临时卡片ID进行处理,把卡片提供方记录的临时卡片数据转换为常态卡片数据,防止提供方在清理长时间未删除的临时卡片时,把已经转换为常态卡片的临时卡片信息删除,导致卡片信息丢失。
...@@ -322,7 +322,7 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr ...@@ -322,7 +322,7 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formpr
} }
``` ```
最终可以得到如下卡片: 最终可以得到如下卡片:
![fa-form-example](figures/fa-form-example.png) ![fa-form-example](figures/fa-form-example.png)
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册