דף זה תורגם על ידי Cloud Translation API.

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

הזרקה

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

יצירה ישירה

אפשר גם ליצור סביבת עבודה ישירות באמצעות Blockly.WorkspaceSvg(new Blockly.Options(options)). שימו לב: עליכם להפעיל את new Blockly.Options(options) על ידי העברת מילון האפשרויות שלכם – ה-builder של סביבת העבודה מצפה למופע של Blockly.Options ולא למילון אפשרויות מינימלי.

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

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

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