用户选择

简介

“用户选择” 模块用于让用户从多个选项中选择一个(或多个)。比如下面的动作(点击查看动作),让用户选择一个时间格式以插入到当前文档中:

当用户点击一个选项的时候,会选中此选项并关闭选择窗口。


单选与多选

用户选择支持“单选”和“多选”两种操作类型。

单选时,输出内容为选择选项值文本;多选时,输出内容为选择选项值的列表。

image.png


参数说明

提示文字:选项窗口的标题文字。

选项:定义列出的可选择项。如果显示的文字和值(选择后输出的结果)不一致,比如本例中选择 “2018-12-01” 之后,输出 “yyyy-MM-dd” 到结果,这时候使用格式 显示文字| 的方式填写,如“2018-12-01|yyyy-MM-dd”。如果显示的文字和输出的结果一致,则直接写相应的内容就可以了,如 “yyyy-MM-dd” 。

默认值:默认选中的选项的值。从1.1.2版本开始,也可以输入序号数字(从0开始,仅支持选择1项)。会先匹配选项的值,匹配成功则选中对应项。如果不成功,会判断是不是一个数字,如果是数字的话就按序号选则项。

窗口位置:选项窗口的显示位置。

不使用焦点:必须使用鼠标选择,不能使用键盘选择。 此时窗口不会抢占输入焦点。

【自动关闭】几秒钟后如果未操作则自动关闭选择窗口,0表示不自动关闭。 如果预先选中了选项,则自动保存;否则自动取消。

【启用筛选】当选项比较多的时候,可以使用筛选功能快速找到选项。

image.png

【恢复活动窗口】选择过后,是否将输入焦点还原到显示选择之前的窗口上。


多行选项

如果需要在选项中间换行,可以插入\n字符。

示例:https://getquicker.net/sharedaction?code=5b3f7484-d1f9-46c7-a49c-08d70bf0ab12 (选择多行文本后显示)


使用场景

  1. 将多个类似的动作组合在一起:
    • 从一组常用的网址中打开一个(参考:Quicker网站 );
    • 从一组常用的输入中(比如地址、电话、qq号等),选择一个发送到窗口(参考:快捷短语);
    • 从一组常用的软件中打开一个,参考动作:常用软件
    • 从一组常用的文件夹中打开一个;
  1. 选择后续动作的分支:选择一个值后,结合 “如果” 模块执行不同的操作。参考动作:示例:选择并执行动作
  2. 选择某个动作模块的参数,如选择时间的格式等。参考动作:插入日期时间 


更新历史

  • 1.1.2 增加自动关闭参数(指定秒数后未操作,则自动保存选中的项。如果未选中在,则取消操作);默认值支持使用序号指定默认选择的项。
  • 1.1.12 增加筛选功能。
语雀在语雀上查看