AiWork显示一个倒计时的Toast消息

AiWork开发文档

在官方文档的基础上，进行重新排版和优化。
一个优雅的文档，对于开发体验的提升，是效果显著的。
永久域名：aiwork.wiki

已知toast函数的显示时长是固定2秒。
设定一个在屏幕上显示的指定时长如30秒的toast倒计时，可以让tost不间断显示，又不会造成堵塞和间断

/**
 * 显示一个倒计时的 Toast 消息。
 *
 * @param {string} [text] - 要显示的文本，如果为空则显示“倒计时”。
 * @param {number} remainingTime - Toast 显示的总时长（秒）
 * @author 飞云
 * @wechat imfeiyun
 * @link  http://www.feiyunjs.com
 */
function countdown(remainingTime, text) {
    const interval = setInterval(() => {
        const displayText = text ? `${text} ${remainingTime} 秒` : `倒计时 ${remainingTime} 秒`;
        toast.show(displayText); // 显示内容

        remainingTime -= 2; // 每次减少 2 秒
        if (remainingTime <= 0) {
            clearInterval(interval); // 清除定时器
            // console.log("Toast 结束"); // 处理结束逻辑
        }
    }, 2000); // 每 2 秒调用一次
}

// 使用示例
countdown(30); // 30 秒

将函数修改为可变参数：

/**
 * 倒计时函数，显示剩余时间。
 * @param {number|string} arg1 - 可以是倒计时的秒数或显示的文本。
 * @param {number|string} arg2 - 可以是倒计时的秒数或显示的文本。
 * @author 飞云
 * @wechat imfeiyun
 * @link  http://www.feiyunjs.com
 */
function countdownEx(arg1, arg2) {
    let remainingTime = null; // 剩余时间初始化为 null
    let text = null; // 显示文本初始化为 null

    // 根据参数类型判断第一个参数
    if (typeof arg1 === 'number' && arg1 > 0) {
        remainingTime = arg1; // 如果是有效的数字，则赋值给剩余时间
    } else if (typeof arg1 === 'string') {
        text = arg1; // 如果是字符串，则赋值给显示文本
    }

    // 根据参数类型判断第二个参数
    if (typeof arg2 === 'number' && arg2 > 0) {
        remainingTime = arg2; // 如果是有效的数字，则赋值给剩余时间
    } else if (typeof arg2 === 'string') {
        text = arg2; // 如果是字符串，则赋值给显示文本
    }

    // 检查剩余时间是否有效
    if (remainingTime === null) {
        console.error("必须提供有效的剩余时间！"); // 报错信息
        return; // 终止函数
    }

    // 设置定时器，每2秒更新一次
    const interval = setInterval(() => {
        // 构建要显示的文本
        const displayText = text ? `${text} ${remainingTime} 秒` : `倒计时 ${remainingTime} 秒`;
        toast.show(displayText); // 显示内容

        remainingTime -= 2; // 每次减少 2 秒
        if (remainingTime <= 0) {
            clearInterval(interval); // 清除定时器
        }
    }, 2000); // 每 2 秒调用一次
}

// 使用示例
countdownEx(10); // 仅提供剩余时间
countdownEx("剩余时间", 10); // 文本在前，仍然有效
countdownEx(5, "倒计时"); // 正常使用