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

הזרקה

אפשר להחדיר סביבת עבודה של 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 הוא ארגז כלים אופקי, אם false הוא ארגז כלים אנכי. ברירת המחדל היא false.
maxBlocks	number	המספר המקסימלי של בלוקים שניתן ליצור. שימושי לתרגילים של תלמידים. ברירת המחדל היא Infinity.
maxInstances	אובייקט	מיפוי של סוגי בלוקים למספר המקסימלי של בלוקים מהסוג הזה שניתן ליצור. סוגי נתונים שלא הוגדרו מוגדרים כברירת מחדל בתור Infinity. לדוגמה: maxInstances: {'controls_if': 3, 'math_number': 42}
media	מחרוזת	הנתיב מהדף (או מהפריים) לספריית המדיה של Blockly. ברירת המחדל היא "https://blockly-demo.appspot.com/static/media/".
move	אובייקט	הגדרת ההתנהגות של המשתמשים במרחב העבודה. ראו העברה.
oneBasedIndex	בוליאני	אם true רשימות ופעולות מחרוזות צריכות להיכלל באינדקס מ-1, אם false צריכות להיכלל באינדקס מ-0. ברירת המחדל היא true.
readOnly	בוליאני	אם הערך הוא true, המשתמשים לא יוכלו לערוך. הסתרת תיבת הכלים ואשפה. ברירת המחדל היא false.
renderer	מחרוזת	קובעת את ה-renderer ש-Blockly משתמשת בו. מנועי עיבוד גרפיים ארוזים מראש כוללים את '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	אובייקט	הגדרת אופן השינוי של מרחק התצוגה. שינוי מרחק התצוגה