blockly > حظر

حظر الصف

الفصل الدراسي لجزء واحد. يُفضَّل استخدام workspace.newBlock() : وهو لا يتم استدعاؤه عادةً بشكل مباشر.

Signature:

export declare class Block implements IASTNodeLocation 

التنفيذ: IASTNodeLocation

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

الشركة المصنِّعة	مفاتيح التعديل	الوصف
(Buildor)(workspace, originalName, opt_id)		إنشاء مثيل جديد لفئة Block

أماكن إقامة

الموقع	مفاتيح التعديل	النوع	الوصف
childBlocks_	protected	هذا[]
collapsed_	protected	منطقي
COLLAPSED_FIELD_NAME	static readonly	سلسلة	معرِّف اللغة المحايد الذي يتم منحه للحقل المصغَّر.
COLLAPSED_INPUT_NAME	static readonly	سلسلة	المعرِّف المحايد اللغوي الذي يتم منحه للإدخال المصغّر.
colour_	protected	سلسلة	لون القالب في "#RRGGBB" .
إنشاءها؟		(p1: حظر) => فراغ	(اختياري) دالة اختيارية تُعيد ضبط الحظر استنادًا إلى محتوى مربّع حوار التبديل.
contextMenu		منطقي
البيانات		سلسلة | خالية	بيانات نصية اختيارية تنتقل ذهابًا وإيابًا بين الكتل وملف XML. ليس له أي تأثير. ويمكن لجهات خارجية استخدامها للحصول على معلومات وصفية.
أن تحلّلها؟		(p1: مساحة العمل) => حظر	(اختياري) دالة اختيارية تعبئ مربع حوار المُبدِّل بمكونات هذه المجموعة.
تدميرها؟		() => فراغ	(اختياري) طريقة اختيارية يتم استدعاؤها أثناء التخلص من المنتج.
التخلص من	protected	منطقي	هل يجري حاليًا التخلص من القطعة الحالية؟
domToMutation?		(p1: العنصر) => فراغ	(اختياري) طريقة اختيارية لإزالة التسلسل من أجل تحديد كيفية إلغاء تسلسل حالة التغيير من XML. ويجب أن يقترن ذلك بتحديد mutationToDom.
getDeveloperVariables?		() => سلسلة[]	(اختياري) سمة اختيارية لتعريف متغيّرات المطوّرين. عرض قائمة بأسماء المتغيرات لاستخدامها من خلال المنشئات. لا تظهر متغيّرات المطوّرين أبدًا للمستخدم، ولكن يتم تعريفها كمتغيّرات عمومية في الرمز الذي تم إنشاؤه.
قبعة؟		سلسلة	(اختياري) اسم نوع القبّعة.
helpUrl		سلسلة | الدالة | خالية	سلسلة للمساعدة في الحظر أو دالة تعرض عنوان URL تم إلغاء الإعداد بدون مساعدة.
الرموز		IIcon[]
المعرِّف		سلسلة
بدء التشغيل		() => فراغ	(اختياري) طريقة اختيارية يتم استدعاؤها أثناء الإعداد.
inputList		الإدخال[]
inputsInline?		منطقي	(اختياري)
inputsInlineDefault?		منطقي	(اختياري)
isInFlyout		منطقي
isInMutator		منطقي
isInsertionMarker_	protected	منطقي	صحيح إذا كانت هذه القطعة علامة إدراج.
loadExtraState?		(p1: أي) => فراغ	(اختياري) طريقة تسلسل اختيارية لتحديد كيفية إلغاء تسلسل الحالة الإضافية للكتلة (مثل حالة التغيير) من عنصر متوافق مع JSON. ويجب أن يقترن ذلك بتحديد saveExtraState.
mutationToDom?		(...p1: أي[]) => العنصر	(اختياري) طريقة تسلسل اختيارية لتحديد كيفية تسلسل حالة التغيير إلى XML. ويجب أن يقترن ذلك بتحديد domToMutation.
nextConnection		الاتصال | خالية
؟		((p1: خلاصة) => باطل) | خالية	(اختياري) طريقة اختيارية لمعاودة الاتصال يتم استخدامها عند تغيير مساحة العمل الرئيسية للحظر. وعادةً ما يتم استدعاء هذا فقط من الدالة الإنشائية أو دالة تهيئة نوع الكتلة أو دالة مهيئ الإضافة.
outputConnection		الاتصال | خالية
outputShape_	protected	الرقم | خالية
parentBlock_	protected	هذا | خالية
previousConnection		الاتصال | خالية
معروض	readonly	منطقي	هل يؤدي هذا الخيار إلى حظر النصوص البرمجية بتنسيق BlockSVG؟
RTL		منطقي
saveExtraState?		(doFullSerialization?: boolean) => أي	(اختياري) طريقة تسلسل اختيارية لتحديد كيفية تسلسل الحالة الإضافية للكتلة (مثل حالة التغيير) إلى عنصر متوافق مع JSON. ويجب أن يقترن ذلك بتحديد loadExtraState.
styleName_	protected	سلسلة	اسم نمط الكتلة.
suppressPrefixSuffix		boolean | خالية	خاصية اختيارية لمنع إضافة stateMENT_PREFIX وstateMENT_ صالح إلى التعليمة البرمجية التي تم إنشاؤها.
تلميح		Tooltip.TipInfo
النوع		سلسلة
مساحة العمل		مساحة العمل

الطُرق

الطريقة	مفاتيح التعديل	الوصف
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()		يعرض التعليق على هذه المجموعة (أو فارغًا إذا لم يكن هناك تعليق).
getDescendants(ordered)		ابحث عن جميع الكتل المضمّنة في هذه المجموعة بشكل مباشر أو غير مباشر. تضمين هذه المجموعة في القائمة يتضمّن مدخلات القيمة والعبارة، بالإضافة إلى أي عبارات تالية. ولا تشمل هذه الميزة أي اتصال في علامة تبويب الناتج أو أي عبارات سابقة. يتم فرز القوالب اختياريًا حسب الموضع؛ من أعلى إلى أسفل.
getDisabledReasons()		تعرَّف على مجموعة من الأسباب التي تؤدي إلى إيقاف ميزة "الحظر" في الوقت الحالي، إن وُجدت. إذا تم تفعيل الحظر، ستكون هذه المجموعة فارغة.
getField(name)		تعرض الحقل المُسمّى من مجموعة.
getFieldValue(name)		تعرض قيمة محايدة اللغة للحقل المحدد.
getHue()		يمكنك الحصول على قيمة تدرج اللون HSV للكتلة. خالية إذا لم يتم تعيين تدرج اللون.
getIcon(type)
getIcons()
getInheritedDisabled()		تعرَّف على ما إذا كان الحظر محظورًا بسبب الوالدَين. ولا يتم أخذ الموقع غير المفعَّل الخاص بالحظر في الاعتبار.
getInput(name)		لجلب كائن الإدخال المُسمّى.
getInputsInline()		يمكنك معرفة ما إذا كان سيتم ترتيب مدخلات القيم أفقيًا أو عموديًا.
getInputTargetBlock(name)		لجلب القطعة المرتبطة بالإدخال المُسمّى
getInputWithBlock(block)		إرجاع الإدخال المرتبط بالقطعة المحدّدة.
getNextBlock()		يمكنك عرض كتلة العبارة التالية المرتبطة مباشرةً بهذا الكتلة.
getOutputShape()		احصل على شكل إخراج القطعة.
getParent()		يمكنك عرض المجموعة الرئيسية أو بقيمة خالية إذا كانت هذه القطعة في المستوى الأعلى. الجزء الرئيسي إما هو الكتلة المتصلة بالاتصال السابق (لكتلة عبارة) أو الكتلة المتصلة باتصال الإخراج (لكتلة قيمة).
getPreviousBlock()		يعرض المجموعة المرتبطة بالاتصال السابق.
getRelativeToSurfaceXY()		يمكنك عرض إحداثيات الزاوية العلوية اليمنى من هذا الجزء بالنسبة إلى أصل سطح الرسم (0,0)، في وحدات مساحة العمل.
getRootBlock()		يمكنك عرض أعلى كتلة في شجرة هذه المجموعة. سيتم تنفيذ هذا الإجراء تلقائيًا إذا كانت هذه المجموعة في المستوى الأعلى.
getStyleName()		احصل على اسم نمط الكتلة.
getSurroundParent()		يمكنك عرض القطعة الرئيسية التي تحيط بالقطعة الحالية أو عرض قيمة فارغة إذا لم تكن هذه القطعة تحتوي على قطعة محيطة. قد تكون الكتلة الأصلية هي العبارة السابقة فقط، بينما الكتلة المحيطة هي عبارة if و while وتكرارًا وما إلى ذلك.
getTooltip()		لعرض نص تلميح هذا الكتلة.
getVars()		عرض جميع المتغيّرات التي تشير إليها هذه المجموعة.
hasDisabledReason(reason)		تحقق مما إذا كان الحظر معطَّلاً حاليًا للسبب المقدم.
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 فيه نوع 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)		تضبط هذه السياسة دالة استدعاء لاستخدامها عند تغيير مساحة العمل الرئيسية للحظر، مع استبدال أي معالج 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)		افصل هذه المجموعة من الوحدة الأساسية. إذا كانت هذه المجموعة عبارة عن جملة، يمكنك اختياريًا إعادة ربط الكتلة أسفلها بالقطعة التي تظهر في الأعلى.