حقول الصور

يخزِّن حقل الصورة سلسلة كقيمة له، وسلسلة أخرى كنص له. وقيمتها هي src للصورة، في حين أنّ نصها هو سلسلة alt التي تصف/تمثّل الصورة.

حقل الصورة

حقل الصورة في الكتلة المصغّرة

الإنشاء

JSON

{
  "type": "example_image",
  "message0": "image: %1",
  "args0": [
    {
      "type": "field_image",
      "src": "https://www.gstatic.com/codesite/ph/images/star_on.gif",
      "width": 15,
      "height": 15,
      "alt": "*"
    }
  ]
}

JavaScript

Blockly.Blocks['example_image'] = {
  init: function() {
    this.appendDummyInput()
      .appendField("image:")
      .appendField(new Blockly.FieldImage(
        "https://www.gstatic.com/codesite/ph/images/star_on.gif",
        15,
        15,
        "*"));
  }
};

يأخذ مصنّع الصور ما يلي:

المَعلمة	الوصف
src	سلسلة تشير إلى ملف صورة نقطية
width	يجب تحويلها إلى رقم غير صفري.
height	يجب تحويلها إلى رقم غير صفري.
opt_alt	(اختياري) سلسلة تصف الصورة أو تمثّلها بدقة يتم استخدام هذا الرمز بدلاً من الصورة عند تصغير المربّع. إذا كان null أو undefined، سيتم استخدام سلسلة فارغة.
opt_onClick	(اختياري) دالة يتمّ استدعاؤها عند النقر على الحقل.
opt_flipRtl	(اختياري) قيمة منطقية. إذا كان true، يتم عكس الصورة على المحور العمودي في الوضع "من اليمين إلى اليسار". الإعداد التلقائي هو false. يُستخدَم هذا المقياس لرمزَي "الانعطاف لليسار" و "الانعطاف لليمين".

نشر الحلقات على نحو متسلسِل

لا يمكن تسلسل حقول الصور.

معالِج النقرات

ملاحظة: للحصول على معلومات عن المدقّقين بشكل عام، يُرجى الاطّلاع على المدقّقون.

لا يقبل حقل الصورة مدقّقًا، بل يقبل بدلاً من ذلك دالّة يتمّ استدعاؤها عند النقر على الحقل. وهذا يعني أنّ الصور يمكن أن تعمل مثل الأزرار المتوفّرة في الكتل.

يمكن ضبط معالِج النقر في دالة إنشاء JavaScript أو باستخدام الدالة setOnClickHandler.

في ما يلي مثال على معالِج عند النقر الذي يُدمِج الكتلة عند استدعائه.

function() {
    this.getSourceBlock().setCollapsed(true);
}