概述

插值是指用变量的内容替换文本中的{变量名}。插值的结果是一段新的文本

当参数输入框的内容以“”开始时(在输入框的最前面,不是每一行的前面,也不是每个变量的前面),对后面的内容进行插值处理(同时去掉开头的)。
文本插值 - 图1

示例

假如变量{Text}的值为“Quicker”,那么下面的内容

  • 在插值中使用一般变量(文本、数字、日期)

$$你好,{Text}!
在插值后变为:
你好,Quicker!

  • 在插值中使用词典变量

方法1:{词典变量[“key1”]}
方法2:{词典变量.key1}

  • 在插值中使用列表

方法1:{列表变量[0]}
方法2:{词典变量.0}

插值后得到的文本可能会做进一步处理才会得到最终的结果,具体的处理过程可以参考“参数传递”章节。

“列表”类型的变量,可以用 {变量名.序号} 的方式插入列表某个元素的值。序号以0开始。需要注意中间不能用额外的空白。
“词典”类型的变量,可以用 {变量名.键} 的方式插入某个键的对应值。需要注意中间不能用额外的空白。
剪贴板文本,可以使用 {[cliptext]} 的方式插入。

【注意事项】

  • {} 中的内容前后不能有多余的空格。比如这些都不会被插值处理:{ xxx} {xxx } { xxx }。
  • {} 中不能包含“{”或“}”字符。
  • 变量名必须紧跟{开始。变量名后面可以为”}”、“.”或“[”,否则会造成在更改变量名时无法找到。每个{}内只能使用一个变量。
  • 如果希望输出$$开始的纯文本内容而不是进行插值处理,可以改用表达式进行文本拼接,例如$="$$" + {name} + "你好!" 请参考此贴

变量表达式

【以下需1.9.5+版本支持】
有时候需要在输出时对变量内容做简单处理(如进行URL编码),可以通过以下方式进行:
以下红色部分为判断依据。

  • {变量.方法()} 例如:

    1. {文本变量.UrlEncode()}
    2. 可调用的方法以变量所对应的c#类型为准。文本类型另外支持UrlEncode()和UrlDecode()方法。
  • {变量[列表序号或词典Key]…..} 例如:

    1. {列表变量[0]}
    2. {列表变量[0].ToUpper().UrlEncode()}
    3. {词典变量["key1"]}
    4. {词典变量["key1"].ToString().ToUpper().UrlEncode()}
  • {表达式=} 会对表达式进行计算。(请不要在中间使用变量,否则在更改变量名的时候无法找到) 例如:

    1. {3+3=} 输出“6
    2. {DateTime.Now.ToString("yyyy-MM-dd")=}

示例动作:https://getquicker.net/sharedaction?code=aa38d2b9-f95b-4a91-d713-08d827485760

插值嵌套

自1.4.22版本之后开始支持。
如果插值后得到的结果文本以“$$”或“$=”开始,则会对结果再次进行1次插值或表达式计算。得到的结果如下:

  • 以“$$$$”开始:插值后对得到的内容再次插值。
  • 以“$$$=”开始:插值后对得到的内容进行表达式计算
  • 不支持先表达式后插值($=”$${变量}”)!

组合成文本

请参考“组合成文本”模块说明。