扩展现有字段

要扩展现有字段，您必须将内置字段（例如 FieldTextInput、FieldColour），然后根据需要修改其中的一部分。 您可以修改字段的某些部分：

如果您要创建一个 自定义字段 对于不需要任何内置字段的行为，您应该创建 Field 的子类。

常用扩展名

大多数自定义字段会扩展以下三种类型之一：

  • 文本输入：如果您希望用户在字段中输入内容，则应扩展 FieldTextInput。
  • 数字：如果要存储数字，则应扩展 FieldNumber。
  • 下拉菜单：如果您要创建一个下拉菜单，但希望它存储其他模型 默认字符串或图片模型，则应扩展 FieldDropdown。
    • 注意：在扩展 FieldDropdown 之前，请检查下拉字段的 自定义选项无法满足您的需求。

在某些情况下，您可能希望扩展不同的字段类型。对于 示例 FieldLabelSerializable 扩展了 FieldLabel。

子类化

import * as Blockly from 'blockly';

export class MyCustomTextField extends Blockly.FieldTextInput {

  constructor(value, validator, config) {
    super(value, validator, config);
  }
}

字段子类的构造函数与 自定义字段。子构造函数的签名应 通常与超构造函数的签名匹配。

JSON 和注册

您还应注册一次该字段：

Blockly.fieldRegistry.register('my_custom_text_field', MyCustomTextField);

并在类中提供 fromJson 的实现，以便它可以 JSON 格式：

static fromJson(options) {
  const value = Blockly.utils.parsing.replaceMessageReferences(options.value);
  return new MySubclassName(value);
}

如需详细了解如何注册字段，请参阅 JSON 和注册 部分。