Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
5880c4c5
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
5880c4c5
编写于
4月 11, 2023
作者:
zyjhandsome
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
主动刷新修改为下次刷新
Signed-off-by:
zyjhandsome
<
zyjhandsome@126.com
>
上级
83a7f74f
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
6 addition
and
6 deletion
+6
-6
zh-cn/application-dev/application-models/arkts-ui-widget-update-by-time.md
...-dev/application-models/arkts-ui-widget-update-by-time.md
+6
-6
未找到文件。
zh-cn/application-dev/application-models/arkts-ui-widget-update-by-time.md
浏览文件 @
5880c4c5
...
...
@@ -5,11 +5,11 @@
当前卡片框架提供了如下几种按时间刷新卡片的方式:
-
定时刷新:表示在一定时间间隔内自动刷新卡片内容。可以在form_config.json配置文件的
[
updateDuration
](
arkts-ui-widget-configuration.md
)
字段中进行设置。例如,可以将刷新时间设置为每小时一次。
-
定时刷新:表示在一定时间间隔内自动刷新卡片内容。可以在form_config.json配置文件的
[
`updateDuration`
](
arkts-ui-widget-configuration.md
)
字段中进行设置。例如,可以将刷新时间设置为每小时一次。
> **说明:**
>
> 当配置了
updateDuration(定时刷新)后,该设置会优先于scheduledUpdateTime
(定点刷新)生效,即使同时配置了两者,定点刷新也会被忽略。
> 当配置了
`updateDuration`(定时刷新)后,该设置会优先于`scheduledUpdateTime`
(定点刷新)生效,即使同时配置了两者,定点刷新也会被忽略。
```
json
{
...
...
@@ -35,11 +35,11 @@
}
```
-
定点刷新:表示在每天的某个特定时间点自动刷新卡片内容。可以在form_config.jso
配置文件中的
[
scheduledUpdateTime
](
arkts-ui-widget-configuration.md
)
字段中进行设置。例如,可以将刷新时间设置为每天的上午10点30分。
-
定点刷新:表示在每天的某个特定时间点自动刷新卡片内容。可以在form_config.jso
n配置文件中的
[
`scheduledUpdateTime`
](
arkts-ui-widget-configuration.md
)
字段中进行设置。例如,可以将刷新时间设置为每天的上午10点30分。
> **说明:**
>
> 当同时配置了定时刷新(
updateDuration)和定点刷新(scheduledUpdateTime)时,定时刷新的优先级更高。如果想要配置定点刷新,则需要将updateDuration
配置为0。
> 当同时配置了定时刷新(
`updateDuration`)和定点刷新(`scheduledUpdateTime`)时,定时刷新的优先级更高。如果想要配置定点刷新,则需要将`updateDuration`
配置为0。
```
json
...
...
@@ -88,11 +88,11 @@
```
在触发定时、定点或
主动刷新后,系统会调用FormExtensionAbility的
[
onUpdateForm()
](
../reference/apis/js-apis-app-form-formExtensionAbility.md#onupdateform
)
生命周期回调,在回调中,可以使用
[
updateForm()
](
../reference/apis/js-apis-app-form-formProvider.md#updateform
)
进行提供方刷新卡片。onUpdateForm()生命周期回调参考
[
通过FormExtensionAbility刷新卡片内容
](
arkts-ui-widget-event-formextensionability.md
)
。
在触发定时、定点或
下次刷新后,系统会调用FormExtensionAbility的
[
`onUpdateForm()`
](
../reference/apis/js-apis-app-form-formExtensionAbility.md#onupdateform
)
生命周期回调,在回调中,可以使用
[
`updateForm()`
](
../reference/apis/js-apis-app-form-formProvider.md#updateform
)
进行提供方刷新卡片。
`onUpdateForm()`
生命周期回调的使用请参见
[
通过FormExtensionAbility刷新卡片内容
](
arkts-ui-widget-event-formextensionability.md
)
。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 1. 定时刷新有配额限制,每张卡片每天最多通过定时方式触发刷新50次,定时刷新包含[卡片配置项updateDuration](arkts-ui-widget-configuration.md)和调用[
setFormNextRefreshTime()
](../reference/apis/js-apis-app-form-formProvider.md#setformnextrefreshtime)方法两种方式,当达到50次配额后,无法通过定时方式再次触发刷新,刷新次数会在每天的0点重置。
> 1. 定时刷新有配额限制,每张卡片每天最多通过定时方式触发刷新50次,定时刷新包含[卡片配置项updateDuration](arkts-ui-widget-configuration.md)和调用[
`setFormNextRefreshTime()`
](../reference/apis/js-apis-app-form-formProvider.md#setformnextrefreshtime)方法两种方式,当达到50次配额后,无法通过定时方式再次触发刷新,刷新次数会在每天的0点重置。
>
> 2. 当前定时刷新使用同一个计时器进行计时,因此卡片定时刷新的第一次刷新会有最多30分钟的偏差。比如第一张卡片A(每隔半小时刷新一次)在3点20分添加成功,定时器启动并每隔半小时触发一次事件,第二张卡片B(每隔半小时刷新一次)在3点40分添加成功,在3点50分定时器事件触发时,卡片A触发定时刷新,卡片B会在下次事件(4点20分)中才会触发。
>
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录