kwgt $ 函数语法总览 怎么写怎么预览怎么插入
为什么函数这么重要
kwgt 画布上所有会变的东西——时间、电量、天气、音乐封面、HTTP 下载——全部靠 $ 函数实现。不会写函数，kwgt 就只是一个静态绘图器。
基本语法
$函数名(参数1, 参数2)$- 以
$开头，以$结尾 - 函数名是英文缩写（
df= date format，bi= battery info） - 参数用逗号分隔，字符串参数用单引号或双引号
- 可以嵌套：
$if(bi(level)<20, 'red', 'green')$ - 可以在同一个字段里放多个函数 + 静态文字混合：
电量 $bi(level)$%
在哪里用函数
几乎所有地方。只要你在属性面板里看到一个可以填文本的输入框，大概率支持函数：
- Text → 文字内容
- Paint → 颜色
- Layer → Position、Scale、Opacity
- Shape → 弧度、圆角
- Touch → 条件判断（"电量 > 50 时才能打开某些 App"）
- Root → 背景图、全局属性
函数浏览器
在任意属性字段 → 点输入框右侧的 fx 图标（或长按输入框）→ 弹出完整的函数列表，按类别分组：
| 类别 | 说明 | 举例 |
|---|---|---|
| Date & Time | 日期时间 | $df()$、$tc()$、$tf()$ |
| Battery | 电池 | $bi(level)$、$bi(charging)$、$bi(current)$ |
| System | 系统 | $sys(cpu)$、$sys(ram)$、$sys(wifi)$ |
| Weather | 天气 | $w(ct)$、$w(temp)$、$w(city)$ |
| Music | 音乐 | $mi(title)$、$mi(cover)$ |
| Math & Logic | 数学逻辑 | $if()$、$sin()$、$round()$ |
| Files & HTTP | 文件网络 | $http()$、$sqlite()$、$rss()$ |
| Globals | 全局变量 | $gv()$、$tv()$ |
| Astronomy | 天文 | $ai(sunrise)$、$ai(moon)$ |
| Google Fit | 运动健康 | $fit(steps)$、$fit(calories)$ |
| Misc | 杂项 | $br()$（换行）、$ut()$（随机） |
插入 vs 替换
在函数浏览器里：
- 单击函数：在当前光标位置插入（和已有内容拼接）
- 长按函数：替换输入框里全部内容
预览与错误提示
函数编辑框上方有一个实时预览区，会显示当前函数的实际运行结果：
- 正常函数 → 预览值（比如 "82%"、"Wednesday"）
- 语法错误 → 红色提示（"missing closing $"、"invalid function name"）
- 运行时错误 → 会渲染成空值或错误标记
新手遇到错误别慌：看预览区的提示就知道哪里写错了。