blockly > חסימה

חסימת הכיתה

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

Signature:

export declare class Block implements IASTNodeLocation 

הטמעות: IASTNodeLocation

יצרנים

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

מאפיינים

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

שיטות

שיטה	גורמי שינוי	תיאור
addIcon(icon)		הוספת הסמל הנתון לבלוק.
allInputsFilled(opt_shadowBlocksAreFilled)		הפונקציה בודקת באופן חזרתי אם כל הקלט של ההצהרה והערכים מולאו בבלוקים. הפונקציה בודקת גם את כל הבלוקים הבאים של הצהרות במקבץ הזה.
appendDummyInput(name)		צירוף שורת קלט דמה.
appendEndRowInput(name)		הפונקציה מצרפת קלט שמסתיים בשורה.
appendInput(input)		מצרף את שורת הקלט הנתונה. אפשר להוסיף לבלוק ערכי קלט מותאמים אישית.
appendStatementInput(name)		מצרפת שורת קלט של הצהרה.
appendValueInput(name)		הפונקציה מוסיפה שורת קלט של ערך.
bumpNeighbours()		ממקמים בלוקים לא מחוברים ולא מיושרים. שני בלוקים שאינם מחוברים בפועל לא אמורים להימצא בטעות על המסך.
dispose(healStack)		צריך להשליך את הבלוק הזה.
disposeInternal()	protected	נפטרים מהבלוק הזה בלי לבצע את הפעולות הנדרשות על ידי הבלוק העליון. לדוגמה לא מפעילה אירועים, מנתקת את הבלוק וכו'.
doInit_()	protected	קוראת לפונקציה init() ומטפלת בהפעלת האירועים המשויכים וכו'.
getChildren(ordered)		מאתרים את כל הבלוקים שמוצבים ישירות בתוך הבלוק הזה. כולל קלט של ערך ושל הצהרה, וכן כל הצהרה הבאה. לא כולל חיבורים בכרטיסיית פלט או בכל הצהרה קודמת. הבלוקים ממוינים לפי מיקום באופן אופציונלי. מלמעלה למטה.
getColour()		קבלו את הצבע של בלוק.
getCommentText()		מחזיר את התגובה בבלוק זה (או null אם אין תגובה).
getDescendants(ordered)		מאתרים את כל הבלוקים שבתוך הבלוק הזה, באופן ישיר או עקיף. כולל את הבלוק הזה ברשימה. הדוח כולל קלט של ערכים והצהרות, וגם את כל ההצהרות הבאות. לא כולל חיבור בכרטיסיית פלט או הצהרות קודמות. הבלוקים ממוינים לפי מיקום באופן אופציונלי. מלמעלה למטה.
getDisabledReasons()		לקבל רשימה של סיבות להשבתה הנוכחית של החסימה, אם יש כזו. אם החסימה מופעלת, הקבוצה הזו תהיה ריקה.
getField(name)		מחזירה את השדה בעל השם מבלוק.
getFieldValue(name)		מחזירה את הערך של השדה הנתון בשפה ניטרלית.
getHue()		קבלת ערך גוון ה-HSV של בלוק. הערך null אם לא הוגדר גוון.
getIcon(type)
getIcons()
getInheritedDisabled()		בודקים אם החסימה מושבתת או לא בגלל ההורים. לא נתייחס לנכס המושבת של החסימה עצמה.
getInput(name)		מאחזר את אובייקט הקלט בעל השם.
getInputsInline()		בדיקה אם ערכי הקלט מסודרים לרוחב או לאורך.
getInputTargetBlock(name)		מאחזר את הבלוק המצורף לקלט בעל השם.
getInputWithBlock(block)		מחזירה את הקלט שמתחבר לבלוק שצוין.
getNextBlock()		החזרת בלוק ההצהרה הבא שמחובר ישירות לבלוק זה.
getOutputShape()		מקבלים את צורת הפלט של הבלוק.
getParent()		הפונקציה מחזירה את חסימת ההורה או את הערך null אם החסימה היא ברמה העליונה. בלוק ההורה הוא הבלוק שמחובר לחיבור הקודם (לבלוק של הצהרה) או הבלוק שמחובר לחיבור הפלט (לבלוק של ערכים).
getPreviousBlock()		מחזירה את הבלוק שמחובר לחיבור הקודם.
getRelativeToSurfaceXY()		הפונקציה מחזירה את הקואורדינטות של הפינה השמאלית העליונה של הבלוק הזה ביחס למקור של משטח השרטוט (0,0), ביחידות של סביבת העבודה.
getRootBlock()		החזרת הבלוק העליון בעץ הבלוק הזה. הפעולה הזו תחזיר את עצמה אם הבלוק הזה נמצא ברמה העליונה.
getStyleName()		מוצאים את השם של סגנון הבלוק.
getSurroundParent()		הפונקציה מחזירה את בלוק ההורה שמקיף את הבלוק הנוכחי. לחלופין, אם אין בלוק הזה בלוק הזה, צריך להשאיר את השדה null. בלוק הורה יכול להיות רק ההצהרה הקודמת, ואילו הבלוק שמסביב הוא הצהרה if, לולאה וכו'.
getTooltip()		מחזירה את הטקסט של ההסבר הקצר על הבלוק הזה.
getVars()		מחזירה את כל המשתנים שהבלוק הזה מפנה אליהם.
hasDisabledReason(reason)		בודקים אם החסימה מושבתת כרגע מהסיבה שצוינה.
hasIcon(type)
initModel()		קוראים ל-initModel בכל השדות בבלוק. ייתכן שיתקשרו יותר מפעם אחת. צריך לקרוא ל-initModel או ל-initSvg אחרי יצירת בלוק ולפני האינטראקציה הראשונה איתו. האינטראקציות כוללות פעולות בממשק המשתמש (למשל, לחיצה וגרירה) ואירועים שהופעלו (למשל, יצירה, מחיקה ושינוי).
isCollapsed()		בודקים אם הבלוק מכווץ או לא.
isDeletable()		בודקים אם ניתן למחוק את הבלוק הזה או לא.
isDisposed()		הפונקציה מחזירה אם הבלוק הזה הוסר או נמחק.
isDuplicatable()		בודקים אם ניתן לשכפל או לא. אם משכפלים את הבלוק הזה ואת הצאצאים, הבלוק הזה חורג מהקיבולת של סביבת העבודה ולא ניתן לשכפל אותו. אם משכפלים את הבלוק הזה, והצאצאים מציבים כל טיפוס מעל המכונות המקסימליות שלהם, לא ניתן לשכפל את הבלוק הזה.
isEnabled()		ניתן לבדוק אם החסימה הזו מופעלת או לא. חסימה נחשבת מופעלת אם אין סיבות לכך שהיא תושבת. יכול להיות שחסימה עדיין תהיה מושבתת מסיבות אחרות, גם אם המשתמש מנסה להפעיל אותה באופן ידני, למשל כשהחסימה נמצאת במיקום לא חוקי.
isInsertionMarker()		ניתן לבדוק אם הבלוק הזה הוא בלוק של סמן הוספה או לא.
isOwnDeletable()		הפונקציה מחזירה אם הנכס שניתן לביטול של הבלוק הזה הוא True או False.
isOwnEditable()		הפונקציה מחזירה אם המאפיין שניתן לעריכה של הבלוק הזה הוא True או False.
isShadow()		בודקים אם הבלוק הזה הוא בלוק צללית או לא.
jsonInit(json)		כדי לאתחל את הבלוק הזה, צריך להשתמש בתיאור JSON בפלטפורמות שונות שמתאים לבינלאומיות.
mixin(mixinObj, opt_disableCheck)		הוספת מפתח/ערכים מ-מיקסinObj לאובייקט הבלוק הזה. כברירת מחדל, השיטה הזו תבדוק שהמקשים ב-מיקסinObj לא יחליפו ערכים קיימים בבלוק, כולל ערכים של אב טיפוס. מדובר בביטוח מסוים מפני אי-תאימות של תמהילים או תוספים לתכונות עתידיות של בלוקים. אפשר להשבית את הבדיקה הזו על ידי העברת True כארגומנט השני.
moveBy(dx, dy, Reason)		העברת בלוק לפי היסט יחסי.
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)		אפשר להגדיר אם ניתן למחוק את הבלוק הזה או לא.
setDisabledReason(disabled, reason)		מוסיפים או מסירים סיבה שבגללה החסימה עשויה להיות מושבתת. אם לחסימה יש סיבה כלשהי להשבית אותה, החסימה עצמה תיחשב כמושבת. אפשר להשבית חסימה מכמה סיבות בלתי תלויות, למשל כשמשתמש משבית אותה באופן ידני או שהחסימה לא חוקית.
setEditable(editable)		קובעים אם ניתן לערוך את הבלוק הזה או לא.
setEnabled(enabled)
setFieldValue(newValue, name)		מגדיר את הערך של השדה הנתון עבור בלוק זה.
setHelpUrl(url)		הגדרת כתובת ה-URL של דף העזרה של הבלוק הזה.
setInputsInline(newBoolean)		אפשר לקבוע אם ערכי הקלט מסודרים לרוחב או לאורך.
setMovable(movable)		מגדירים אם הבלוק הזה ניתן להעברה או לא.
setMutator(_mutator)		פתיחת תיבת דו-שיח של בלוק זה.
setNextStatement(newBoolean, opt_check)		אפשר לקבוע אם ניתן לשרשר עוד בלוק בחלק התחתון של הבלוק הזה.
setOnChange(onchangeFn)		מגדירה פונקציית קריאה חוזרת לשימוש בכל פעם שסביבת העבודה של ההורה של הבלוק משתנה, ומחליפה כל handler קודם לשינוי. את זה קוראים בדרך כלל רק מה-constructor, מהפונקציה של מאתחל סוג הבלוק או מפונקציה של מאתחל התוספים.
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)		מנתקים את הבלוק הזה מהבלוק העליון שלו. אם הבלוק הזה הוא הצהרה, אפשר לחבר מחדש את הבלוק שמתחת עם הבלוק שלמעלה.