1# 卡片内容更新
2
3ArkTS卡片框架为提供方提供了[updateForm](../reference/apis-form-kit/js-apis-app-form-formProvider.md#updateform)接口、为使用方提供了requestForm接口来实现主动触发卡片的页面刷新能力;另外卡片框架还会通过开发者声明的定时信息按需通知提供方进行卡片刷新。
4
5卡片UI代码内通过[LocalStorageProp](../quick-start/arkts-localstorage.md#localstorageprop)可以获得提供方推送的需要刷新的卡片数据。
6
7| 接口 | 是否系统能力 | 约束 |
8| -------- | -------- | -------- |
9| updateForm | 否 | 1.&nbsp;提供方调用。<br/>2.&nbsp;提供方仅允许刷新自己的卡片,其他提供方的卡片无法刷新。 |
10| requestForm | 是 | 1.&nbsp;使用方调用。<br/>2.&nbsp;仅允许刷新添加到当前使用方的卡片,添加到其他使用方的卡片无法刷新。 |
11
12
13
14**1. 提供方主动刷新卡片流程示意:**
15
16![updateForm](figures/updateForm.PNG)
17
18卡片提供方应用运行过程中,如果识别到有要更新卡片数据的诉求,可以主动通过formProvider提供的updateForm接口更新卡片。
19
20
21
22**2. 使用方主动请求更新卡片流程示意:**
23
24![requestForm](figures/requestForm.PNG)
25
26卡片使用方在运行过程中,如果检测到系统语言、深浅色有变化时,可以主动通过formHost提供的requestForm接口请求更新卡片,卡片管理服务会进而通知提供方完成卡片更新。
27
28
29
30**3. 卡片框架通知提供方定时更新卡片流程示意:**
31
32![timer_updateForm](figures/timer_updateForm.PNG)
33
34根据卡片提供方开发者提前配置声明的定时刷新信息,卡片管理服务会根据定时信息、卡片可见状态、刷新次数等因素综合判断是否需要通知提供方更新卡片。
35
36
37
38下面介绍卡片页面刷新的典型场景。
39
40- [卡片定时刷新](arkts-ui-widget-update-by-time.md)
41- [卡片定点刷新](arkts-ui-widget-update-by-time-point.md)
42- [刷新本地图片和网络图片](arkts-ui-widget-image-update.md)
43- [根据卡片状态刷新不同内容](arkts-ui-widget-update-by-status.md)
44
45