blockly

חבילת blockly

מחלקות

מחלקה	תיאור
ASTNode	מחלקה לצומת AST. מומלץ להשתמש באחת מהשיטות של createNode במקום ליצור צומת ישירות.
BasicCursor	מחלקה של סמן בסיסי. פעולה זו תאפשר למשתמש להגיע לכל הצמתים ב-AST באמצעות הקשה על 'הבא' או 'הקודם'.
חסימה	כיתה לבלוק אחד. בדרך כלל עדיף להשתמש ב-workspace.newBlock() בלי קריאה ישירה.
BlockSvg	מחלקה לייצוג SVG של בלוק. בדרך כלל עדיף להשתמש ב-workspace.newBlock() בלי קריאה ישירה.
CodeGenerator	שיעור למחולל קוד שמתרגם את הבלוקים לשפה.
CollapsibleToolboxCategory	מחלקה של קטגוריה בארגז כלים שאפשר לכווץ.
ComponentManager	מנהל של כל הפריטים שרשומים בסביבת העבודה.
חיבור	מחלקה לחיבור בין בלוקים.
ConnectionChecker	סיווג ללוגיקה של בדיקת סוג החיבור.
ConnectionDB	מסד נתונים של חיבורים. החיבורים מאוחסנים לפי הסדר של הרכיב האנכי שלהם. כך ניתן לחפש במהירות חיבורים באזור מסוים באמצעות חיפוש בינארי.
ContextMenuRegistry	מחלקה למרשם של פריטים בתפריט הקשר. זה אמור להיות סינגלטון. אין ליצור מכונה חדשה ולגשת למחלקה הזו רק דרך ContextתפריטRegistry.registry.
סמן	מחלקה עבור סמן. הסמן קובע איך המשתמש מנווט ב-Blockly AST.
DeleteArea	מחלקה מופשטת של רכיב שיכול למחוק בלוק או בועה שנופלת מעליו.
DragTarget	מחלקה מופשטת לרכיב עם התנהגות מותאמת אישית כאשר גוררים מעליו בלוק או בועה או נופלים מעליו.
FieldCheckbox	מחלקה לשדה של תיבת סימון.
FieldDropdown	מחלקה לשדה נפתח שניתן לעריכה.
FieldImage	כיתה לתמונה בבלוק.
FieldLabel	מחלקה עבור שדה טקסט שלא ניתן לעריכה ולא ניתן להקראה.
FieldLabelSerializable	מחלקה של שדה טקסט שלא ניתן לעריכה וניתן לסדרות.
FieldNumber	מחלקה לשדה מספר שניתן לעריכה.
FieldTextInput	מחלקה לשדה טקסט שניתן לעריכה.
FieldVariable	מחלקה לשדה הנפתח של משתנה.
FlyoutButton	סיווג עבור לחצן או תווית בתפריט הנפתח.
FlyoutMetricsManager	מחשבת מדדים לסביבת עבודה של גרסה נשלפת. המדדים משמשים בעיקר כדי לקבוע גודל של פסי גלילה בקמפיינים הנפתחים.
תנועה	כיתה לתנועה אחת.
רשת	מחלקה עבור רשת של סביבת עבודה.
HorizontalFlyout	כיתה למתקדמים.
קלט	מחלקה לקלט עם שדות אופציונליים.
InsertionMarkerManager	מחלקה ששולטת בעדכונים בקשר לחיבורים במהלך גרירה. היא אחראית בעיקר על מציאת החיבור המתאים ביותר הקרוב ביותר, והדגשה או ביטול הדגשה שלו לפי הצורך במהלך גרירה.
InsertionMarkerPreviewer
סמן	מחלקה של סמן. האפשרות הזו משמשת בניווט באמצעות מקלדת כדי לשמור מיקום ב-Blockly AST.
MarkerManager	מחלקה לניהול הסמנים המרובים והסמן בסביבת העבודה.
תפריט	סיווג בסיסי של תפריט.
MenuItem	מחלקה שמייצגת פריט בתפריט.
MetricsManager	המנהל של כל חישובי המדדים ב-Workspace.
שמות	סיווג של מסד נתונים של שמות ישויות (משתנים, הליכים וכו').
אפשרויות	ינתח את האפשרויות שצוינו על ידי המשתמש, תוך שימוש בברירות מחדל סבירות שבהן לא צוינה ההתנהגות.
RenderedConnection	סיווג לחיבור בין בלוקים שניתן לעבד אותם במסך.
סרגל גלילה	מחלקה עבור סרגל גלילה בפורמט SVG טהור. השיטה הזו מציעה סרגל גלילה שמובטח שיפעל, אבל יכול להיות שהוא לא ייראה או יפעל כמו פסי הגלילה של המערכת.
ScrollbarPair	מחלקה של זוג פסי גלילה. אופקי ואנכי.
ShortcutRegistry	מחלקה למרשם של מקשי הקיצור. זה אמור להיות סינגלטון. אין ליצור מכונה חדשה ולגשת למחלקה הזו רק דרך ShortcutRegistry.registry.
TabNavigateCursor	סמן לניווט בין שדות שניתן לנווט בכרטיסיות.
עיצוב	כיתה בנושא מסוים.
ThemeManager	סיווג לאחסון ולעדכון של רכיבי העיצוב ורכיבי ממשק המשתמש של סביבת העבודה.
ארגז כלים	מחלקה לארגז כלים. יצירת ה-DOM של ארגז הכלים.
ToolboxCategory	כיתה לקטגוריה בארגז כלים.
ToolboxItem	סיווג של פריט בארגז הכלים.
ToolboxSeparator	מחלקה למפריד ארגז כלים. זהו הקו החזותי הדק שמופיע בארגז הכלים. לא ניתן לבצע אינטראקציה עם הפריט הזה.
אשפה	סיווג של פח אשפה.
UnattachedFieldError	מייצג שגיאה שבה השדה מנסה לגשת לבלוק שלו או למידע על הבלוק שלו לפני שהוא צורף בפועל לבלוק הזה.
VariableMap	מחלקה עבור מפה משתנה. השדה הזה מכיל מבנה נתונים מילוני עם סוגי משתנים כמפתחות ורשימות של משתנים כערכים. רשימת המשתנים היא הסוג שהמפתח מציין.
VariableModel	מחלקה למודל משתנים. מכילה את המידע עבור המשתנה, כולל שם, מזהה וסוג.
VerticalFlyout	כיתה למתקדמים.
סביבת עבודה	כיתה לסביבת עבודה. זהו מבנה נתונים שמכיל בלוקים. אין ממשק משתמש, ואפשר ליצור אותו ללא GUI.
WorkspaceAudio	שיעור לטעינה, לאחסון ולהפעלה של אודיו בסביבת עבודה.
WorkspaceDragger	מחלקה לגרירה בסביבת העבודה. הוא מזיז את סביבת העבודה כאשר גוררים אותה באמצעות עכבר או מגע.
WorkspaceSvg	כיתה לסביבת עבודה. זהו אזור במסך עם אפשרויות לפח אשפה, לפסי גלילה, לבועות ולגרירה.
ZoomControls	מחלקה לפקדים לשינוי מרחק התצוגה.

שיעורים מופשטים

כיתה מופשטת	תיאור
שדה	מחלקה מופשטת לשדה שניתן לערוך.
Flyout	כיתה למתקדמים.

ספירות

ספירה	תיאור
ConnectionType	טיפוסים בני מנייה (enum) לסוג החיבור או הקלט.

פונקציות

פעולה	תיאור
hasBubble(obj)	שומר טיפוסים שבודק אם האובייקט הנתון הוא IHasבועה.
hideChaff(opt_onlyClosePopups)	סגירה של הסברים קצרים, תפריטי הקשר, בחירות של תפריטים נפתחים וכו'.
inject(container, opt_options)	החדרת עורך Blockly לרכיב הקונטיינר שצוין (בדרך כלל div).
isCopyable(obj)
isDeletable(obj)	מחזירה אם האובייקט הנתון ניתן למזהים.
isDraggable(obj)	מחזירה אם האובייקט הנתון הוא IDraggable או לא.
isIcon(obj)	Type Guard שבודק אם האובייקט הנתון הוא IIcon.
isPaster(obj)
isSelectable(obj)	בודקת אם האובייקט הנתון ניתן ל-ISelectable.
isSerializable(obj)	שומר טיפוסים שבודק אם האובייקט הנתון ניתן לניתן להתאמה (ISerialable).
isVariableBackedParameterModel(param)	מחזירה אם האובייקט הנתון הוא בעל משתנה או לא.
setLocale(locale)	מגדיר את הלוקאל (כלומר, ההודעות שהותאמו לשוק המקומי/block-text/וכו') ללוקאל הנתון. הפעולה הזו לא שימושית או לא נחוצה כשטוענים מתוך תג סקריפט, כי ההודעות נצמדות באופן אוטומטי לאובייקט Blockly.Msg. אבל אנחנו מספקים אותו גם בהקשרים של תג סקריפט וגם בהקשרים שאינם תגי סקריפט כדי שה-tscompiler יוכל ליצור בצורה נכונה את קובצי הגדרות הסוג שלנו.

ממשקים

ממשק	תיאור
BlocklyOptions	אפשרויות חסימה.
FieldCheckboxConfig	אפשרויות תצורה לשדה תיבת הסימון.
FieldCheckboxFromJsonConfig	fromJson אפשרויות הגדרה עבור שדה תיבת הסימון.
FieldConfig	אפשרויות תצורה נוספות עבור שדה הבסיס.
FieldDropdownFromJsonConfig	fromJson_config לשדה הנפתח.
FieldImageConfig	אפשרויות תצורה לשדה התמונה.
FieldImageFromJsonConfig	אפשרויות ההגדרה של fromJson עבור שדה התמונה.
FieldLabelConfig	אפשרויות תצורה לשדה התווית.
FieldLabelFromJsonConfig	fromJson אפשרויות הגדרה עבור שדה התווית.
FieldNumberConfig	אפשרויות הגדרה לשדה המספר.
FieldNumberFromJsonConfig	fromJson אפשרויות הגדרה לשדה המספר.
FieldTextInputFromJsonConfig	fromJson אפשרויות הגדרה עבור שדה קלט הטקסט.
FieldVariableConfig	אפשרויות תצורה לשדה המשתנה.
FieldVariableFromJsonConfig	fromJson אפשרויות תצורה עבור שדה המשתנה.
IASTNodeLocation	ממשק למיקום צומת AST.
IASTNodeLocationSvg	ממשק SVG של מיקום צומת AST.
IASTNodeLocationWithBlock	מיקום צומת AST שמשויך אליו חסימה.
IAutoHideable	ממשק לרכיב שניתן להסתיר באופן אוטומטי.
IBoundedElement	ממשק של רכיב תחום.
IBubble	ממשק בועה.
ICollapsibleToolboxItem	ממשק לפריט בארגז הכלים שניתן לכווץ.
IComponent	הממשק של רכיב של סביבת עבודה שאפשר לרשום באמצעות ה-ComponentManager.
IConnectionChecker	סיווג ללוגיקה של בדיקת סוג החיבור.
IConnectionPreviewer	הצגת 'תצוגות מקדימות' ויזואליות של המקומות שבהם הבלוק יחובר אם הוא נופל.
IContextMenu
ICopyable
IDeletable	הממשק של אובייקט שניתן למחוק.
IDeleteArea	ממשק לרכיב שיכול למחוק בלוק או בועה שנוסעים מעליו.
IDraggable	מייצג אובייקט שניתן לגרור.
IDragger
IDragStrategy
IDragTarget	ממשק לרכיב עם התנהגות מותאמת אישית כשגוררים מעליו בלוק או בועה או משחררים אותם.
IFlyout	ממשק לקמפיינים נשלפים.
IHasBubble
IIcon
IKeyboardAccessible	ממשק של אובייקט שמטפל במקשי קיצור.
IMetricsManager	ממשק למנהל מדדים.
IMovable	הממשק של אובייקט שניתן להזיז.
IPaster	אובייקט שיכול להדביק נתונים בסביבת העבודה.
IPositionable	ממשק לרכיב שממוקם מעל סביבת העבודה.
IRegistrable	הממשק של רכיב Blockly שאפשר לרשום.
ISelectable	הממשק של אובייקט שניתן לבחירה.
ISelectableToolboxItem	ממשק לפריט בארגז הכלים שאפשר לבחור.
ISerializable
IStyleable	ממשק עבור אובייקט שניתן להוסיף לו סגנון.
IToolbox	ממשק לארגז כלים.
IToolboxItem	ממשק לפריט בארגז הכלים.
IVariableBackedParameterModel	ממשק למודל פרמטרים שכולל מודל משתנה.

מרחבי שמות

מרחב שמות	תיאור
ASTNode
חסימה
blockAnimations
blockRendering
browserEvents
בועות
bumpObjects
לוח
CollapsibleToolboxCategory
תגובות
common
ComponentManager
constants
ContextMenu
ContextMenuItems
ContextMenuRegistry
CSS
תיבת דו-שיח
גרירה
אירועים
תוספים
fieldRegistry
geras
סמלים
ICopyable
קלט
InsertionMarkerManager
libraryBlocks
MetricsManager
שמות
אפשרויות
הליכים
registry
RenderedConnection
renderManagement
סריאליזציה
ShortcutItems
ShortcutRegistry
עיצוב
ThemeManager
עיצובים
ת'ראס
ToolboxCategory
ToolboxSeparator
הסבר על הכלי
נגיעה
uiPosition
utils
משתנים
VariablesDynamic
WidgetDiv
Xml
zelos

משתנים

משתנה	תיאור
חסימות	מיפוי של שמות של סוגי בלוקים לחסימת אובייקטים באב-טיפוס.
COLLAPSE_CHARS
COLLAPSED_FIELD_NAME
COLLAPSED_INPUT_NAME
config	אובייקט שמכיל את כל הערכים ב-Blockly שאנחנו מצפים שהמפתחים יוכלו לשנות.
defineBlocksWithJsonArray	מגדירים בלוקים מתוך מערך של הגדרות בלוקים של JSON, כפי שאפשר ליצור באמצעות הכלים למפתחים ב-Blockly.
DELETE_VARIABLE_ID
DropDownDiv
getMainWorkspace	מחזירה את סביבת העבודה הראשית. מחזירה את סביבת העבודה הראשית האחרונה שהייתה בשימוש (על סמך המיקוד). כדאי לא להשתמש בפונקציה הזו, במיוחד אם יש בדף מספר מופעים של חסימת תוכן.
getSelected	מחזירה את האובייקט הניתן להעתקה שנבחר כרגע.
INPUT_VALUE
JavaScript
הודעות SMS	מילון של הודעות שעברו לוקליזציה.
NEXT_STATEMENT
OPPOSITE_TYPE
OUTPUT_VALUE
PREVIOUS_STATEMENT
PROCEDURE_CATEGORY_NAME	מחרוזת לשימוש במאפיין 'custom' של קטגוריה ב-XML של ארגז הכלים. מחרוזת זו מציינת שצריך לאכלס את הקטגוריה באופן דינמי בבלוקים של תהליכים.
RENAME_VARIABLE_ID
setParentContainer	מגדירים את מאגר ההורה. זהו רכיב המאגר שה-WidgetDiv , dropDownDiv ו-tooltip מעובדים אל Blockly.inject בפעם הראשונה. השיטה הזו מוגדרת כ-NOP אם היא נקראת אחרי Blockly.inject הראשון.
svgResize	משנים את הגודל של תמונת ה-SVG כך שהיא תמלא את הקונטיינר באופן מלא. מצב כזה נקרא אם גודל התצוגה משתנה בפועל (למשל, אם משנים את גודל החלון או את כיוון המכשיר). כדי לשנות את הגודל של סביבת העבודה כשהתוכן משתנה (למשל, כשמוסיפים או מסירים בלוק), צריך לעיין ב-workspace.resizeContents מתעדים את הגובה/רוחב של תמונת ה-SVG.
TOOLBOX_AT_BOTTOM
TOOLBOX_AT_LEFT
TOOLBOX_AT_RIGHT
TOOLBOX_AT_TOP
VARIABLE_CATEGORY_NAME	מחרוזת לשימוש במאפיין 'custom' של קטגוריה ב-XML של ארגז הכלים. המחרוזת הזו מציינת שצריך לאכלס את הקטגוריה באופן דינמי באמצעות בלוקים של משתנים.
VARIABLE_DYNAMIC_CATEGORY_NAME	מחרוזת לשימוש במאפיין 'custom' של קטגוריה ב-XML של ארגז הכלים. המחרוזת הזו מציינת שצריך לאכלס את הקטגוריה באופן דינמי באמצעות בלוקים של משתנים.
גרסה	גרסת הליבה לחסימת חסימה. סקריפט ה-build (npm הרצת build) יבטל את הקבוע הזה לערך של הגרסה ב-package.json. הוא מבצע את הפעולה הזו על ידי מהדר החסימות במשימת buildComcompress.. עבור גרסאות build מקומיות, ניתן להעביר את --define='Blockly.VERSION=X.Y.Z' להדר כדי לשנות את הקבוע הזה.

יש להקליד כינויים

הקלד כינוי	תיאור
FieldCheckboxValidator	פונקציה שנקראת כדי לאמת שינויים בערך השדה לפני שהם מוגדרים.
FieldDropdownConfig	אפשרויות הגדרה לשדה הנפתח.
FieldDropdownValidator	פונקציה שנקראת כדי לאמת שינויים בערך השדה לפני שהם מוגדרים.
FieldNumberValidator	פונקציה שנקראת כדי לאמת שינויים בערך השדה לפני שהם מוגדרים.
FieldTextInputConfig	אפשרויות תצורה לשדה להזנת קלט הטקסט.
FieldTextInputValidator	פונקציה שנקראת כדי לאמת שינויים בערך השדה לפני שהם מוגדרים.
FieldValidator	פונקציה שנקראת כדי לאמת שינויים בערך השדה לפני שהם מוגדרים.
FieldVariableValidator	פונקציה שנקראת כדי לאמת שינויים בערך השדה לפני שהם מוגדרים.
ICopyData
MenuGenerator	מערך של אפשרויות תפריט או פונקציה שיוצרת מערך של אפשרויות תפריט עבור FieldDropdown או עבור הצאצאים שלו.
MenuGeneratorFunction	פונקציה שיוצרת מערך של אפשרויות תפריט עבור FieldDropdown או עבור הצאצאים שלו.
MenuOption	אפשרות ספציפית בתפריט הנפתח. הרכיב הראשון הוא הערך הקריא לאנשים (טקסט או תמונה), והרכיב השני הוא הערך הנייטרלי.