从搜索框给动作传递参数

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

简单传递

操作方式:

  • 输入动作关键词,找到动作后按Tab键选定动作
  • 输入要传递给动作的参数,按回车运行动作。

普通搜索传递参数.gif

在动作中:

  • 可以通过 {quicker_in_param} 变量读取输入的参数。
  • 也可以在“获取选中的文本”模块中开启“如果为动作传递了参数,使用参数值作为获取的结果”选项,使动作既可以使用普通操作方式(选中文本后运行动作),也可以直接在搜索框里输入要操作的文本。




动态搜索

在搜索框输入内容时调用动作并传入参数 search:搜索词 。根据动作返回的内容生成结果条目。

示例动作

实时搜索.gif

实现方法:

1)在动作中开启支持实时搜索的选项。

image.png

2)判断如果是否为搜索框传入的参数,如果是,则对搜索内容进行处理并返回结果。

表达式:`$= {quicker_in_param}.StartsWith("search:")`    

image.png

image.png

3) 返回结果的格式:

image.png

每行输出一个结果选项。

[图标]文字(描述文字)|operation=选择选项后的操作&data=要操作的值的URL编码 

  • 图标格式与“用户选择”“文本窗口菜单”等位置一样。
  • |后面的内容需要时合法的querystring,因此data数据通常需要进行url编码。
  • operation表示选择选项后执行的操作类型。



通过面板或快捷键触发动作时进入搜索模式

如果动作的主要功能为实时搜索,可能会希望通过快捷键直接启动搜索框并使用这个动作开始搜索。

可以在动作中增加“Quicker操作”模块,类型选择“使用当前动作进行实时搜索”操作类型。

image.png

在动作中可以使用这样的判断过程:

  • 如果动作参数以 ​search:​ 开始,表示正在搜索框中进行实时搜索。此时处理搜索内容并返回结果即可。
  • 如果动作参数为空,表示是通过其他方式启动动作,可以使用上述模块开启搜索模式。

image.png




语雀在语雀上查看