blockly > حظر

حظر الصف

فئة واحدة لقالب واحد. لا يُستخدَم عادةً هذا الإجراء مباشرةً، ويُفضَّل استخدام واجهة workspace.newBlock() .

Signature:

export declare class Block implements IASTNodeLocation, IDeletable 

يتم التنفيذ: IASTNodeLocation وIDeletable

الشركات المصنِّعة

الشركة المصنِّعة	مفاتيح التعديل	الوصف
(structor)(workspace, templateName, opt_id)		تنشئ هذه الدالة مثيلاً جديدًا من الفئة Block.

أماكن إقامة

الموقع	مفاتيح التعديل	Type	الوصف
childBlocks_	protected	هذا[]
collapsed_	protected	boolean
COLLAPSED_FIELD_NAME	static readonly	سلسلة	رقم التعريف المحايد للغة الذي يتم منحه للحقل المصغّر.
COLLAPSED_INPUT_NAME	static readonly	سلسلة	رقم التعريف المحايد للغة الذي يتم منحه للإدخال المصغّر.
colour_	protected	سلسلة	لون المجموعة بتنسيق " #RRGGBB"
compose?		(p1: حظر) => إلغاء	(اختياري) دالة اختيارية تُعيد ضبط المجموعة بناءً على محتوى مربّع حوار أداة التغيير.
contextMenu		boolean
البيانات		سلسلة | قيمة فارغة	بيانات نصية اختيارية تنتقل ذهابًا وإيابًا بين الكتل وبتنسيق XML. ليس له أي تأثير. يمكن أن تستخدم جهات خارجية للحصول على معلومات وصفية.
يحلّلها؟		(p1: Workspace) => حظر	(اختياري) دالة اختيارية تُعبّئ مربّع حوار أداة التغيير بمكوّنات هذه المجموعة.
destroy?		() => فارغ	(اختياري) طريقة اختيارية يتم استدعاؤها عند التخلص من المنتج.
domToMutation؟		(p1: العنصر) => إفراغ	(اختياري) طريقة إلغاء تسلسلية اختيارية لتحديد كيفية إلغاء تسلسل حالة الطفرة من ملف XML. ويجب أن يقترن ذلك بسمة التعريف mutationToDom.
getDeveloperVariables؟		() => سلسلة[]	(اختياري) سمة اختيارية لتعريف متغيّرات المطوّرين. عرض قائمة بأسماء المتغيرات التي يمكن أن تستخدمها أدوات الإنشاء. لا يتم عرض متغيّرات المطوِّرين للمستخدم مطلقًا، ولكن يتم تعريفها كمتغيّرات عمومية في الرمز الذي تم إنشاؤه.
قبعة؟		سلسلة	(اختياري) اسم نوع القبعة.
helpUrl		string | Function | null	سلسلة للمساعدة في الحظر، أو دالة تعرض عنوان URL. لا توجد أي مساعدة.
رموز		IIcon[]
المعرِّف		سلسلة
init?		() => فارغ	(اختياري) طريقة اختيارية يتم استدعاؤها أثناء الإعداد.
inputList		الإدخال[]
مدخلات مضمّنة؟		boolean	(اختياري)
inputsInlineDefault؟		boolean	(اختياري)
isInFlyout		boolean
isInMutator		boolean
isInsertionMarker_	protected	boolean	صحيح إذا كانت هذه المجموعة عبارة عن علامة إدراج.
loadExtraState؟		(p1: أي) => باطلة	(اختياري) طريقة تسلسل اختيارية لتحديد كيفية إلغاء تسلسل الحالة الإضافية للكتلة (مثل حالة التغيير) من عنصر متوافق مع JSON. ويجب أن يقترن ذلك بسمة التعريف saveExtraState.
mutationToDom؟		(...p1: أي[]) => العنصر	(اختياري) طريقة تسلسل اختيارية لتحديد كيفية إنشاء تسلسل لحالة التغيير إلى ملف XML. ويجب أن يقترن ذلك بسمة التعريف domToMutation.
nextConnection		الاتصال | قيمة فارغة
أي تغيير جذري؟		((p1: Abstract) => void) | null	(اختياري) طريقة اختيارية لمعاودة الاتصال يمكن استخدامها عندما تتغير مساحة العمل الرئيسية للحظر. عادةً ما يتم استدعاء هذا الإجراء فقط من الدالة الإنشائية أو دالة المهيكل لنوع الكتلة أو دالة مهيئ الإضافة.
outputConnection		الاتصال | قيمة فارغة
outputShape_	protected	رقم | قيمة فارغة
parentBlock_	protected	هذا | فارغ
previousConnection		الاتصال | قيمة فارغة
عرض		boolean | null
RTL		boolean
saveExtraState؟		(doFullSerialization?: منطقي) => أي	(اختياري) طريقة تسلسل اختيارية لتحديد كيفية إنشاء تسلسل للحالة الإضافية للكتلة (مثل حالة التغيير) إلى عنصر متوافق مع 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()		تفريغ الكتل غير المتصلة خارج المحاذاة. يجب ألا يصطف قالبان غير متصلين بالفعل على الشاشة بالمصادفة.
dispos(healStack)		تخلَّص من هذه القطعة.
disposeInternal()	protected	يتم التخلص من هذا الجزء بدون تنفيذ الإجراءات التي تتطلبها القطعة العلوية. على سبيل المثال، لا يتم تنشيط الأحداث، أو افصِل المنطقة، وما إلى ذلك.
doInit_()	protected	لاستدعاء الدالة init() والتعامل مع تنشيط الحدث المرتبط، وما إلى ذلك.
getChildren(ordered)		ابحث عن جميع القوالب المتداخلة مباشرة داخل هذا الكتلة. تشتمل هذه الفئة على مدخلات القيمة والعبارة، بالإضافة إلى أي عبارة تالية. تستثني أي اتصال في علامة تبويب إخراج أو أي عبارة سابقة. ويتم ترتيب القوالب اختياريًا حسب الموضع، من أعلى إلى أسفل.
getColour()		احصل على لون المربّع.
getCommentText()		لعرض التعليق على هذه المجموعة (أو قيمة فارغة إذا لم يكن هناك تعليق).
getDescendants(ordered)		ابحث عن جميع الكتل المتداخلة بشكل مباشر أو غير مباشر في هذه الكتلة. لتضمين هذا الجزء في القائمة. تتضمّن مدخلات القيمة والبيان، بالإضافة إلى أي العبارات التالية. تستثني أي اتصال في علامة تبويب إخراج أو أي عبارات سابقة. ويتم ترتيب القوالب اختياريًا حسب الموضع، من أعلى إلى أسفل.
getField(name)		لعرض الحقل المُسمّى من كتلة.
getFieldValue(name)		لعرض القيمة المحايدة للغة في الحقل المحدد.
getHue()		احصل على قيمة تدرج لون HSV للكتلة. فارغة إذا لم يتم تعيين تدرُّج اللون.
getIcon(type)
getIcons()
getInheritedDisabled()		معرفة ما إذا كان الحظر متوقفًا بسبب الوالدَين ولا يتم أخذ الخاصية التي تم إيقافها في الكتلة في الاعتبار.
getInput(name)		يجلب كائن الإدخال المسمى.
getInputsInline()		يمكنك معرفة ما إذا تم ترتيب إدخالات القيمة أفقيًا أو رأسيًا.
getInputTargetBlock(name)		لاسترجاع المجموعة المرتبطة بالإدخال المُسمّى.
getInputWithBlock(block)		لعرض الإدخال الذي يتصل بالكتلة المحدّدة.
getNextBlock()		عرض مجموعة العبارات التالية المرتبطة مباشرةً بهذه المجموعة.
getOutputShape()		احصل على شكل مخرجات الكتلة.
getParent()		يمكنك عرض المجموعة الرئيسية أو القيمة الخالية إذا كانت هذه المجموعة في المستوى الأعلى. المجموعة الرئيسية هي إما المجموعة المرتبطة بالاتصال السابق (لمجموعة عبارات) أو المجموعة المرتبطة باتصال الإخراج (لمجموعة القيم).
getPreviousBlock()		لعرض المجموعة المرتبطة بعملية الربط السابقة.
getPercentToSurfaceXY()		عرض إحداثيات الزاوية العلوية اليسرى من هذه القطعة بالنسبة إلى أصل سطح الرسم (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()		معرفة ما إذا كان الحظر مكرّرًا أم لا. إذا كان تكرار هذه المجموعة والعناصر التابعة سيؤدي إلى وضع هذه المجموعة على سعة مساحة العمل، لن تكون هذه المجموعة متكررة. إذا كان إنشاء نسخة طبق الأصل من هذه المجموعة والعناصر التابعة لها سيؤدي إلى وضع أي نوع على الحد الأقصى لمثيلات هذه المجموعة، لن تكون هذه المجموعة قابلة للتكرار.
isEnabled()		تعرّف على ما إذا كانت عملية الحظر هذه مفعَّلة أم لا.
isInsertionMarker()		معرفة ما إذا كانت هذه المجموعة عبارة عن كتلة علامة إدراج أم لا.
isOwnDeletable()		يمكنك عرض ما إذا كانت السمة القابلة للحذف في هذه الكتلة صواب أم خطأ.
isOwnEditable()		يمكنك عرض ما إذا كانت السمة القابلة للتعديل في هذه الكتلة صواب أم خطأ.
isShadow()		تعرف على ما إذا كانت هذه الكتلة كتلة ظل أم لا.
jsonInit(json)		يجب إعداد هذا الحظر باستخدام وصف JSON متوافق مع مختلف الأنظمة الأساسية.
mixin(mixinObj, opt_disableCheck)		أضِف مفتاحًا/قيمًا من MixinObj إلى كائن الحظر هذا. بشكل افتراضي، ستتحقق هذه الطريقة من أن المفاتيح في MixinObj لن تستبدل القيم الموجودة في الكتلة، بما في ذلك قيم النموذج الأولي. يوفّر ذلك بعض التأمين ضد حالات عدم توافق الإضافات أو الإضافات مع ميزات الحظر المستقبلية. يمكن إيقاف هذا التحقق من خلال تمرير true كوسيطة ثانية.
moveBy(dx, dy, reason)		نقل قالب بإزاحة نسبية
moveInputBefore(name, refName)		يمكنك نقل إدخال مُسمّى إلى موقع مختلف في هذه المجموعة.
moveNumberedInputBefore(inputIndex, refIndex)		يمكنك نقل مدخل مرقَّم إلى موقع مختلف في هذه المجموعة.
removeIcon(type)		لإزالة الرمز الذي يتطابق getType الخاص به مع رمز النوع المحدد من الكتلة.
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)		تحدِّد هذه الدالة دالة رد اتصال لاستخدامها كلما تغيرت مساحة العمل الرئيسية للكتلة، مع استبدال أي معالج onchange سابق. عادةً ما يتم استدعاء هذا الإجراء فقط من الدالة الإنشائية أو دالة المهيكل لنوع الكتلة أو دالة مهيئ الإضافة.
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)		افصل هذا المبنى عن مربّعه العلوي. إذا كانت هذه القطعة عبارة، يمكنك إعادة ربط القطعة الموجودة أسفلها بالكتلة في الأعلى اختياريًا.