变量

什么是变量

可以把变量理解成 “盒子” 。变量的值,便是盒子里存放的物品。 变量的 “标识” ,可以理解为给盒子取的名字,或者在盒子上贴的标签,用以区分是哪个盒子。每个变量有一种类型,可以看作这个盒子只能存放某种类型的东西。默认值可以理解为盒子里最初存放的物品。

如下图所示:把“获取选择的文本”的结果输出到了“选择的文本”变量中。然后使用“文本处理”模块,将“选择的文本”处理后输出到“结果文本”变量中。最后通过“发送文本到窗口”模块,将“结果文本”输出。


image.png

高级组合动作的每个步骤模块,可以理解为从需要的盒子里取出存放的物品(输入),经过某种处理后,再存放到原来的或另外的盒子里(输出)。

当前所支持的变量类型:

  • 文本:字符串;
  • 图片:从剪贴板或文件中读取的图片内容;
  • 布尔:表示“真/是” 或 "假/否" ;
  • 列表:表示一组字符串,比如选中的多个文件的路径等;
  • 日期时间:表示时间值;
  • 数字:数字值;


变量的使用

将变量的值作为参数输入到模块

模块的输入参数通常可以直接指定或使用变量的值。如下图所示,选择使用了“context”变量的值作为“待处理内容”参数的输入。

image.png


将模块的输出写入变量

在模块的“输出”部分,可以选择每个输出要写入哪个变量。如下图所示,选中文字的内容输出到了“context”变量中,操作是否成功的结果输出到了“选中文本”变量中。

image.png


变量操作

变量列表

image.png

基本的变量操作:

  • 创建变量:点列表上面的十字图标;
  • 编辑变量:点击变量后的铅笔图标;
  • 删除变量:点击变量后的X图标;
  • 调整变量的显示顺序:按住拖动变量条目;
  • 清理不使用的变量:点击列表上面的垃圾箱图标;

创建变量

点击列表上的“image.png”即可开始创建变量。

image.png

变量名:变量的唯一标识。可以为英文和中文,不要有空格和特殊字符。尽量根据变量的用途(存储的内容)来命名变量。如“selectedText”,"isDone"等。

类型:变量的类型。

备注:变量的注释,用于提示自己变量的用途或注意事项等。

默认值:变量的初始值。


默认值的写法

变量类型

默认值写法

示例

文本

直接写文字内容,支持多行。

你好,欢迎使用Quicker!

图标

(不支持默认值)


布尔

true或1 表示真

false或0 表示假

true

数字

数字值

234.56

日期时间

数字或日期值。 数字表示当前时间增加或减少的天数。日期值表示指定时间。

2019-4-1 12:30:00

5 (表示当前时间加5天)

列表

多行,每行表示列表的一项

北京

上海

广州

深圳

词典

支持两种格式:

简单格式:多行,每行一个键值对。

JSON格式:以json:开始,后面紧跟json内容。

简单格式:

China:中国

USA:美国

---

JSON格式:

json:{"China":"中国", "USA": "美国"}


编辑变量

点击变量名后的image.png或双击变量名即可编辑变量。

image.png

在变量编辑窗口中输入新的变量信息后保存即可。


在编辑模块时创建变量


在添加或编辑步骤模块时,如果在可选的变量列表中没有合适的可用变量,可以点击“创建变量...”选项创建一个新的变量。

image.png

语雀在语雀上查看