状态存取

状态存取模块包含这几类功能:

  • 存取保存在计算机上的状态数据 ;
  • 更新动作的“修饰”(如徽标图标/徽标文字);
  • 为动作设置附加的右键菜单;



存取状态数据

用于保存某项数据在本地电脑上,在下次执行动作的时候可以读取使用。就好比很多软件都会有一个.ini的配置文件保存一些用户设置一样。


一个动作可以使用多个状态项,他们以“键”-“值”对的形式保存。


常用场景

比如可以用于如下情况:

  • 存储软件在本机的路径。当一个动作依赖于软件路径时,如果将文件路径写死在动作里,这个动作在另外一个电脑上可能就会因为路径改变的问题无法正常运行。
  • 每次点击动作执行不同的操作。比如第一次点击执行A,第二次点击执行B。
  • 其他需要将信息保留到下次执行动作的情况等。


版本1.3.0+】 如果不需要控制读取和写入状态的时间,也可以直接将变量设置为“作为状态使用”。在动作执行之前从状态加载变量值,在动作执行后将变量值保存在状态中。请参考:https://www.yuque.com/quicker/help/variables/edit#4e0f2f58


读取状态

读取某个状态的值。


在【操作类型】中选择“读取动作状态”。

image.png

参数说明:

【名称 / 键】状态的条目名称。类似于变量名。

【默认值】如果之前没有存储状态,读取时候返回的默认值。

【为空时请用户输入】如果之前没有存储状态,并且默认值也为空,这时候是否提示用户输入这个状态的值。

【用户输入提示】弹窗输入状态值的时候,输入窗口的标题,主要是为了给用户提示要输入的内容。


输出参数:

【是否成功】是否读取成功。

【值】读取到的状态值。

【是否为空】读取的值是否为空。有时候方便使用为空



写入状态

向某个状态写入值。


在操作类型中选择“写入动作状态”。在表单中输入状态名和要写入的值即可。

image.png


如果写入的状态值为*NULL*,则删除此状态数据。


状态数据的存储


一个动作的所有状态使用json格式保存在 C:\Users\用户名\AppData\Local\Quicker\states 目录下,文件名为 "state_动作ID.json"。


清理动作数据

如果动作保存了状态数据,可以在动作上点右键,在上下文菜单里选择“信息”-》“删除动作状态数据和修饰”。

如果希望查看或手动编辑状态数据文件,可以按Shift点击删除状态数据菜单。

image.png


如何同步状态数据

Quicker自身没有状态数据同步的功能。

可以使用第三方工具如onedrive、坚果云等同步状态数据。

请参考:https://getquicker.net/KC/Kb/Article/187



示例动作






更新动作修饰

以下功能自1.9.13版本开始提供


在动作按钮上显示徽标文字(靠右)或徽标图标(靠左),也可以同时显示。

动作修饰.gif


设置的动作徽标信息会一直存在(即便动作已停止),除非在动作中将其设置为空。所以它和状态具有类似的性质,通常也会和状态一起使用:将某个信息(如控制动作功能的选项)保存在状态中,同时设置徽标,在动作上直接展示该信息。



设置徽标图标

显示在动作左上角的图标。

image.png

image.png


参数:

【徽标图标】使用 fa:图标名称:图标颜色 的格式设置图标。图标名称为Quicker内置矢量图标的名称,可以在图标管理窗口中查看。颜色使用#RRGGBB格式。参数内容为空时,会去除图标。


设置徽标文字

显示在动作按钮右上角位置的文字内容。可以控制底色/文字颜色和文字内容。

image.png

image.png

参数:

【徽标文字】要显示的文字内容。参数内容为空时去除徽标。请使用尽量简单的字母或数字。在低分辨率的屏幕上,因为文字较小,可能不容易分辨。

【徽标颜色】底色,使用#RRGGBB格式的颜色值。默认为红色。

【徽标文字颜色】文字颜色,使用#RRGGBB的格式指定。 默认为白色。


去除动作徽标

除了在动作中将徽标文字和徽标图标清空,也可以使用动作菜单将徽标内容和动作状态一起清空:

image.png


设置附加的右键菜单


image.pngimage.png

本功能提供了一个在动作中更新右键菜单的渠道。

右键菜单数据的格式请参考:https://www.yuque.com/quicker/help/action-custom-context-menu


注:通过本模块设置的右键菜单条目将显示在动作选项中设置的右键菜单条目下方。

可以结合2这两个设置右键菜单的功能:

  • 在动作选项中,设置固定的右键菜单条目。
  • 用本模块设置需要变化的右键菜单条目。


示例动作:


修饰数据的存储

动作的修饰数据保存在_action_adorn.json文件中,位于状态数据文件夹下(C:\Users\用户名\AppData\Local\Quicker\states)。



语雀在语雀上查看