حقول الصور

يخزن حقل الصورة سلسلة كقيمته، والسلسلة كنص له. وقيمتها هي src للصورة، في حين أن نصها عبارة عن سلسلة بديلة تصف/تمثل الصورة.

حقل الصورة

حقل الصورة على الجزء المصغَّر

إنشاء الفيديوهات

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);
}