变量

因软件更新较快,部分文档内容与软件最新版本有所出入,请知悉。

概述

变量用于在步骤之间传递信息。前面步骤的输出,保存在变量里,作为后面步骤的输入使用。


什么是变量

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

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



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

当前所支持的变量类型:

基础类型:

  • 文本:字符串;
  • 图片:从剪贴板或文件中读取的图片内容;
  • 布尔:表示“真/是” 或 "假/否" ;
  • 日期时间:表示时间值;
  • 数字:浮点数(支持小数)数字值;
  • 数字(整数):整数类型的数字;

高级类型:

  • 列表:表示一组字符串,比如选中的多个文件的路径等;
  • 词典:键-值对数据类型;
  • 动态对象:c# Object对象。


变量的使用

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

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


将模块的输出写入变量

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


变量操作

变量列表

基本的变量操作:

  • 创建变量:点列表上面的十字图标;
  • 编辑变量:点击变量后的铅笔图标;
  • 删除变量:点击变量后的X图标;
  • 调整变量的显示顺序:按住拖动变量条目;
  • 清理不使用的变量:点击列表上面的垃圾箱图标;
  • 排序变量:按字母顺序排列变量。 (1.2.x版本增加)
  • 拖动变量到“+”按钮:快速创建类似变量;


变量列表在变量数量超过10个时显示筛选框。

变量前面可能还会有一些图标显示变量的特殊用途。将鼠标悬浮在图标上可以看到说明提示。



创建变量

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



变量名:变量的唯一标识。可以为英文和中文,不要有空格和特殊字符。尽量根据变量的用途(存储的内容)来命名变量。如“selectedText”,"isDone"等。如果动作比较复杂,可以按"前缀_变量名"的方式命名变量以方便了解变量在什么功能模块中使用,以及分组和查找变量。另外请注意:

  • 变量名不要使用纯数字。
  • 在插值操作时,会对变量依次替换,请确保在前面的变量插值后不会产生 {后面的变量名} 这样的内容,否则会将这个内容替换为后面变量的值。



类型:变量的类型。

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

默认值:变量的初始值。

注:在1.12之后的版本中,默认值里也可以使用表达式用以动态生成变量初始值。不过需注意,一般不要使用表达式,表示式中尽量避免引用其他变量(不能引用后面变量)。


作为状态使用:在动作运行之后,将变量的值保存在动作中。在下次运行动作时,自动读取状态并写入变量值中。当需要在多次运行动作之间保持变量的值时使用。状态的使用请参考“状态存取模块”。变量的值在状态中保存的key为“$var:变量名”。(1.3.0版本增加)

作为状态使用的变量,只有在动作正常结束以后才会写入状态,因此请不要在长期运行的动作中使用此选项(容易造成变量内容没有写入到动作中)



默认值的写法

变量类型

默认值写法

示例

文本

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

你好,欢迎使用Quicker!

图标

(不支持默认值)


布尔

true或1 表示真

false或0 表示假

true

数字

数字值

234.56

数字(整数)

整数数字

123

日期时间

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

2019-4-1 12:30:00

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

列表

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

北京

上海

广州

深圳

词典

支持两种格式:

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

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

简单格式:

China:中国

USA:美国

---

JSON格式:

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


对象

表示任何的C#对象,可能是简单的数字、文本,也可能是列表等复杂类型。可以在表达式中调用对象的方法。


编辑变量

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

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


在编辑模块时创建变量


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

反馈与讨论

使用问题 · 152
0206jlk 2023-12-29 13:37 0206jlk 2023-12-29 14:03
使用问题 · 77
Nicholas LIU 2023-12-27 16:44 CL 2023-12-27 17:19
使用问题 · 76
CTO 2023-12-13 17:07 CL 2023-12-13 17:27
语雀在语雀上查看