blockly > مسدود کردن

کلاس بلوک

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

امضا:

export declare class Block implements IASTNodeLocation 

پیاده سازی: 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 را با اجزای این بلوک پر می کند.
نابود کردن؟		() => باطل	(اختیاری) یک روش اختیاری که در حین دفع نامیده می شود.
دفع کردن	protected	بولی	آیا بلوک فعلی در حال حاضر در مرحله دفع است؟
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 همراه شود.
اتصال بعدی		اتصال | تهی
onchange		((ص1: چکیده ) => باطل) | تهی	(اختیاری) یک روش پاسخ به تماس اختیاری برای استفاده هر زمان که فضای کاری والد بلوک تغییر کند. این معمولاً فقط از سازنده، تابع اولیه ساز نوع بلوک یا تابع اولیه ساز پسوند فراخوانی می شود.
خروجی اتصال		اتصال | تهی
خروجی شکل_	protected	شماره | تهی
والدین بلوک_	protected	این | تهی
اتصال قبلی		اتصال | تهی
ارائه شده است	readonly	بولی	آیا این بلوک BlockSVG است؟
RTL		بولی
saveExtraState؟		(doFullSerialization?: boolean) => هر	(اختیاری) یک روش سریال سازی اختیاری برای تعریف نحوه سریال سازی حالت اضافی بلوک (مثلاً وضعیت جهش) به چیزی که با JSON سازگار است. این باید با تعریف loadExtraState همراه شود.
styleName_	protected	رشته	نام سبک بلوک.
suppressPrefixSuffix		بولی | تهی	یک ویژگی اختیاری برای حذف اضافه کردن STATEMENT_PREFIX و STATEMENT_SUFFIX به کد تولید شده.
راهنمای ابزار		Tooltip.TipInfo
نوع		رشته
فضای کار		فضای کار

روش ها

روش	اصلاح کننده ها	توضیحات
افزودن نماد (نماد)		نماد داده شده را به بلوک اضافه می کند.
allInputsFilled(opt_shadowBlocksAreFilled)		به صورت بازگشتی بررسی می کند که آیا تمام ورودی های دستور و مقدار با بلوک ها پر شده اند یا خیر. همچنین تمام بلوک های دستور زیر را در این پشته بررسی می کند.
appendDummyInput(نام)		یک ردیف ورودی ساختگی اضافه می کند.
appendEndRowInput(نام)		ورودیی را اضافه می کند که ردیف را پایان می دهد.
appendInput (ورودی)		ردیف ورودی داده شده را اضافه می کند. اجازه می دهد تا ورودی های سفارشی به بلوک اضافه شوند.
appendStatementInput(نام)		یک ردیف ورودی بیانیه اضافه می کند.
appendValueInput(نام)		یک ردیف ورودی مقدار اضافه می کند.
bumpNeighbours()		بلوک های غیر متصل را از تراز خارج کنید. دو بلوک که در واقع به هم متصل نیستند نباید به طور تصادفی روی صفحه قرار گیرند.
dispose (healStack)		این بلوک را دور بریزید.
disposeInternal()	protected	این بلوک را بدون انجام کارهای مورد نیاز بلوک بالا از بین می برد. به عنوان مثال رویدادها را روشن نمی کند، بلوک را از برق جدا نمی کند و غیره.
doInit_()	protected	تابع init() را فراخوانی می کند و شلیک رویداد مرتبط و غیره را کنترل می کند.
getChildren (سفارش شده)		تمام بلوک‌هایی را که مستقیماً در داخل این بلوک قرار دارند، پیدا کنید. شامل مقادیر و ورودی‌های بیانیه و همچنین هر عبارت زیر است. هرگونه اتصال در برگه خروجی یا هر عبارت قبلی را مستثنی می کند. بلوک ها به صورت اختیاری بر اساس موقعیت مرتب می شوند. بالا به پایین
getColour()		رنگ بلوک را دریافت کنید.
getCommentText()		نظر روی این بلوک را برمی‌گرداند (یا اگر نظری وجود نداشته باشد پوچ).
دریافت فرزندان (سفارش شده)		تمام بلوک هایی را که به طور مستقیم یا غیرمستقیم در داخل این بلوک قرار گرفته اند، پیدا کنید. شامل این بلوک در لیست است. شامل مقادیر و ورودی‌های بیانیه و همچنین هر عبارات زیر است. هرگونه اتصال در برگه خروجی یا هر عبارت قبلی را مستثنی می کند. بلوک ها به صورت اختیاری بر اساس موقعیت مرتب می شوند. بالا به پایین
getDisabledReasons()		در صورت وجود، مجموعه‌ای از دلایل غیرفعال بودن بلوک را دریافت کنید. اگر بلوک فعال باشد، این مجموعه خالی خواهد بود.
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()		همه متغیرهای ارجاع شده توسط این بلوک را برگردانید.
hasDisabledReason(دلیل)		دریافت کنید که آیا بلوک در حال حاضر به دلیل ارائه شده غیرفعال است یا خیر.
دارای نماد (نوع)
initModel()		initModel را در تمام فیلدهای بلوک فراخوانی کنید. ممکن است بیش از یک بار تماس گرفته شود. initModel یا initSvg باید پس از ایجاد یک بلوک و قبل از اولین تعامل با آن فراخوانی شوند. فعل و انفعالات شامل اقدامات UI (مانند کلیک کردن و کشیدن) و شلیک رویدادها (مانند ایجاد، حذف و تغییر) است.
isCollapsed()		دریافت کنید که آیا بلوک فرو ریخته است یا خیر.
isDeletable()		ببینید آیا این بلوک قابل حذف است یا خیر.
isDisposed()		اگر این بلوک از بین رفته/حذف شده باشد برمی گردد.
isDuplicatable()		دریافت کنید که آیا بلوک تکراری است یا خیر. اگر کپی کردن این بلوک و فرزندان این بلوک را بیش از ظرفیت فضای کاری قرار دهد، این بلوک تکراری نیست. اگر کپی کردن این بلوک و فرزندان هر نوع را روی maxInstance های خود قرار دهند، این بلوک تکراری نیست.
isEnabled()		ببینید آیا این بلوک فعال است یا خیر. اگر هیچ دلیلی برای غیرفعال شدن آن وجود نداشته باشد، یک بلوک فعال در نظر گرفته می شود. یک بلوک ممکن است همچنان به دلایل دیگر غیرفعال شود، حتی اگر کاربر تلاش کند آن را به صورت دستی فعال کند، مانند زمانی که بلوک در یک مکان نامعتبر است.
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(متن)		متن نظر این بلوک را تنظیم کنید.
مجموعه قابل حذف (قابل حذف)		تنظیم کنید که آیا این بلوک قابل حذف است یا خیر.
setDisabledReason (غیرفعال، دلیل)		دلیلی برای غیرفعال شدن بلوک اضافه یا حذف کنید. اگر یک بلوک دلایلی برای غیرفعال شدن داشته باشد، خود بلوک غیرفعال در نظر گرفته می شود. یک بلوک می تواند به دلایل مستقل متعدد به طور همزمان غیرفعال شود، مانند زمانی که کاربر به صورت دستی آن را غیرفعال می کند یا بلوک نامعتبر است.
مجموعه قابل ویرایش (قابل ویرایش)		تنظیم کنید که آیا این بلوک قابل ویرایش است یا خیر.
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)		این بلوک را از بلوک برترش جدا کنید. اگر این بلوک یک دستور است، به صورت اختیاری بلوک زیر را با بلوک در بالا وصل کنید.