参数¶

函数所需的命名值。例如，内置 command 函数需要一个名为 command 的参数。您提供参数 button 上的值。

一些参数是必需的；其他是可选的，默认值定义在函数文件。

从按钮传递一个值¶

将参数名称作为键直接写在按钮上。内置的 command、path、args字段遵循此规则，自定义参数名称的工作方式相同。

提供自定义参数名称

Recent service logs

- name: Nginx logs
  type: button
  function: journal-unit
  unit: "nginx.service"
  lines: 100

unit 和 lines 必须由 journal-unit 声明。数值为 lines 不需要加引号。

不要使用嵌套 params: 映射

自定义函数文件使用 params: 来声明其参数。一个按钮没有。将 host:、unit: 或任何其他值直接放在按钮上。

当按钮省略可选参数时，可选参数将使用其默认值。

参数名称不能与按钮设置相同：name、type、icon、 id、function、confirm、timeout、workdir、env、columns 或 items。允许使用名称 command、path 和 args。

请参阅函数 → 从按钮传递值以获得完整的解释和示例。

按钮设置和参数键请参见配置→菜单。