blockly > مسدود کردن

کلاس بلوک

کلاس برای یک بلوک معمولاً مستقیماً فراخوانی نمی شود، () workspace.newBlock ترجیح داده می شود.

امضا:

export declare class Block implements IASTNodeLocation, IDeletable 

پیاده سازی: IASTNodeLocation , قابل حذف

سازندگان

سازنده اصلاح کننده ها شرح
(سازنده) (فضای کاری، نمونه اولیه، opt_id) یک نمونه جدید از کلاس Block می سازد

خواص

ویژگی اصلاح کننده ها تایپ کنید شرح
childBlocks_ protected این[]
فرو ریخت_ protected بولی
COLLAPSED_FIELD_NAME

static

readonly

رشته شناسه زبان خنثی که به فیلد جمع‌شده داده شده است.
COLLAPSED_INPUT_NAME

static

readonly

رشته شناسه زبان خنثی که به ورودی جمع‌شده داده می‌شود.
رنگ_ protected رشته رنگ بلوک در قالب "#RRGGBB".
ساختن؟ (p1: مسدود کردن ) => باطل (اختیاری) یک تابع اختیاری که بلاک را بر اساس محتویات گفتگوی mutator پیکربندی مجدد می کند.
contextMenu بولی
داده ها رشته | خالی داده‌های متنی اختیاری که بین بلوک‌ها و XML رفت و آمد می‌کنند. تاثیری ندارد. ممکن است توسط اشخاص ثالث برای اطلاعات متا استفاده شود.
تجزیه شود؟ (p1: فضای کاری ) => مسدود کردن (اختیاری) یک تابع اختیاری که گفتگوی mutator را با اجزای این بلوک پر می کند.
از بین رفتن؟ () => باطل (اختیاری) یک روش اختیاری که در حین دفع نامیده می شود.
domToMutation؟ (p1: عنصر) => void (اختیاری) یک روش deserialization اختیاری برای تعریف نحوه جداسازی حالت جهش از XML. این باید با تعریف mutationToDom همراه شود.
getDeveloperVariables؟ () => رشته[] (اختیاری) یک ویژگی اختیاری برای اعلام متغیرهای توسعه دهنده. لیستی از نام متغیرها را برای استفاده توسط مولدها برگردانید. متغیرهای توسعه دهنده هرگز به کاربر نشان داده نمی شوند، بلکه به عنوان متغیرهای سراسری در کد تولید شده اعلام می شوند.
کلاه؟ رشته (اختیاری) نام نوع کلاه.
helpUrl رشته | تابع | خالی رشته کمک بلوک یا تابعی که URL را برمی گرداند. پوچ برای هیچ کمکی.
نمادها IIcon []
شناسه رشته
شروع؟ () => باطل (اختیاری) یک روش اختیاری که در هنگام مقداردهی اولیه نامیده می شود.
inputList ورودی[]
inputsInline؟ بولی (اختیاری)
inputsInlineDefault؟ بولی (اختیاری)
isInFlyout بولی
isInMutator است بولی
isInsertionMarker_ protected بولی اگر این بلوک یک نشانگر درج باشد درست است.
loadExtraState؟ (p1: any) => void (اختیاری) یک روش سریال سازی اختیاری برای تعریف نحوه جداسازی حالت اضافی بلوک (مثلاً وضعیت جهش) از چیزی که با JSON سازگار است. این باید با تعریف saveExtraState همراه شود.
mutationToDom؟ (...p1: any[]) => عنصر (اختیاری) یک روش سریال سازی اختیاری برای تعریف نحوه سریال سازی حالت جهش به XML. این باید با تعریف domToMutation همراه شود.
اتصال بعدی اتصال | خالی
در تغییر؟ ((ص1: چکیده ) => باطل) | خالی (اختیاری) یک روش پاسخ به تماس اختیاری برای استفاده هر زمان که فضای کاری والد بلوک تغییر کند. این معمولاً فقط از سازنده، تابع اولیه ساز نوع بلوک یا تابع اولیه ساز پسوند فراخوانی می شود.
خروجی اتصال اتصال | خالی
خروجی شکل_ protected شماره | خالی
والدین بلوک_ protected این | خالی
اتصال قبلی اتصال | خالی
ارائه شده است بولی | خالی
RTL بولی
saveExtraState؟ (doFullSerialization?: boolean) => هر (اختیاری) یک روش سریال سازی اختیاری برای تعریف نحوه سریال سازی حالت اضافی بلوک (مثلاً وضعیت جهش) به چیزی که با JSON سازگار است. این باید با تعریف loadExtraState همراه شود.
styleName_ protected رشته نام سبک بلوک.
suppressPrefixSuffix بولی | خالی یک ویژگی اختیاری برای حذف اضافه کردن STATEMENT_PREFIX و STATEMENT_SUFFIX به کد تولید شده.
راهنمای ابزار Tooltip.TipInfo
نوع رشته
فضای کار فضای کار

مواد و روش ها

روش اصلاح کننده ها شرح
افزودن نماد (نماد) نماد داده شده را به بلوک اضافه می کند.
allInputsFilled(opt_shadowBlocksAreFilled) به صورت بازگشتی بررسی می کند که آیا تمام ورودی های دستور و مقدار با بلوک ها پر شده اند یا خیر. همچنین تمام بلوک های دستور زیر را در این پشته بررسی می کند.
appendDummyInput(نام) یک ردیف ورودی ساختگی اضافه می کند.
appendEndRowInput(نام) ورودیی را اضافه می کند که ردیف را پایان می دهد.
appendInput (ورودی)

ردیف ورودی داده شده را اضافه می کند.

اجازه می دهد تا ورودی های سفارشی به بلوک اضافه شوند.

appendStatementInput(نام) یک ردیف ورودی بیانیه اضافه می کند.
appendValueInput(نام) یک ردیف ورودی مقدار اضافه می کند.
bumpNeighbours() بلوک های غیر متصل را از تراز خارج کنید. دو بلوک که در واقع به هم متصل نیستند نباید به طور تصادفی روی صفحه قرار گیرند.
دور ریختن (healStack) این بلوک را دور بریزید.
disposeInternal() protected این بلوک را بدون انجام کارهای مورد نیاز بلوک بالا از بین می برد. به عنوان مثال رویدادها را روشن نمی کند، بلوک را از برق جدا نمی کند و غیره.
doInit_() protected تابع init() را فراخوانی می کند و شلیک رویداد مرتبط و غیره را کنترل می کند.
getChildren (سفارش شده) تمام بلوک‌هایی را که مستقیماً در داخل این بلوک قرار دارند، پیدا کنید. شامل مقادیر و ورودی‌های بیانیه و همچنین هر عبارت زیر است. هرگونه اتصال در برگه خروجی یا هر عبارت قبلی را مستثنی می کند. بلوک ها به صورت اختیاری بر اساس موقعیت مرتب می شوند. بالا به پایین.
getColour() رنگ بلوک را دریافت کنید.
getCommentText() نظر روی این بلوک را برمی‌گرداند (یا اگر نظری وجود نداشته باشد پوچ).
دریافت فرزندان (سفارش شده) تمام بلوک هایی را که به طور مستقیم یا غیرمستقیم در داخل این بلوک قرار گرفته اند، پیدا کنید. شامل این بلوک در لیست است. شامل مقادیر و ورودی‌های بیانیه و همچنین هر عبارات زیر است. هرگونه اتصال در برگه خروجی یا هر عبارت قبلی را مستثنی می کند. بلوک ها به صورت اختیاری بر اساس موقعیت مرتب می شوند. بالا به پایین.
getField (نام) فیلد نامگذاری شده را از یک بلوک برمی گرداند.
getFieldValue (نام) مقدار زبان خنثی فیلد داده شده را برمی گرداند.
getHue() مقدار رنگ HSV یک بلوک را دریافت کنید. اگر رنگ تنظیم نشده باشد، تهی است.
دریافت نماد (نوع)
getIcons()
getInheritedDisabled() ببینید آیا این بلوک به دلیل والدین غیرفعال شده است یا خیر. دارایی غیرفعال شده خود بلوک در نظر گرفته نمی شود.
getInput (نام) شی ورودی نامگذاری شده را واکشی می کند.
getInputsInline() دریافت کنید که آیا ورودی های مقدار به صورت افقی یا عمودی مرتب شده اند.
getInputTargetBlock(نام) بلوک متصل به ورودی نامگذاری شده را واکشی می کند.
getInputWithBlock (block) ورودی که به بلوک مشخص شده متصل می شود را برگردانید.
getNextBlock() بلوک دستور بعدی را که مستقیماً به این بلوک متصل است، برگردانید.
getOutputShape() شکل خروجی بلوک را دریافت کنید.
getParent() اگر این بلوک در سطح بالایی است، بلوک والد یا تهی را برگردانید. بلوک والد یا بلوک متصل به اتصال قبلی (برای بلوک دستور) یا بلوک متصل به اتصال خروجی (برای بلوک مقدار) است.
getPreviousBlock() بلوک متصل به اتصال قبلی را برمی گرداند.
getRelativeToSurfaceXY() مختصات گوشه سمت چپ بالای این بلوک را نسبت به مبدأ سطح رسم (0,0) در واحدهای فضای کاری برگردانید.
getRootBlock() بالاترین بلوک را در درخت این بلوک برگردانید. اگر این بلوک در سطح بالایی باشد، این خود به خود باز می گردد.
getStyleName() نام سبک بلوک را دریافت کنید.
getSurroundParent() بلوک والد را که اطراف بلوک فعلی را احاطه کرده است، برگردانید یا اگر این بلوک بلوک اطراف ندارد، آن را باطل کنید. یک بلوک والد ممکن است فقط عبارت قبلی باشد، در حالی که بلوک اطراف یک دستور if، حلقه while و غیره است.
getTooltip() متن راهنمای ابزار را برای این بلوک برمی‌گرداند.
getVars() همه متغیرهای ارجاع شده توسط این بلوک را برگردانید.
دارای نماد (نوع)
initModel() initModel را در تمام فیلدهای بلوک فراخوانی کنید. ممکن است بیش از یک بار تماس گرفته شود. initModel یا initSvg باید پس از ایجاد یک بلوک و قبل از اولین تعامل با آن فراخوانی شوند. فعل و انفعالات شامل اقدامات UI (مانند کلیک کردن و کشیدن) و شلیک رویدادها (مانند ایجاد، حذف و تغییر) است.
isCollapsed() دریافت کنید که آیا بلوک فرو ریخته است یا خیر.
isDeletable() ببینید آیا این بلوک قابل حذف است یا خیر.
isDisposed() اگر این بلوک از بین رفته/حذف شده باشد برمی گردد.
isDuplicatable() دریافت کنید که آیا بلوک تکراری است یا خیر. اگر کپی کردن این بلوک و فرزندان این بلوک را بیش از ظرفیت فضای کاری قرار دهد، این بلوک تکراری نیست. اگر کپی کردن این بلوک و فرزندان هر نوع را روی maxInstance های خود قرار دهند، این بلوک تکراری نیست.
فعال شده است() ببینید آیا این بلوک فعال است یا خیر.
isInsertionMarker() ببینید آیا این بلوک یک بلوک نشانگر درج است یا خیر.
isOwnDeletable() درست یا نادرست بودن ویژگی قابل حذف خود این بلوک را برگردانید.
isOwnEditable() درست یا نادرست بودن ویژگی قابل ویرایش خود این بلوک را برگردانید.
isShadow() ببینید آیا این بلوک یک بلوک سایه است یا خیر.
jsonInit(json) این بلوک را با استفاده از یک توصیف JSON بین پلتفرمی و بین المللی سازی اولیه کنید.
mixin(mixinObj، opt_disableCheck) کلید/مقدارها را از mixinObj به این شیء بلوک اضافه کنید. به طور پیش فرض، این روش بررسی می کند که کلیدهای mixinObj مقادیر موجود در بلوک، از جمله مقادیر نمونه اولیه را بازنویسی نکنند. این امر بیمه ای را در برابر ناسازگاری های میکسین / افزونه با ویژگی های بلوک آینده ارائه می دهد. این بررسی را می توان با ارسال true به عنوان آرگومان دوم غیرفعال کرد.
moveBy (dx، dy، دلیل) یک بلوک را با یک افست نسبی حرکت دهید.
moveInputBefore (name, refName) یک ورودی با نام را به مکان دیگری در این بلوک منتقل کنید.
moveNumberedInputBefore (InputIndex, refIndex) یک ورودی شماره گذاری شده را به مکان دیگری در این بلوک منتقل کنید.
حذف نماد (نوع) نمادی را که getType آن با نوع مشخص شده iconType مطابقت دارد از بلوک حذف می کند.
removeInput (نام، opt_quiet) یک ورودی را از این بلوک حذف کنید.
renameVarById (oldId، newId) اعلان تغییر نام یک متغیر. اگر شناسه با یکی از متغیرهای این بلوک مطابقت دارد، نام آن را تغییر دهید.
setCollapsed (جمع شده) تنظیم کنید که بلوک جمع شود یا خیر.
setColor (رنگ) رنگ بلوک را تغییر دهید
setCommentText(متن) متن نظر این بلوک را تنظیم کنید.
مجموعه قابل حذف (قابل حذف) تنظیم کنید که آیا این بلوک قابل حذف است یا خیر.
مجموعه قابل ویرایش (قابل ویرایش) تنظیم کنید که آیا این بلوک قابل ویرایش است یا خیر.
setEnabled (فعال) تنظیم کنید که بلوک فعال باشد یا خیر.
setFieldValue (newValue، name) مقدار فیلد داده شده را برای این بلوک تنظیم می کند.
setHelpUrl(url) URL صفحه راهنمای این بلوک را تنظیم کنید.
setInputsInline(newBoolean) تنظیم کنید که ورودی های مقدار به صورت افقی یا عمودی مرتب شوند.
setMovable (متحرک) تنظیم کنید که آیا این بلوک متحرک است یا خیر.
setMutator(_mutator) به این بلوک یک گفتگوی mutator بدهید.
setNextStatement(newBoolean، opt_check) تنظیم کنید که آیا بلوک دیگری می تواند به پایین این بلوک زنجیره ای بزند یا خیر.
setOnChange (onchangeFn) یک تابع تماس را تنظیم می‌کند تا هر زمان که فضای کاری والد بلوک تغییر می‌کند، از آن استفاده کند، و جایگزین هر کنترل‌کننده قبلی onchange شود. این معمولاً فقط از سازنده، تابع اولیه ساز نوع بلوک یا تابع اولیه ساز پسوند فراخوانی می شود.
setOutput (newBoolean، opt_check) تنظیم کنید که آیا این بلوک مقداری را برمی گرداند یا خیر.
setOutputShape (outputShape) شکل خروجی بلوک را تنظیم کنید.
setPreviousStatement(newBoolean، opt_check) تنظیم کنید که آیا این بلوک می تواند به پایین بلوک دیگری متصل شود یا خیر.
setStyle (blockStyleName) مقدار سبک و رنگ یک بلوک را تنظیم کنید.
setTooltip (نکته جدید) راهنمای ابزار را برای این بلوک تنظیم می کند.
setWarningText(_text، _opt_id) متن هشدار این بلوک را تنظیم کنید.
toDevString()

این روش رشته‌ای را برمی‌گرداند که این بلوک را با شرایط توسعه‌دهنده توصیف می‌کند (نام و شناسه تایپ، فقط انگلیسی).

در نظر گرفته شده است تا در لاگ ها و خطاهای کنسول استفاده شود. اگر به رشته ای نیاز دارید که از زبان مادری کاربر استفاده می کند (شامل متن بلوک، مقادیر فیلد و بلوک های فرزند)، از [toString()] استفاده کنید. .

toString (opt_maxLength، opt_emptyToken) یک نمایش متنی قابل خواندن توسط انسان از این بلوک و هر فرزند ایجاد کنید.
جدا کردن (opt_healStack) این بلوک را از بلوک برترش جدا کنید. اگر این بلوک یک دستور است، به صورت اختیاری بلوک زیر را با بلوک در بالا وصل کنید.