用 Javascript 在 iOS 桌面书写 Scriptable 组件：从入门到精通

在 iOS 桌面小组件的世界里，Scriptable 异军突起，以其 Javascript 脚本功能脱颖而出。对于想要释放创造力并打造个性化桌面的 iOS 用户来说，这是一件利器。然而，对于初学者来说，Scriptable 的门槛似乎有些高，官方文档也显得有些简陋。

本指南旨在填补这一空白，提供一个循序渐进的教程，帮助你轻松上手 Scriptable，用 Javascript 编写令人惊叹的桌面组件。从基本概念到高级技巧，我们都将逐一详解，让你成为 Scriptable 的大师。

从零开始

创建你的第一个组件：

通过 ListWidget 的 addStack() 方法新建组件。当 len = 0 时，它会创建一个空堆栈，你可以添加其他小组件。使用 addText() 方法添加文本，用 addImage() 方法添加图像。

const widget = new ListWidget();
widget.addStack();
widget.addText("Hello World");
widget.addImage("image.png");

探索 Scriptable 的强大功能

自定义外观：

利用 CSS 样式来控制组件的外观。例如，你可以设置字体、颜色和背景。

widget.setPadding(10, 10, 10, 10);
widget.setTextColor(Color.white());
widget.backgroundColor = Color.blue();

添加交互性：

为你的组件添加交互性，比如点击触发动作。使用 onTap() 方法指定当用户点击组件时要执行的脚本。

widget.onTap = () => {
  Safari.open("https://example.com");
};

进阶技巧

使用第三方库：

扩展 Scriptable 的功能，通过第三方库获得更多特性。例如，使用 "scriptable-qrcode" 库生成二维码。

const QRCode = importModule("scriptable-qrcode");
const qrCode = QRCode.generate("Hello World");
widget.addImage(qrCode);

创建动态组件：

使你的组件对外部数据做出反应。使用 updateWidget() 方法定期更新组件的内容。

const script = new Script();
script.setWidget(widget);
script.refresh = () => {
  // 更新组件内容
};

将组件分享给世界：

将你令人惊叹的组件分享给其他人。使用 "Share Widget" 选项导出组件的脚本。

结语

Scriptable 的强大功能打开了无限的可能性，让你打造出既美观又实用的 iOS 桌面组件。通过掌握我们提供的技巧和实践，你将成为 Scriptable 的专家，用 Javascript 编写令人惊叹的桌面小组件。让你的桌面脱颖而出，释放你的创造力！