blockly‏ > Block

סוג בלוק

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

Signature:

export declare class Block 

יצרנים

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

מאפיינים

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

Methods

שיטה	גורמי שינוי	תיאור
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)		הפונקציה מחזירה את השדה בעל השם מבלוק.
getFields()		הפונקציה מחזירה גנרטור שמספק כל שדה בבלוק. גנרטור שאפשר להשתמש בו כדי להריץ את כל האיטרציות של השדות בבלוק.
getFieldValue(name)		הפונקציה מחזירה את הערך של השדה הנתון ללא תלות בשפה.
getHue()‎		אחזור ערך הטון (hue) של בלוק בשיטת 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, לולאת while וכו'.
getTooltip()		הפונקציה מחזירה את הטקסט של ההסבר הקצר של הבלוק הזה.
getVars()		הפונקציה מחזירה את כל המשתנים שהבלוק הזה מפנה אליהם.
hasDisabledReason(reason)		בודקים אם החסימה מושבתת כרגע מהסיבה שצוינה.
hasIcon(type)
initModel()		קוראים ל-initModel בכל השדות בבלוק. יכול להיות שהפונקציה הזו תופעל יותר מפעם אחת. צריך להפעיל את initModel או את initSvg אחרי יצירת הבלוק ולפני האינטראקציה הראשונה איתו. אינטראקציות כוללות פעולות בממשק המשתמש (למשל לחיצה וגרירה) והפעלת אירועים (למשל יצירה, מחיקה ושינוי).
isCollapsed()		אחזור של המצב שבו הבלוק מכווץ או מורחב.
isDeletable()		קבלת מידע על האפשרות למחוק את הבלוק הזה.
isDisposed()		הפונקציה מחזירה אם הבלוק הזה הושמד או נמחק.
isDuplicatable()		קבלת מידע על האפשרות ליצור עותק כפול של הבלוק. אם כפילת הבלוק הזה והצאצאים שלו תגרום לחריגה מהקיבולת של סביבת העבודה, לא תוכלו להכפיל את הבלוק. אם כפילות של הבלוק הזה ושל הצאצאים שלו תגרום לחריגה מסוג כלשהו מ-maxInstances, לא ניתן יהיה ליצור כפילות של הבלוק הזה.
isEnabled()		קבלת מידע על מצב החסימה. חסימה נחשבת מופעלת אם אין סיבה להשבית אותה. יכול להיות שהחסימה עדיין תהיה מושבתת מסיבות אחרות, גם אם המשתמש ינסה להפעיל אותה באופן ידני, למשל אם החסימה נמצאת במיקום לא חוקי.
isInsertionMarker()		הפונקציה מאפשרת לבדוק אם הבלוק הזה הוא בלוק של סמן להוספה או לא.
isOwnDeletable()		הפונקציה מחזירה את הערך True או False של המאפיין deletable של הבלוק הזה.
isOwnEditable()		הפונקציה מחזירה את הערך true או false של המאפיין הניתן לעריכה של הבלוק הזה.
isShadow()		בדיקה אם הבלוק הזה הוא בלוק צל או לא.
jsonInit(json)		מפעילים את הבלוק הזה באמצעות תיאור JSON שמתאים לפלטפורמות שונות ולתרגום לשפות שונות.
mixin(mixinObj, opt_disableCheck)		מוסיפים מפתחות/ערכים מ-mixinObj לאובייקט הבלוק הזה. כברירת מחדל, השיטה הזו תבדוק שהמפתחות ב-mixinObj לא יחליפו ערכים קיימים בבלוק, כולל ערכים של אב טיפוס. כך אפשר להבטיח תאימות מסוימת של רכיבי mixin או תוספים לתכונות עתידיות של בלוקים. אפשר להשבית את הבדיקה הזו על ידי העברת 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)		מגדירים אם אפשר לערוך את הבלוק הזה או לא.
setFieldValue(newValue, name)		הגדרת הערך של השדה הנתון עבור הבלוק הזה.
setHelpUrl(url)		מגדירים את כתובת ה-URL של דף העזרה של הבלוק הזה.
setInputsInline(newBoolean)		מגדירים אם קלט הערכים ימוקם באופן אופקי או אנכי.
setMovable(movable)		מגדירים אם ניתן להזיז את הבלוק הזה או לא.
setMutator(_mutator)		נותנים לבלוק הזה תיבת דו-שיח של מוטאטור.
setNextStatement(newBoolean, opt_check)		הגדרת האפשרות של שרשור בלוק אחר לתחתית הבלוק הזה.
setOnChange(onchangeFn)		הגדרת פונקציית קריאה חוזרת (callback) לשימוש בכל פעם שסביבת העבודה של האב של הבלוק משתנה, והחלפת כל טיפול קודם באירוע onchange. בדרך כלל, קוראים לפונקציה הזו רק מה-constructor, מפונקציית ה-initializer של סוג הבלוק או מפונקציית ה-initializer של התוסף.
setOutput(newBoolean, opt_check)		מגדירים אם הבלוק הזה מחזיר ערך.
setOutputShape(outputShape)		מגדירים את צורת הפלט של הבלוק.
setPreviousStatement(newBoolean, opt_check)		הגדרה של האפשרות של הבלוק הזה להצטרף לבלוק אחר בתחתית.
setStyle(blockStyleName)		הגדרת ערכי הסגנון והצבע של בלוק.
setTooltip(newTip)		הגדרת ההסבר הקצר של הבלוק הזה.
setWarningText(_text, _opt_id)		מגדירים את טקסט האזהרה של הבלוק הזה.
toDevString()		השיטה הזו מחזירה מחרוזת שמתארת את ה-Block הזה במונחים של מפתחים (שם הסוג והמזהה, באנגלית בלבד). מיועד לשימוש רק ביומני מסוף ובשגיאות. אם אתם צריכים מחרוזת שמשתמשת בשפה הלאומית של המשתמש (כולל טקסט של בלוקים, ערכים של שדות ובלוקים צאצאים), השתמשו ב-toString().
toString(opt_maxLength, opt_emptyToken)		יוצרים ייצוג טקסט שאנשים יכולים לקרוא של הבלוק הזה ושל כל הצאצאים שלו.
unplug(opt_healStack)		מנתקים את הבלוק הזה מהבלוק ברמה שמעליו. אם הבלוק הזה הוא משפט, אפשר לחבר מחדש את הבלוק שמתחת לבלוק שמעל.