自定义参数_Scriptable神器实战7 —— 获取用户添加组件时的自定义参数

往期推荐0 1

Scriptable 神器试玩，创建一个显示自定义标题内容的 iOS14桌面组件

0 2

Scriptable 神器实战2 —— 给桌面组件添加自定义背景图片

03

Scriptable 神器实战3 —— 夜间模式动态展示

04

Scriptable 神器实战4 —— 获取桌面组件的大小以自动展示内容

05

Scriptable 神器实战5 —— 给桌面组件添加一个渐变色背景

06

Scriptable神器实战6 —— 给背景图片加上半透明遮罩

这期讲解

我们在添加桌面组件的时候，会有一个 Parameter 的用户输入配置

这个配置是干嘛的呢？

比如我写了一个插件，可以支持显示最新的文章和最热的文章，但是显示哪个分类，需要由用户来决定。

于是我就在脚本中定义了获取参数，用户在添加组件时，在 Parameter 参数里输入了【最新】字符串的话，脚本就获取最新的文章，否则获取最热的文章。

这就是这个参数存在的意义，允许获取用户的配置，来动态展示处理内容，给用户更丰富的功能体验。

代码实战

实现获取用户的输入非常的简单，我们只需要用到官方 API 的一个全局变量参数：

args.widgetParameter

我们写一个非常简单的demo代码，直接展示用户输入的参数：

let widget = new ListWidget()widget.addText(args.widgetParameterScript.setWidget(widget)Script.complete()

保存，到桌面添加组件，选择刚刚保存的脚本，参数里输入任意字符串，完成，即可在桌面看到显示你刚刚输入的参数字符串了。

很简单，so easy！打开 Scriptable 试一试！