שדות תמונה

שדה תמונה מאחסן מחרוזת כערך ומחרוזת כטקסט. הערך שלו הוא ה-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,
        "*"));
  }
};

ה-constructor של קובץ האימג' מקבל את הפרמטרים הבאים:

פרמטר	תיאור
src	מחרוזת שמפנה לקובץ תמונה רסטר.
width	צריך לבצע המרה למספר שאינו אפס.
height	צריך לבצע המרה למספר שאינו אפס.
opt_alt	(אופציונלי) מחרוזת שמתארת או מייצגת במדויק את התמונה. המערכת משתמשת בתמונה הזו במקום בתמונה הראשית כשהבלוק מכווץ. אם הערך הוא null או undefined, המערכת תשתמש במחרוזת ריקה.
opt_onClick	(אופציונלי) פונקציה שתופעל כשלוחצים על השדה.
opt_flipRtl	(אופציונלי) ערך בוליאני. אם הערך הוא true, התמונה תוצג במצב הפוך בציר האנכי כשהיא תופעל במצב מימין לשמאל. ברירת המחדל היא false. שימושי לסמלים של 'פנייה שמאלה' ו'פנייה ימינה'.

סידור הפרקים

אי אפשר ליצור רצף של שדות תמונה.

טיפול בקליקים

הערה: מידע כללי על מאמתים זמין במאמר מאמתים.

שדה התמונה לא מקבל מאמת, אלא פונקציה שמופיעה באופן מפורש בכל פעם שלוחצים על השדה. כלומר, תמונות יכולות לפעול כמו לחצנים שקיימים בבלוק.

אפשר להגדיר את הטיפול בקליק במגדיר ה-JavaScript או באמצעות הפונקציה setOnClickHandler.

זוהי דוגמה לטיפול בקליק שמכווץ את הבלוק כשמפעילים אותו.

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