前端(JavaScript)函数_时钟类

文档概述

轻语言网站开发中的时钟类操作函数、用于实现定时器和延时功能，包含设置定时器、清除定时器、延时执行、倒计时等功能，常用于定时任务、动画控制、延时操作等场景。

周期定时器：创建时钟 按指定间隔（毫秒）重复执行子函数，返回时钟ID；类似 setInterval
延时执行器：延时执行 在指定等待时间（毫秒）后执行一次子函数，类似 setTimeout
资源管理：销毁时钟 / 销毁延时执行 用于停止定时器，避免内存泄漏

💡 时钟管理关键：创建时钟 与 销毁时钟 必须成对使用，延时执行 与 销毁延时执行 同理。组件销毁时（如页面切换、元素移除）必须停止对应的时钟，否则会造成内存泄漏。间隔时间单位为毫秒，1000ms = 1秒。

函数：创建时钟(子函数,间隔时间)

创建一个根据指定间隔时间（单位：毫秒）周期调用子程序的定时器时钟对象；返回创建成功后的时钟ID。

' 创建一个每秒执行一次的时钟
变量 时钟ID = 创建时钟(()=>{
	调试输出("时钟执行中: " + 取本地现行时间())
}, 1000)

' 创建一个每5秒更新一次标签内容的时钟
变量 时钟ID2 = 创建时钟(()=>{
	标签1.文本 = "当前时间: " + 取本地现行时间()
}, 5000)

' 倒计时功能实现
变量 剩余秒数 = 60
变量 倒计时ID = 创建时钟(()=>{
	剩余秒数 = 剩余秒数 - 1
	倒计时标签.文本 = 到文本(剩余秒数) + "秒"
	如果(剩余秒数 <= 0)
		销毁时钟(倒计时ID)
		弹出提示("倒计时结束")
	结束 如果
}, 1000)

函数：销毁时钟(ID)

销毁创建的指定时钟对象。代码示例：销毁时钟(时钟ID)

' 销毁之前创建的时钟
销毁时钟(时钟ID)

' 在适当的时候停止时钟，避免内存泄漏
按钮1.置被单击回调((源对象, 事件源)=>{
	销毁时钟(时钟ID2)
	调试输出("时钟已停止")
})

' 页面卸载时清理所有时钟
页面.置被卸载回调(() => {
	销毁时钟(时钟ID)
	销毁时钟(时钟ID2)
})

函数：延时执行(子函数,等待时间)

创建一个根据指定等待时间（单位：毫秒）之后执行的子程序；返回创建成功后的时钟ID；注：本时钟只会在指定等待时间后调用一次子程序。代码示例：延时执行(子函数, 3000)

' 延时3秒后执行某个操作
变量 延时ID = 延时执行(()=>{
	弹出提示("3秒钟已到!")
}, 3000)

' 延时执行页面元素的显示
变量 延时ID2 = 延时执行(()=>{
	面板1.显示模式 = 显示_块
	面板1.文本 = "延时加载的内容"
}, 2000)

' 延时跳转页面
变量 跳转ID = 延时执行(()=>{
	切换页面("首页")
}, 5000)

函数：销毁延时执行(ID)

销毁创建的延时时钟对象。代码示例：销毁延时执行(延时ID)

' 在延时执行前取消操作
销毁延时执行(延时ID)

' 示例：创建一个可取消的延时操作
变量 延时ID3
延时ID3 = 延时执行(()=>{
	切换页面("下一页面")
}, 5000)

' 提供取消按钮
取消按钮.置被单击回调((sender, event)=>{
	销毁延时执行(延时ID3)
	弹出提示("操作已取消")
})

学习要点

知识点	代码示例	说明
周期定时器	`创建时钟(子函数, 1000)`	每隔指定毫秒执行一次，类似 `setInterval`；返回ID用于销毁
延时执行器	`延时执行(子函数, 3000)`	3秒后执行一次，类似 `setTimeout`；返回ID用于取消
销毁成对使用	`销毁时钟(时钟ID)` / `销毁延时执行(延时ID)`	创建与销毁必须成对使用，否则内存泄漏
箭头函数回调	`() => { ... }`	原生 JS 箭头函数语法，轻语言支持直接使用；作为时钟回调函数
间隔单位	`1000` = 1秒	间隔时间为毫秒，1000ms=1秒、500ms=0.5秒
倒计时实现	`剩余秒数 - 1` + `销毁时钟` 判断	用 `创建时钟` 每秒递减，到0时 `销毁时钟` 停止
页面卸载清理	`页面.置被卸载回调` 内 `销毁时钟`	页面切换时必须清理定时器，防止后台运行与内存泄漏

轻语言网站开发SDK文档