blockly > חסימה

חסימת הכיתה

מחלקה לבלוק אחד. בדרך כלל אין קריאה ישירה, אבל עדיף להשתמש ב-workspace.newBlock() .

Signature:

export declare class Block implements IASTNodeLocation, IDeletable 

הטמעות: IASTNodeLocation, IDeletable

יצרנים

יצרן	גורמי שינוי	התיאור
(constructor)(workspace, prototypeName, opt_id)		יצירת מופע חדש של המחלקה Block

תכונות

נכס	גורמי שינוי	תיאור	התיאור
childBlocks_	protected	זה[]
collapsed_	protected	boolean
COLLAPSED_FIELD_NAME	static readonly	מחרוזת	המזהה הניטרלי מהשפה שניתן לשדה המכווץ.
COLLAPSED_INPUT_NAME	static readonly	מחרוזת	המזהה הניטרלי מהשפה שניתן לקלט המכווץ.
colour_	protected	מחרוזת	צבע הבלוק בפורמט '#RRGGBB'.
compose?		(p1: חסימה) => void	(אופציונלי) פונקציה אופציונלית שמגדירה מחדש את הבלוק בהתאם לתוכן של תיבת הדו-שיח של המשתנה.
contextMenu		boolean
נתונים		מחרוזת | null	נתוני טקסט אופציונליים שעוברים בין בלוקים ו-XML. אין לו השפעה. יכול לשמש גורמי צד שלישי למטא-מידע.
לפרק אותן?		(p1: Workspace) => חסימה	(אופציונלי) פונקציה אופציונלית שמאכלסת את רכיבי הבלוק הזה בתיבת הדו-שיח של המוטציה.
destroy?		() => void	(אופציונלי) שיטה אופציונלית מופעלת בזמן השלכה.
domToMutation?		(p1: רכיב) => void	(אופציונלי) שיטה אופציונלית לdeserialization להגדרת האופן שבו מבצעים פעולת deserialize של מצב המוטציה מ-XML. יש לשלב זאת עם ההגדרה של mutationToDom.
getDeveloperVariables?		() => מחרוזת[]	(אופציונלי) נכס אופציונלי להצהרה על משתנים למפתחים. החזרת רשימה של שמות משתנים לשימוש על ידי מחוללים. משתני המפתח אף פעם לא מוצגים למשתמש, אבל הם מוצהרים כמשתנים גלובליים בקוד שנוצר.
כובע?		מחרוזת	(אופציונלי) השם של סוג הכובע.
helpUrl		string | Function | null	מחרוזת עבור עזרה לחסימה, או פונקציה שמחזירה כתובת URL. אין עזרה כלל.
סמלים		IIcon[]
id		מחרוזת
init?		() => void	(אופציונלי) שיטה אופציונלית שמופעלת במהלך האתחול.
inputList		קלט[]
inputsInline?		boolean	(אופציונלי)
inputsInlineDefault?		boolean	(אופציונלי)
isInFlyout		boolean
isInMutator		boolean
isInsertionMarker_	protected	boolean	True אם הבלוק הזה הוא סמן להכנסה.
loadExtraState?		(p1: כל) => בטל	(אופציונלי) שיטת סידור בהמשכים אופציונלית להגדרה של ביצוע פעולת deserialize למצב הנוסף של הבלוק (למשל מצב מוטציה) מרכיב תואם JSON. יש לשלב זאת עם ההגדרה של saveExtraState.
mutationToDom?		(...p1: any[]) => רכיב	(אופציונלי) שיטה אופציונלית של סידור בהמשכים, לקביעת האופן שבו ניתן לערוך את מצב המוטציה ל-XML בהמשכים. יש לשלב זאת עם ההגדרה של domToMutation.
nextConnection		חיבור | null
onchange?		((p1: Abstract) => void) | null	(אופציונלי) שיטת קריאה חוזרת (callback) אופציונלית שמשתמשים בה בכל פעם שסביבת העבודה ברמה העליונה של הבלוק משתנה. בדרך כלל קוראים לזה רק מה-constructor, מפונקציית הבלוק של סוג הבלוקים (block type) או מפונקציית מאתחל תוסף.
outputConnection		חיבור | null
outputShape_	protected	מספר | null
parentBlock_	protected	זה | null
previousConnection		חיבור | null
מעובד		boolean | null
RTL		boolean
saveExtraState?		(doFullSerialization?: boolean) => any	(אופציונלי) שיטת סידור בהמשכים אופציונלית להגדרת המצב הנוסף של הבלוק (למשל מצב מוטציה) לרכיב ה-JSON התואם ל-JSON. יש לשלב זאת עם ההגדרה של loadExtraState.
styleName_	protected	מחרוזת	שם הסגנון של הבלוק.
suppressPrefixSuffix		boolean | null	מאפיין אופציונלי לביטול ההוספה של STATEMENT_PREFIX ו-STATEMENT_SUFFIX לקוד שנוצר.
הסבר קצר		Tooltip.TipInfo
סוג		מחרוזת
סביבת עבודה		סביבת עבודה

שיטות

שיטה	גורמי שינוי	התיאור
addIcon(icon)		הוספת הסמל הנתון לבלוק.
allInputsFilled(opt_shadowBlocksAreFilled)		הפונקציה בודקת באופן קבוע אם כל הקלט של ההצהרה והערך מולאו בבלוקים. בנוסף, נבדקת כל החסימות הבאות של הצהרות במקבץ הזה.
appendDummyInput(name)		הפונקציה הזאת מצרפת שורת קלט דמה.
appendEndRowInput(name)		מצרפת קלט שמסתיים.
appendInput(input)		הפונקציה הזאת מצרפת את שורת הקלט הנתונה. אפשר להוסיף לבלוק נתוני קלט מותאמים אישית.
appendStatementInput(name)		מצרף שורת קלט של משפט.
appendValueInput(name)		הפונקציה הזאת מצרפת שורה של קלט של ערך.
bumpNeighbours()		הרחקת בלוקים לא מחוברים מהיישור ללא יישור. שני בלוקים שאינם מחוברים בפועל לא אמורים להיות מיושרים בטעות במסך.
פינוי(healStack)		אפשר להסיר את הבלוק הזה.
disposeInternal()	protected	נשלף מהבלוק הזה בלי לבצע פעולות שנדרשות על ידי הבלוק העליון. למשל, לא מפעילה אירועים, מנתקת את הבלוק וכו'.
doInit_()	protected	קורא לפונקציה init() ומטפל בהפעלת אירועים משויכים וכו'.
getChildren(ordered)		מוצאים את כל הבלוקים שמוצבים ישירות בתוך הבלוק הזה. כולל קלט של ערך והצהרה, וכן כל הצהרה הבאה. לא כולל חיבורים בכרטיסיית פלט או בכל הצהרה קודמת. לחלופין, בלוקים ממוינים לפי מיקום; מלמעלה למטה.
getColour()		לקבל את הצבע של בלוק.
getCommentText()		מחזירה את ההערה בבלוק הזה (או הערך null אם אין תגובה).
getDescendants(ordered)		מוצאים את כל הבלוקים שמוצבים ישירות או בעקיפין בתוך הבלוקים האלה. כולל את הבלוק הזה ברשימה. כולל קלט של ערכים והצהרה, וכן את כל ההצהרות הבאות. לא כולל חיבורים בכרטיסיית פלט או בהצהרות קודמות. לחלופין, בלוקים ממוינים לפי מיקום; מלמעלה למטה.
getField(name)		מחזירה את השדה בעל השם מבלוק.
getFieldValue(name)		מחזירה את הערך הניטרלי מהשפה של השדה הנתון.
getHue()		קבלת ערך הגוון של HSV של בלוק. הערך null אם לא הוגדר גוון.
getIcon(type)
getIcons()
getInheritedDisabled()		תוכלו לברר אם החסימה מושבתת או לא בגלל הורים. הנכס המושבת של הבלוק עצמו לא נלקח בחשבון.
getInput(name)		מאחזרת את אובייקט הקלט בעל השם.
getInputsInline()		היא קובעת אם ערכי הקלט של הערכים מאורגנים בצורה אופקית או אנכית.
getInputTargetBlock(name)		מאחזרת את הבלוק שמצורף לקלט בעל השם.
getInputWithBlock(block)		מחזירים את הקלט שמתחבר לבלוק שצוין.
getNextBlock()		החזרה של בלוק ההצהרה הבא שמחובר ישירות לבלוק הזה.
getOutputShape()		מקבלים את צורת הפלט של הבלוק.
getParent()		ניתן להחזיר את הבלוק ההורה או null אם הוא נמצא ברמה העליונה. הבלוק ההורה הוא הבלוק שמחובר לחיבור הקודם (בבלוק של הצהרות) או הבלוק המחובר לחיבור הפלט (בבלוק ערכים).
getPreviousBlock()		מחזירה את הבלוק שמחובר לחיבור הקודם.
getיחסToSurfaceXY()		החזרת הקואורדינטות של הפינה השמאלית העליונה של הבלוק הזה ביחס למקור של משטח הציור (0,0), ביחידות של סביבת עבודה.
getRootBlock()		החזרת הבלוק העליון ביותר בעץ של הבלוק הזה. הוא יחזיר את עצמו אם הבלוק נמצא ברמה העליונה.
getStyleName()		מקבלים את השם של סגנון הבלוק.
getSurroundParent()		Return the parent block that surrounds the current block, or null if this block has no surrounding block. חסימת הורה יכולה להיות רק ההצהרה הקודמת, ואילו הבלוק שמקיף אותה הוא הצהרת if, בעוד לולאה וכו'.
getTooltip()		מחזירה את טקסט ההסבר הקצר עבור בלוק זה.
getVars()		החזרת כל המשתנים שהבלוק הזה מפנה אליהם.
hasIcon(type)
initModel()		קוראים ל-initModel בכל השדות בבלוק. ייתכן שהמערכת תבצע שיחות יותר מפעם אחת. יש להפעיל את initModel או initSvg אחרי יצירת בלוק ולפני האינטראקציה הראשונה איתו. אינטראקציות כוללות פעולות בממשק המשתמש (למשל לחיצה וגרירה) ואירועי הפעלה (למשל יצירה, מחיקה ושינוי).
isCollapsed()		תוכלו לבדוק אם החסימה מכווצת או לא.
isDeletable()		בודקים אם אפשר למחוק את הבלוק הזה או לא.
isDisposed()		הפונקציה מחזירה את הערך אם הבלוק הזה נמחק או נמחק.
isDuplicatable()		קבע אם הבלוק ניתן לשכפול או לא. אם משכפלים את הבלוק הזה עם צאצאים, הבלוק הזה יחרוג מהקיבולת של סביבת העבודה, ולא ניתן יהיה לשכפל אותו. אם יוצרים שכפול של הבלוק הזה וצאצאים, יש להוסיף כל סוג שהוא מעל ה-maxInstances שלהם, אי אפשר לשכפל את הבלוק הזה.
isEnabled()		תוכלו לבדוק אם החסימה הזו מופעלת או לא.
isInsertionMarker()		אפשר לבדוק אם הבלוק הזה הוא בלוק של סמני הזנה.
isOwnDeletable()		הפונקציה מחזירה את הערך (true או false) אם המאפיין הניתן למחיקה של הבלוק הזה הוא True או False.
isOwnEditable()		פונקציה זו מחזירה את הערך True או False, אם המאפיין הניתן לעריכה של הבלוק הזה הוא True.
isShadow()		אפשר לברר אם הבלוק הזה הוא בלוק צללים או לא.
jsonInit(json)		אפשר לאתחל את הבלוק הזה באמצעות תיאור JSON שידידותי לפלטפורמות שונות, וידידותי לשימוש בינלאומי.
mixin(mixinObj, opt_disableCheck)		צריך להוסיף מפתח/ערכים מ-מיקסinObj לאובייקט הבלוק הזה. כברירת מחדל, השיטה הזו תבדוק שהמפתחות ב-מיקסinObj לא יחליפו ערכים קיימים בבלוק, כולל ערכי אב טיפוס. כך מקבלים ביטוח מסוים מפני חוסר תאימות של שילובים או תוספים, עם תכונות חסימה עתידיות. כדי להשבית את הבדיקה הזו, צריך להעביר את הערך true כארגומנט השני.
moveBy(dx, dy, סיבה)		העברת בלוק לפי היסט יחסי.
moveInputBefore(name, refName)		צריך להעביר קלט בעל שם למיקום אחר בבלוק הזה.
moveNumberedInputBefore(inputIndex, refIndex)		מזיזים קלט ממוספר למיקום אחר בבלוק הזה.
removeIcon(type)		מסיר מהבלוק את הסמל שה-getType שלו תואם ל-iconType הנתון.
removeInput(name, opt_quiet)		יש להסיר קלט מהבלוק הזה.
renameVarById(oldId, newId)		התראה על שינוי שם של משתנה. אם המזהה תואם לאחד מהמשתנים של הבלוק הזה, משנים את השם שלו.
setCollapsed(collapsed)		אפשר להגדיר אם הבלוק יכווץ או לא.
setColour(colour)		שינוי הצבע של בלוק.
setCommentText(text)		אפשר להגדיר את טקסט התגובה של הבלוק הזה.
setDeletable(deletable)		אפשר לקבוע אם ניתן למחוק את הבלוק הזה או לא.
setEditable(editable)		האם ניתן לערוך את הבלוק הזה?
setEnabled(enabled)		קובעים אם החסימה מופעלת או לא.
setFieldValue(newValue, name)		מגדיר את הערך של השדה הנתון לבלוק הזה.
(setHelpUrl(url)		אפשר להגדיר את כתובת ה-URL של דף העזרה של החסימה הזו.
setInputsInline(newBoolean)		ניתן לקבוע אם ערכי הקלט של הערכים יאורגנו בצורה אופקית או אנכית.
setMovable(movable)		אפשר לקבוע אם ניתן להעביר את הבלוק הזה או לא.
setMutator(_mutator)		הוספת תיבת דו-שיח למשתנה הזה לחסימה.
setNextStatement(newBoolean, opt_check)		אפשר לקבוע אם בלוק אחר יוכל לשרשר בחלק התחתון של הבלוק הזה.
setOnChange(onchangeFn)		מגדירה פונקציית קריאה חוזרת לשימוש בכל פעם שסביבת העבודה ברמה העליונה של הבלוק משתנה, ומחליפה כל גורם handler קודם לשינוי. בדרך כלל קוראים לזה רק מה-constructor, מפונקציית הבלוק של סוג הבלוקים (block type) או מפונקציית מאתחל תוסף.
setOutput(newBoolean, opt_check)		קובעים אם הבלוק הזה יחזיר ערך.
setOutputShape(outputShape)		מגדירים את צורת הפלט של הבלוק.
setPreviousStatement(newBoolean, opt_check)		אפשר לקבוע אם הבלוק הזה יוכל לשרשר לחלק התחתון של בלוק אחר.
setStyle(blockStyleName)		מגדירים את ערכי הסגנון והצבעים של בלוקים.
setTooltip(newTip)		מגדיר את ההסבר הקצר לבלוק הזה.
setWarningText(_text, _opt_id)		הגדרה של טקסט האזהרה של הבלוק הזה.
toDevString()		השיטה הזו מחזירה מחרוזת שמתארת את הבלוק הזה במונחים של מפתחים (סוג שם ומזהה; באנגלית בלבד). מיועד לשימוש ביומנים ובשגיאות של המסוף. אם צריך מחרוזת שמשתמשת בשפת האם של המשתמש (כולל חסימה של טקסט, ערכי שדות וחסימות צאצא), צריך להשתמש ב-[toString()].
toString(opt_maxLength, opt_emptyToken)		אפשר ליצור ייצוג טקסט קריא (לבני אדם) של הבלוק הזה ושל כל הצאצאים.
unPlug(opt_healStack)		צריך לנתק את הבלוק הזה מהבלוק העליון שלו. אם הבלוק הזה הוא הצהרה, אפשר לחבר מחדש את הבלוק שמתחתיו עם הבלוק למעלה.