blockly > סביבת עבודה

כיתה ב-Workspace

כיתה לסביבת עבודה. זהו מבנה נתונים שמכיל בלוקים. אין ממשק משתמש, ואפשר ליצור אותו ללא GUI.

Signature:

export declare class Workspace implements IASTNodeLocation 

הטמעות: IASTNodeLocation

יצרנים

יצרן גורמי שינוי תיאור
(constructor)(opt_options) יצירה של מופע חדש של המחלקה Workspace

מאפיינים

נכס גורמי שינוי סוג תיאור
connectionChecker IConnectionChecker
connectionDBList ConnectionDB[] קבוצה של מסדי נתונים לחיפוש מהיר של מיקומי חיבור.
horizontalLayout בוליאני
id מחרוזת
isFlyout readonly בוליאני האם סביבת העבודה הזו היא סביבת העבודה?
isMutator readonly בוליאני האם סביבת העבודה הזו היא הפלטפורמה למוטציה?
MAX_UNDO number המספר המקסימלי של אירועי ביטול במקבץ. הביטול של 0 מושבת, אבל Infinity מגדיר את הביטול ללא הגבלה.
אפשרויות אפשרויות
redoStack_ protected מופשט[]
עובד בוליאני הפונקציה מחזירה את הערך true אם סביבת העבודה גלויה ו-false אם היא ללא GUI.
RTL בוליאני
SCAN_ANGLE static number מרחק מהזווית האופקית כדי לסרוק בלוקים. בדרך כלל סדר הביצוע הוא מלמעלה למטה, אבל זווית קטנה משנה את הסריקה כדי ליצור הטיה משמאל לימין (הפוכה ב-RTL). היחידות הן במעלות. למידע נוסף: https://tvtropes.org/pmwiki/pmwiki.php/Main/DiagonalBilling
toolboxPosition toolbox.Position
undoStack_ protected מופשט[]

שיטות

שיטה גורמי שינוי תיאור
addChangeListener(func) כשמשהו בסביבת העבודה הזו משתנה, צריך להפעיל פונקציה. יכול להיות שחלק מהאירועים האחרונים כבר נמצאים במקבץ. לכן, יכול להיות שה-האזנה לשינוי החדש תיקרא לאירועים שהתרחשו כמה אלפיות שנייה לפני שה-Change Listener נוסף.
addTopBlock(block) הוספת בלוק לרשימת הבלוקים העליונים.
addTypedBlock(block) מוסיפים בלוק לרשימת הבלוקים עם מפתחות לפי סוג.
allInputsFilled(opt_shadowBlocksAreFilled) הפונקציה בודקת אם כל ערכי הקלט וההצהרה בסביבת העבודה מולאו בבלוקים.
clear() צריך להשליך את כל החסימות והתגובות בסביבת העבודה.
clearUndo() ניקוי המקבצים של ביטול או ביצוע מחדש.
createVariable(name, opt_type, opt_id) יוצרים משתנה עם שם נתון, סוג אופציונלי ומזהה אופציונלי.
deleteVariableById(id) מוחקים משתנה לפי המזהה שהועבר ואת כל השימושים שלו מסביבת העבודה הזו. עשויה לבקש מהמשתמש אישור.
dispose() צריך להשליך את סביבת העבודה הזו. כדי למנוע דליפות זיכרון, צריך לבטל את הקישור של כל רכיבי ה-DOM.
fireChangeListener(event) הפעלה של אירוע שינוי.
getAll() static כאן תוכלו לראות את כל סביבות העבודה.
getAllBlocks(ordered) חיפוש כל הבלוקים בסביבת העבודה. הבלוקים ממוינים לפי מיקום באופן אופציונלי. מלמעלה למטה (עם הטיית LTR או RTL קלה).
getAllVariableNames() מחזירה את כל שמות המשתנים מכל הסוגים.
getAllVariables() החזרת כל המשתנים מכל הסוגים.
getBlockById(id) מאתרים את הבלוק בסביבת העבודה הזו עם המזהה שצוין.
getBlocksByType(type, ordered) היא מוצאת את הבלוקים עם הסוג המשויך ומחזירה אותם. הבלוקים ממוינים לפי מיקום באופן אופציונלי. מלמעלה למטה (עם הטיית LTR או RTL קלה).
getById(id) static מחפשים את סביבת העבודה עם המזהה שצוין.
getProcedureMap() מחזירה את המפה של כל התהליכים בקצב העבודה.
getRootWorkspace()

הפונקציה מחזירה את סביבת העבודה הבסיסית לסביבת העבודה הזו אם לסביבת העבודה יש תבניות הורה.

לדוגמה לסביבות עבודה עם רפליקות ולבועות קטנות של סביבת עבודה יש סביבת עבודה הורה.

getTopBlocks(ordered) היא מוצאת את הבלוקים ברמה העליונה ומחזירה אותם. הבלוקים ממוינים לפי מיקום באופן אופציונלי. מלמעלה למטה (עם הטיית LTR או RTL קלה).
getVariable(name, opt_type) מוצאים את המשתנה לפי השם הנתון ומחזירים אותו. אם הערך לא נמצא, מוחזר null.
getVariableById(id) מוצאים את המשתנה לפי המזהה הנתון ומחזירים אותו. אם הערך לא נמצא, מוחזר null.
getVariableMap() החזרת המפה של כל המשתנים בסביבת העבודה.
getVariablesOfType(type) מוצאים את המשתנה עם הסוג שצוין. אם הסוג הוא null, תוחזר רשימת משתנים עם סוג מחרוזת ריקה.
getVariableUsesById(id) מוצאים את כל השימושים של המשתנה הנתון, שמזוהה לפי המזהה שלו.
getWidth() מחזירה את ההיסט האופקי של סביבת העבודה. מיועד לתאימות LTR/RTL ב-XML. לא רלוונטית לסביבת עבודה ללא GUI.
hasBlockLimits() הפונקציה בודקת אם לסביבת העבודה יש מגבלות על המספר המקסימלי של בלוקים או על מספר הבלוקים המקסימלי מסוגים ספציפיים.
isCapacityAvailable(typeCountsMap) בודקים אם יש קיבולת לבלוקים של הספירות הנתונות שאפשר ליצור. אם המספר הכולל של הבלוקים שהמפה מייצג גדול מהקיבולת הכוללת שנותרה, הפונקציה מחזירה את הערך False. אם מספר הסוגים גדול מהקיבולת שנותרה לסוג הזה, הפונקציה מחזירה את הערך False.
newBlock(prototypeName, opt_id) משיגים בלוק חדש שנוצר.
newComment(id) קבלת תגובה חדשה שנוצרה.
remainingCapacity() מספר הבלוקים שניתן להוסיף לסביבת העבודה לפני שמגיעים למספר הבלוקים המקסימלי.
remainingCapacityOfType(type) מספר הבלוקים מהסוג הנתון שניתן להוסיף לסביבת העבודה לפני שמגיעים למספר המכונות המקסימלי שמותר להוסיף לסוג הזה.
removeChangeListener(func) הפסקת ההאזנה לשינויים בסביבת העבודה הזו.
removeTopBlock(block) מסירה בלוק מרשימת הבלוקים העליונים.
removeTypedBlock(block) מסירים בלוק מרשימת הבלוקים עם מפתחות לפי סוג.
renameVariableById(id, newName) כדי לשנות שם של משתנה, מעדכנים את השם שלו במפת המשתנים. מאתרים את המשתנה שרוצים לשנות לו את השם באמצעות המזהה הנתון.
undo(redo) ביטול הפעולה הקודמת או ביצוע מחדש של הפעולה.