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

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

הזרקה

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

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

יצירה ישירה

אפשר ליצור סביבת עבודה ישירות על ידי התקשרות אל new Blockly.WorkspaceSvg(new Blockly.Options(options)). כשמתקשרים ל-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 אובייקט ההגדרה קובעת את התנהגות הזום. ראו שינוי מרחק התצוגה.