יצירה של סביבת עבודה

אתם יכולים ליצור סביבת עבודה ולהוסיף אותה ל-DOM בקריאה אחת, או פשוט ליצור סביבת עבודה.

הזרקה

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

מידע נוסף זמין במאמר בנושא יצירת מרחב עבודה.

יצירה ישירה

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

אפשרויות הגדרה

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

שם סוג תיאור
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}
maxTrashcanContents number המספר המקסימלי של פריטים שנמחקו שיופיעו בתפריט הנפתח של האשפה. '0' משבית את התכונה. ברירת המחדל היא '32'.
media מחרוזת הנתיב מהדף (או מהמסגרת) לספריית המדיה של Blockly. ברירת המחדל היא 'https://blockly-demo.appspot.com/static/media/'. מידע על תיקיית המדיה
modalInputs בוליאני אם true מציג עורכים מודאליים לשדות קלט טקסט ולמחלקות המשנה שלהם בניידים, ועורך מוטבע במחשב. אם false מוצג עורך מוטבע גם במחשב וגם בנייד. ברירת המחדל היא true.
move אובייקט ההגדרה הזו קובעת את ההתנהגות של המערכת לגבי האופן שבו המשתמשים יכולים לנוע במרחב העבודה. מידע נוסף על העברה
oneBasedIndex בוליאני אם פעולות על רשימות ומחרוזות true צריכות להתחיל את האינדקס מ-1, אם false צריכות להתחיל את האינדקס מ-0. ברירת המחדל היא true.
plugins אובייקט מאגר מיפוי אובייקטים שבו שמות של סוגי רישום ממופים למחלקות חלופיות או לשמות הרשומים של מחלקות חלופיות. הוספת כיתה חלופית
readOnly בוליאני אם true, למנוע מהמשתמש לערוך. האפשרות הזו מסתירה את ארגז הכלים ואת פח האשפה. ברירת המחדל היא false. אפשר לעיין גם בsetIsReadOnly ובisReadOnly.
renderer מחרוזת קובעת את רכיב ה-Renderer שמשמש את Blockly. מעבדי רינדור שמוגדרים מראש כוללים את 'geras' (ברירת המחדל), 'thrasos' ו-'zelos' (מעבד רינדור שדומה ל-Scratch). מידע על רכיבי עיבוד בהתאמה אישית זמין במאמר יצירת רכיבי עיבוד בהתאמה אישית.
rtl בוליאני אם true, משקפים את הכלי לעריכה (ללוקאלים של ערבית או עברית). לצפייה בהדגמה ברירת המחדל היא false.
scrollbars אובייקט או ערך בוליאני המאפיין קובע אם בסביבת העבודה יוצגו סרגלי גלילה אנכיים או אופקיים. מקבל אובייקט שבו המאפיין horizontal קובע אם הגלילה האופקית מופעלת והמאפיין vertical קובע אם הגלילה האנכית מופעלת. אם מועבר ערך בוליאני, הוא שווה להעברת אובייקט עם המאפיינים horizontal ו-vertical שמוגדרים כערך הזה. אם ארגז הכלים כולל קטגוריות, ערך ברירת המחדל הוא true.
sounds בוליאני אם הערך הוא false, הצלילים מושבתים. ברירת המחדל היא true.
theme עיצוב אם לא מציינים עיצוב, ברירת המחדל היא העיצוב הקלאסי. מידע נוסף על עיצובים
toolbox מחרוזת, XML או JSON מבנה עץ של קטגוריות וחסימות שזמינות למשתמש. מידע נוסף מופיע במאמר בנושא הגדרת ארגז הכלים.
toolboxPosition מחרוזת אם תיבת הכלים 'start' נמצאת למעלה (אם היא אופקית) או בצד שמאל (אם היא אנכית והכיוון הוא משמאל לימין) או בצד ימין (אם היא אנכית והכיוון הוא מימין לשמאל). אם ארגז הכלים של 'end' נמצא בצד השני. ברירת המחדל היא 'start'.
trashcan בוליאני הצגה או הסתרה של פח האשפה. אם ארגז הכלים כולל קטגוריות, ערך ברירת המחדל הוא true. אחרת, ערך ברירת המחדל הוא false.
zoom אובייקט ההגדרה קובעת את התנהגות הזום. ראו שינוי מרחק התצוגה.