概述
插值是指用变量的内容替换文本中的{变量名}。插值的结果是一段新的文本。
当参数输入框的内容以“”开始时(在输入框的最前面,不是每一行的前面,也不是每个变量的前面),对后面的内容进行插值处理(同时去掉开头的)。
示例
假如变量{Text}的值为“Quicker”,那么下面的内容
- 在插值中使用一般变量(文本、数字、日期)
$$你好,{Text}!
在插值后变为:
你好,Quicker!
- 在插值中使用词典变量
方法1:{词典变量[“key1”]}
方法2:{词典变量.key1}
- 在插值中使用列表
方法1:{列表变量[0]}
方法2:{词典变量.0}
插值后得到的文本可能会做进一步处理才会得到最终的结果,具体的处理过程可以参考“参数传递”章节。
“列表”类型的变量,可以用 {变量名.序号} 的方式插入列表某个元素的值。序号以0开始。需要注意中间不能用额外的空白。
“词典”类型的变量,可以用 {变量名.键} 的方式插入某个键的对应值。需要注意中间不能用额外的空白。
剪贴板文本,可以使用 {[cliptext]} 的方式插入。
【注意事项】
- {} 中的内容前后不能有多余的空格。比如这些都不会被插值处理:{ xxx} {xxx } { xxx }。
- {} 中不能包含“{”或“}”字符。
- 变量名必须紧跟{开始。变量名后面可以为”}”、“.”或“[”,否则会造成在更改变量名时无法找到。每个{}内只能使用一个变量。
- 如果希望输出
$$
开始的纯文本内容而不是进行插值处理,可以改用表达式进行文本拼接,例如$="$$" + {name} + "你好!"
请参考此贴。
变量表达式
【以下需1.9.5+版本支持】
有时候需要在输出时对变量内容做简单处理(如进行URL编码),可以通过以下方式进行:
以下红色部分为判断依据。
{变量.方法()} 例如:
{文本变量.UrlEncode()}
可调用的方法以变量所对应的c#类型为准。文本类型另外支持UrlEncode()和UrlDecode()方法。
{变量[列表序号或词典Key]…..} 例如:
{列表变量[0]}
{列表变量[0].ToUpper().UrlEncode()}
{词典变量["key1"]}
{词典变量["key1"].ToString().ToUpper().UrlEncode()}
{表达式=} 会对表达式进行计算。(请不要在中间使用变量,否则在更改变量名的时候无法找到) 例如:
{3+3=} 输出“6”
{DateTime.Now.ToString("yyyy-MM-dd")=}
示例动作:https://getquicker.net/sharedaction?code=aa38d2b9-f95b-4a91-d713-08d827485760
插值嵌套
自1.4.22版本之后开始支持。
如果插值后得到的结果文本以“$$”或“$=”开始,则会对结果再次进行1次插值或表达式计算。得到的结果如下:
- 以“$$$$”开始:插值后对得到的内容再次插值。
- 以“$$$=”开始:插值后对得到的内容进行表达式计算。
- 不支持先表达式后插值($=”$${变量}”)!
组合成文本
请参考“组合成文本”模块说明。