אתם יכולים ליצור סביבת עבודה ולהוסיף אותה ל-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 . |
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 |
אובייקט | ההגדרה קובעת את התנהגות הזום. ראו שינוי מרחק התצוגה. |