可序列化标签字段

可序列化标签的工作原理与普通标签完全相同,不过它们也会序列化为 XML。只有在以编程方式修改标签的内容并希望将其序列化为 XML 时,才应使用这些选项。

可序列化标签字段

收起块上的可序列化标签字段

恣意创作

JSON

{
  "type": "example_serializable_label",
  "message0": "%1",
  "args0": [
    {
      "type": "field_label_serializable",
      "name": "FIELDNAME",
      "text": "a serializable label"
    }
  ]
}

JavaScript

Blockly.Blocks['example_serializable_label'] = {
  init: function() {
    this.appendDummyInput()
        .appendField(new Blockly.FieldLabelSerializable("a serializable label"), "FIELDNAME");
  }
};

可序列化标签字段接受一个可选值和一个可选的 css 类字符串。两者均默认为空字符串。

序列化

JSON

可序列化标签字段的 JSON 如下所示:

{
  "fields": {
    "FIELDNAME": text
  }
}

其中,FIELDNAME 是引用可序列化标签字段的字符串,值是要应用于该字段的值。该值遵循的规则与构造函数值相同。

XML

可序列化标签字段的 XML 如下所示:

<field name="FIELDNAME">text</field>

field 节点的 name 属性包含一个引用可序列化标签字段的字符串,该节点的内部文本是要应用于该字段的值。

验证器

可序列化标签字段不支持验证器,因为用户无法修改它们。