Skip to main content

速查地图

如果只想拍马上手,直接看 做出第一个卡片 —— 跟着走一遍就能跑出一张能用的卡片。

下面是常用语法 / API 一表搜:

占位符​

${var}                  普通字段(content / fontSize / forColor / src ...)
${a.b.0.c}              点号路径 + 数组索引
{rows[row]}             容器 dataSource 字段,循环数组

详见 占位符语法。

卡片形态​

形态尺寸入口
桌面 desk1*2 / 2*2 / 2*4 / 4*4主屏幕添加卡片
锁屏 locklock_1*1 / lock_1*2锁屏编辑态添加卡片位

锁屏卡片添加后先选卡再显示,流程见 锁屏卡片。

常用 JS​

// 网络
const obj = await new Request(url).fetchJSON()

// 本地文件
const bytes = await new Request(url).fetch()
const path  = await FileManager.write("x.png", bytes)   // → "files/x.png"

// 持久化(类型保真,JSON 兼容)
Config.set("key", val)
const v = Config.get("key", 0)            // 缺失返 0,number 类型保留

// 用户参数(类型保真)
const city = Setting.get("city", "北京")
Setting.set("city", "上海")

// 设备信息
Device.locale                              // "zh-Hans-CN"

// 调度
setUpdateFreq(30)                          // 30 分钟后再唤起

// 调试
console.log("...")
if (isDebug()) { /* 编辑器才会进 */ }

完整 API 列表​

模块看哪儿
配置 / 持久化Config
网络请求Network
文件读写FileManager
设备信息Device
卡片控制(刷新 / 跳转)Control
日志Console

组件​

类型看哪儿
文本 TextText
时钟 TextClockTextClock
计时器 TextTimerTextTimer
图片 ImageImage
图标 IconIcon
按钮 ButtonButton
容器(Row/Column/Stack/...)Stack
网格 GridGrid
占位 BlankBlank