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

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

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

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