jokymouse.dialog API
jokymouse.dialog 模块通过 require("jokymouse.dialog") 加载,负责在运行关键节点向用户显示统一的提示框和确认框。
local dialog = require("jokymouse.dialog") 可用函数
| 函数 | 签名 | 说明 |
|---|---|---|
| notify | dialog.notify(text, opts?) | 显示提示消息框 |
| confirm | dialog.confirm(text, opts?) | 显示确认框,返回 true / false |
notify
dialog.notify("脚本执行完成", {
title = "小丑鼠",
type = "info"
}) type 支持:
infowarnerror
confirm
local ok = dialog.confirm("确定继续吗?", {
title = "确认操作"
}) 用户确认时返回 true,取消时返回 false。
适合使用的场景
- 在脚本真正开始前提醒用户做好窗口准备。
- 在检测到高风险操作前让用户手动确认。
不适合使用的场景
- 高频循环里的进度播报。
- 想把 dialog 当成任意自定义窗口系统来使用。
- 需要文本输入、复杂表单、富文本、图片或多步骤引导。
示例
local jm = require("jokymouse")
local dialog = require("jokymouse.dialog")
dialog.notify("请先把目标窗口切到前台", {
type = "warn"
})
local ok = dialog.confirm("接下来会开始自动点击,是否继续?")
if not ok then
jm.exit("用户取消执行")
end 如果脚本还需要读取 settings 或控制输入,请回到 jokymouse API。