אפשרויות הזרקה

הזרקה

אפשר להחדיר סביבת עבודה של Blockly באמצעות קריאה ל-Blockly.inject(location, options). הארגומנט הראשון מציין ל-Blockly איפה להחדיר את סביבת העבודה ב-DOM. הארגומנט השני הוא מילון של צמדי שם-ערך שמשמש להגדרה. קוד ההזרקה מנתח את מילון האפשרויות למכונה של Blockly.Options.

יצירה ישירה

אפשר גם ליצור סביבת עבודה ישירות באמצעות קריאה ל-Blockly.WorkspaceSvg(new Blockly.Options(options)). חשוב לזכור שצריך להפעיל את new Blockly.Options(options) ולהעביר את מילון האפשרויות. ה-constructor של סביבת העבודה מצפה למכונה של Blockly.Options, ולא למילון פשוט של אפשרויות.

מילון האפשרויות

האפשרויות הבאות נתמכות. שימו לב שחלק מהאפשרויות האלה משנות את ערך ברירת המחדל שלהן בהתאם לכך שיש או אין קטגוריות בכלי העבודה שסופק.

שם	סוג	תיאור
collapse	בוליאני	מאפשרת לכווץ או להרחיב בלוקים. ערך ברירת המחדל הוא true אם לתיבת הכלים יש קטגוריות, ו-false אחרת.
comments	בוליאני	מאפשרת להוסיף תגובות לקטעים. ערך ברירת המחדל הוא true אם לתיבת הכלים יש קטגוריות,false אחרת.
css	בוליאני	אם הערך הוא false, לא תתבצע הזרקה של CSS (האחריות על הוספת ה-CSS היא של המסמך). ברירת המחדל היא true.
disable	בוליאני	מאפשרת להשבית חסימה. ערך ברירת המחדל הוא true אם לתיבת הכלים יש קטגוריות, ו-false אחרת.
grid	אובייקט	הגדרת רשת שאפשר לכוונן אליה את הבלוק. רשת
horizontalLayout	בוליאני	אם true toolbox הוא אופקי, אם false toolbox הוא אנכי. ברירת המחדל היא false.
maxBlocks	number	המספר המקסימלי של בלוקים שניתן ליצור. שימושי לתרגילים של תלמידים. ברירת המחדל היא Infinity.
maxInstances	אובייקט	מיפוי של סוגי בלוקים למספר המקסימלי של בלוקים מהסוג הזה שניתן ליצור. סוגי נתונים שלא הוגדרו מוגדרים כברירת מחדל בתור Infinity. לדוגמה: maxInstances: {'controls_if': 3, 'math_number': 42}
media	מחרוזת	הנתיב מהדף (או מהפריים) לספריית המדיה של Blockly. ברירת המחדל היא "https://blockly-demo.appspot.com/static/media/".
modalInputs	בוליאני	אם true, מוצגים עורכים מודליים בשדות קלט טקסט ובתת-הסוגים שלהם במכשירים ניידים, ועורך בתוך שורת הטקסט במחשב. אם false מוצג עורך בתוך השורה גם במחשב וגם בנייד. ברירת המחדל היא true.
move	אובייקט	הגדרת ההתנהגות של המשתמשים במרחב העבודה. ראו העברה.
oneBasedIndex	בוליאני	אם true רשימות ופעולות מחרוזות צריכות להיכלל באינדקס מ-1, אם false רשימות ופעולות מחרוזות צריכות להיכלל באינדקס מ-0. ברירת המחדל היא true.
readOnly	בוליאני	אם הערך הוא true, המשתמשים לא יוכלו לערוך. הסתרת תיבת הכלים ואשפה. ברירת המחדל היא false.
renderer	מחרוזת	קובעת את ה-renderer ש-Blockly משתמשת בו. מנועי עיבוד גרפי (renderers) ארוזים מראש כוללים את 'geras' (ברירת המחדל), 'thrasos' ו-'zelos' (מנוע עיבוד גרפי שדומה ל-scratch).
rtl	בוליאני	אם הערך הוא true, מעתיקים את הכלי לעריכה (למיקומים ערביים או עבריים). הדגמה של RTL ברירת המחדל היא false.
scrollbars	אובייקט או ערכים בוליאניים	מגדיר אם בסביבת העבודה יהיו סרגל גלילה אנכי או אופקי. הפונקציה מקבלת אובייקט שבו המאפיין horizontal קובע אם גלילה אופקית מופעלת, והמאפיין vertical קובע אם גלילה אנכית מופעלת. אם מעבירים ערך בוליאני, זה שווה ערך להעברת אובייקט שבו המאפיינים horizontal ו-vertical מוגדרים כערך הזה. ערך ברירת המחדל הוא true אם לתיבת הכלים יש קטגוריות.
sounds	בוליאני	אם הערך שלו מוגדר ל-false, הצלילים מושבתים. ברירת המחדל היא true.
theme	עיצוב	אם לא צוין עיצוב, ערך ברירת המחדל הוא עיצוב קלאסי. עיצובים
toolbox	מחרוזת,‏ XML או JSON	מבנה עץ של קטגוריות ובלוקים שזמינים למשתמש. מידע נוסף זמין במאמר הגדרת ערכת הכלים.
toolboxPosition	מחרוזת	אם "start" toolbox נמצא בחלק העליון (אם הוא אופקי) או בצד ימין (אם הוא אנכי ו-LTR) או בצד ימין (אם הוא אנכי ו-RTL). אם "end" תיבת הכלים נמצאת בצד השני. ברירת המחדל היא "start".
trashcan	בוליאני	הצגה או הסתרה של פח האשפה. ערך ברירת המחדל הוא true אם לתיבת הכלים יש קטגוריות, ו-false אחרת.
maxTrashcanContents	number	מספר הפריטים המקסימלי שנמחקו שיופיע בחלונית הקופצת של פח האשפה. הערך '0' משבית את התכונה. ברירת המחדל היא '32'.
plugins	אובייקט	מיפוי של סוג הפלאגין לשם הפלאגין או של סוג הפלאגין לשם של סוג הפלאגין הרשום. הזרקה של תת-כיתות
zoom	אובייקט	הגדרת התנהגות הזום. שינוי מרחק התצוגה