Blockly 中文文档

# 变量字段

变量字段存储字符串作为其值，存储字符串作为其文本。该值是变量的 ID，而文本是变量的名称。

# 变量字段

# 打开编辑器的变量字段

# 收起块上的变量字段

# 创建

# 无类型

# 类型化

变量构造函数接受可选的变量名称、可选的 校验器、可选的变量类型数组以及可选的默认类型。

  • 变量名称应为字符串。这是字段存储的初始变量的名称。如果此值为 null 或未定义，系统会生成一个唯一名称。
  • 变量类型应为字符串数组。此属性用于告知字段可存储哪些类型的变量（即要向下拉菜单中添加的变量类型）。如果值为 null 或未定义，则系统接受所有变量类型（并将其添加到下拉列表中）。
  • 默认类型应为字符串。这将在创建字段的初始变量模型时使用。如果已定义，则应将其包含在变量类型数组中。如果此值为 null 或未定义，则此值默认为空字符串，这意味着初始变量可灵活输入。

→ 如需详细了解严格输入，请参阅 类型检查。

# 序列化

# 创建变量校验器

TIP

注意：如需查看有关校验器的一般信息，请参阅 校验器。

变量字段的值是一个字符串，因此任何校验器都必须接受字符串并返回字符串 null 或 undefined。

下面是一个仅接受部分预定义变量作为选项的验证程序示例。加载工作区时，需要使用 Workspace.createVariable (opens new window) 函数定义这些变量。

function(newValue) {
  var validIds = ['Worf', 'Riker', 'Picard'];
  if (validIds.indexOf(newValue) == -1) {
    return null;
  }
  return newValue;
}

← 总览 →