定时器

定时器允许开发者在应用中创建和管理端测周期性任务。通过定时器,可以按照指定的时间间隔自动执行 JavaScript 代码,从而实现定期更新数据、发送通知等操作。本文档将详细介绍如何在魔笔平台中配置和使用定时器。

定时器作用域

页面级定时器

页面级定时器仅在创建它们的特定页面内有效,可以引用页面上的其他值。当用户离开当前页面时,页面定时器会自动停止。

全局级定时器

全局定时器一旦启动,将在整个应用的生命周期内持续运行,即使用户切换页面,定时器也不会自动停止。

配置定时器

在魔笔平台中,配置定时器包含以下几个关键部分:

  1. 参数:为定时器执行提供必要的输入值。参数可以是固定值,也可以是动态表达式。

  2. 执行脚本:包含将在每个时间间隔执行的代码块。这里可以编写 JavaScript 代码,实现定时器的核心逻辑。

  3. 时间间隔:定时器触发执行的频率。可以设置为特定的毫秒数,表示定时器每隔该时间长度执行一次。

  4. 描述:对定时器的功能和用途进行简要说明,便于其他开发者理解定时器的作用。

  5. 禁止执行条件:设置条件表达式,只有当这些条件不满足时,定时器才会启动。这可以防止在不适当的情况下启动定时器。

image

调用方法

定时器支持两种基本的调用方法:

  • 启动:激活定时器,使其按照设定的时间间隔开始执行,如果定时器已处于启动状态,则重启定时器。

  • 停止:停止定时器的活动,取消后续的执行计划。

可以在事件处理器中选择管理定时器动作,或者在“执行脚本”中使用[timerId].start()[timerId].stop()进行定时器的调用。

image

注意事项

  • 定时器的禁止执行条件指启动定时器的条件,如果需要根据特定条件决定每次到达设定的时间间隔后的执行与否,应在定时器体中调用一个前端函数,并设置正确的前端函数禁止执行条件。

  • 如果需要在某次执行时,根据特定条件停止定时器,可在定时器体内调用自身的 stop 方法。

  • 定时器的参数在传入后不会改变,而定时器体中对于组件、变量等值的引用,会与被引用的值始终保持一致。