حقول التصنيفات القابلة للتسلسل

تعمل التصنيفات القابلة للتسلسل تمامًا مثل التصنيفات العادية. باستثناء أنها تتوالى أيضًا بشكل تسلسلي إلى 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 اختياري سلسلة class. يتم ضبط كلتاهما تلقائيًا على سلسلة فارغة.

التسلسل

JSON

يبدو ملف JSON لحقل تصنيف قابل للتسلسل كما يلي:

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

حيث يكون FIELDNAME عبارة عن سلسلة تشير إلى حقل تصنيف قابل للتسلسل، تكون القيمة هي القيمة المراد تطبيقها على الحقل. القيمة ويتبع نفس القواعد مثل قيمة الدالة الإنشائية.

XML

يبدو رمز XML الخاص بحقل تصنيف قابل للتسلسل كما يلي:

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

تحتوي السمة name للعقدة field على سلسلة تشير إلى جهاز قابل للتسلسل. التسمية، والنص الداخلي للعقدة هو القيمة التي سيتم تطبيقها على الحقل.

أدوات التحقُّق

لا تتوافق حقول التصنيفات القابلة للتسلسل مع المدقّقات لأنّها غير متاحة. قابلة للتعديل من قبل المستخدم.