حقول الصور

يُخزن حقل الصورة سلسلة كقيمتها وسلسلة كنص لها. من هي قيمة 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);
}