blockly > Workspace

כיתה ב-Workspace

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

Signature:

export declare class Workspace 

יצרנים

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

מאפיינים

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

Methods

שיטה גורמי שינוי תיאור
addChangeListener(func) כשמשהו בסביבת העבודה הזו משתנה, מתבצעת קריאה לפונקציה. שימו לב: יכול להיות שכבר יש כמה אירועים מהזמן האחרון במחסנית. לכן, יכול להיות שהפונקציה החדשה להאזנה לשינויים תופעל עם אירועים שהתרחשו כמה אלפיות השנייה לפני שהפונקציה הזו נוספה.
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) חיפוש כל הבלוקים בסביבת העבודה. אפשר למיין את הבלוקים לפי מיקום, מלמעלה למטה (עם הטיה קלה משמאל לימין או מימין לשמאל).
getAllVariableNames() הפונקציה מחזירה את כל שמות המשתנים מכל הסוגים.
getAllVariables() הפונקציה מחזירה את כל המשתנים מכל הסוגים.
getBlockById(id) מחפשים את החסימה ב-Workspace עם המזהה שצוין.
getBlocksByType(type, ordered) הפונקציה מאתרת את הבלוקים עם הסוג המשויך ומחזירה אותם. אפשר למיין את הבלוקים לפי מיקום, מלמעלה למטה (עם הטיה קלה משמאל לימין או מימין לשמאל).
getById(id) static חיפוש סביבת העבודה עם המזהה שצוין.
getCommentById(id) מוצאים את התגובה במרחב עם המזהה שצוין.
getPotentialVariableMap()‎ החזרת מיפוי המשתנים שמכיל משתנים מסוג potential. הם מופיעים בתפריט הנפתח אבל לא בסביבת העבודה.
getProcedureMap() מחזירה את המפה של כל ההליכים בסביבת העבודה.
getRootWorkspace()

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

לדוגמה, סביבות עבודה בחלונות קופצים ובבועות קטנות של סביבות עבודה הן סביבות עבודה צאצא.

getTopBlocks(ordered) הפונקציה מוצאת את הבלוקים ברמה העליונה ומחזירה אותם. אפשר למיין את הבלוקים לפי מיקום, מלמעלה למטה (עם הטיה קלה משמאל לימין או מימין לשמאל).
getVariable(name, opt_type) מוצאים את המשתנה לפי השם שצוין ומחזירים אותו. הפונקציה מחזירה ערך null אם לא נמצאה התאמה.
getVariableById(id) הפונקציה מוצאת את המשתנה לפי המזהה הנתון ומחזירה אותו. הפונקציה מחזירה ערך null אם לא נמצאה התאמה.
getVariableMap()‎ החזרת המיפוי של כל המשתנים בסביבת העבודה.
getVariableMapClass() protected
getVariablesOfType(type) מאתרים את המשתנה עם הסוג שצוין. אם הסוג הוא null, מחזירים רשימה של משתנים עם סוג מחרוזת ריקה.
getVariableUsesById(id) מוצאים את כל המקומות שבהם נעשה שימוש במשתנה שצוין, שמזוהה לפי מזהה.
getWidth() הפונקציה מחזירה את ההיסט האופקי של סביבת העבודה. מיועד לתאימות LTR/RTL ב-XML. לא רלוונטי לסביבת עבודה ללא ממשק משתמש.
hasBlockLimits() בודק אם יש מגבלות ב-Workspace על המספר המקסימלי של בלוקים, או על המספר המקסימלי של בלוקים מסוגים מסוימים.
isCapacityAvailable(typeCountsMap) בודקים אם יש קיבולת פנויה ליצירת בלוקים עם המספרים שצוינו. אם המספר הכולל של הבלוקים שמיוצגים במפה גדול מהקיבולת הכוללת שנותרה, הפונקציה מחזירה false. אם מספר הסוגים גדול מהקיבולת שנותרה לסוג הזה, הפונקציה מחזירה false.
isReadOnly() הפונקציה מחזירה את הערך true אם סביבת העבודה הזו היא במצב קריאה בלבד, אחרת היא מחזירה את הערך false.
newBlock(prototypeName, opt_id) מקבלים בלוק חדש שנוצר.
newComment(id) קבלת תגובה חדשה שנוצרה.
remainingCapacity() מספר הבלוקים שאפשר להוסיף לסביבת העבודה לפני שמגיעים לערך המקסימלי של maxBlocks.
remainingCapacityOfType(type) מספר הבלוקים מהסוג הנתון שאפשר להוסיף לסביבת העבודה לפני שמגיעים למספר המקסימלי של מופעים (maxInstances) שמותרים לסוג הזה.
removeChangeListener(func) הפסקת ההאזנה לשינויים בסביבת העבודה הזו.
removeTopBlock(block) הסרת חסימה מרשימת החסימות העיקריות.
removeTypedBlock(block) הסרה של חסימה מרשימת החסימות שממוינות לפי סוג.
renameVariableById(id, newName) כדי לשנות את השם של משתנה, מעדכנים את השם שלו במיפוי המשתנים. מזהים את המשתנה שרוצים לשנות את השם שלו באמצעות המזהה שצוין.
setIsReadOnly(readOnly) ההגדרה קובעת אם סביבת העבודה הזו היא במצב קריאה בלבד או לא.
sortByOrigin(a, b) protected ממיין את הרכיבים המוגבלים בסביבת העבודה לפי המיקום היחסי שלהם, מלמעלה למטה (עם הטיה קלה משמאל לימין או מימין לשמאל).
ביטול(חזרה) ביטול או ביצוע מחדש של הפעולה הקודמת.