定义 - define

介绍

通过使用 define 配置项,可以在物品执行操作时提前定义一些变量,以方便后续使用。定义的数据和变量不会存储到物品上,并且 define 配置项的执行顺序在 data 配置项之前。

请注意,在 define 配置项中,无需使用引用表达式 ${},并且支持使用脚本语法,如 JavaScript。

注意:define 仅支持直接编写基本数据类型,如数字、字符串、小数等,当该数据是由复杂表达式,即函数、列表、字典等其他复杂语法生成时,请使用单引号包裹。

语法

大致使用方法如下:

define:
  变量名1: 值1
  变量名2: 值2
  变量名3: 值3
  #...: ...

示例

考虑一个物品,其中包含 define 和 data 两个配置项的定义:

define:
  var1: "Hello"
  var2: 42

data:
  count: var2 + 10

在这个示例中,define 配置项提前定义了两个变量:var1 和 var2。这些变量可以在后续操作中使用,例如在数据处理或函数调用过程中引用它们。定义的数据和变量不会存储到物品上。

请注意,define 配置项的执行顺序在 data 配置项之前,确保在使用 data 中的数据之前已经定义了所需的变量。

Last updated