blockly > Block

فئة الحظر

صف لوحدة واحدة. لا يتم استدعاء دالة 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
إنشاء؟		(rootBlock: Block) => void	(اختياري) طريقة اختيارية تعيد ضبط الكتلة استنادًا إلى محتوى مربّع حوار المُعدِّل.
contextMenu		قيمة منطقية
data		string | null	بيانات نصية اختيارية يتم نقلها ذهابًا وإيابًا بين الكتل وتنسيق XML ما مِن تأثير. قد تستخدمها جهات خارجية للحصول على معلومات وصفية.
تحلّل؟		(workspace: Workspace) => حظر	(اختياري) دالة اختيارية تملأ النافذة المنبثقة للمُعدِّل بكتل تمثّل إعدادات هذه الكتلة.
إتلافه؟		() => void	(اختياري) طريقة اختيارية يتمّ استدعاؤها أثناء التخلص من العنصر.
disposing	protected	قيمة منطقية	هل يتم حاليًا التخلص من الحظر الحالي؟
domToMutation؟		(p1: عنصر) => فارغة	(اختياري) طريقة اختيارية لتحويل البيانات من تنسيق سلسلة إلى تنسيق ثنائي لتحديد كيفية تحويل حالة الطفرة من تنسيق XML إلى تنسيق ثنائي. يجب أن يكون ذلك مصحوبًا بتحديد mutationToDom.
getDeveloperVariables؟		() => string[]	(اختياري) طريقة اختيارية لتعريف متغيّرات المطوّرين لاستخدامها في أداة إنشاء التقارير لا تظهر متغيّرات المطوّرين للمستخدم مطلقًا، ولكن يتمّ تعريفها كمتغيّرات عامة في الرمز الذي تمّ إنشاؤه.
قبعة؟		سلسلة	(اختياري) اسم نوع القبّعة
helpUrl		string | (() => string) | null	سلسلة لمساعدة الحظر أو دالة تعرض عنوان URL قيمة خالية إذا لم تكن هناك مساعدة.
الرموز		IIcon[]
المعرِّف		سلسلة
init؟		() => void	(اختياري) طريقة اختيارية يتمّ استدعاؤها أثناء الإعداد.
inputList		إدخال[]
inputsInline?‎		قيمة منطقية	(اختياري)
inputsInlineDefault?‎		قيمة منطقية	(اختياري)
isInFlyout		قيمة منطقية
isInMutator		قيمة منطقية
isInsertionMarker_	protected	قيمة منطقية	صحيح إذا كانت هذه الكتلة عبارة عن علامة إدراج.
loadExtraState؟		(p1: أي) => فارغ	(اختياري) طريقة اختيارية لتسلسل البيانات من أجل تحديد كيفية تحويل الحالة الإضافية للوحدة إلى سلسلة من شيء متوافق مع JSON (مثل حالة التحويل). يجب أن يكون ذلك مصحوبًا بتحديد saveExtraState.
mutationToDom؟		(...p1: any[]) => عنصر	(اختياري) طريقة اختيارية لترميز البيانات لتحديد كيفية ترميز حالة الطفرة إلى XML يجب أن يكون ذلك مصحوبًا بتحديد domToMutation.
nextConnection		Connection | null
onchange؟		((p1: Abstract) => void) | null	(اختياري) طريقة اختيارية لردّ الاتصال لاستخدامها عند تغيير مساحة العمل الرئيسية للوحدة. لا يتم عادةً استدعاء هذه الدالة إلا من الدالة الانشائية أو دالة إعداد نوع الكتلة أو دالة إعداد الإضافة.
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.TipInfo
type		سلسلة
workspace		Workspace

الطُرق

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