blockly > BlockSvg

فئة BlockSvg

فئة لتمثيل SVG الخاص بالكتلة لا يتم استدعاؤه عادةً مباشرةً، ويُفضّل استخدام workspace.newBlock().

Signature:

export declare class BlockSvg extends Block implements IBoundedElement, IContextMenu, ICopyable<BlockCopyData>, IDraggable, IDeletable, IFocusableNode 

تمتد إلى: Block

Implements: IBoundedElement, IContextMenu, ICopyable<BlockCopyData>, IDraggable, IDeletable, IFocusableNode

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

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

الخصائص

الموقع	مفاتيح التعديل	النوع	الوصف
COLLAPSED_WARNING_ID	static readonly	(لم يتم الإفصاح عنها)	معرّف لإصدار التحذير "تحذيرات مصغّرة". يسمح لنا بإزالة التحذير "التحذيرات المصغّرة" بدون إزالة أي تحذيرات تنتمي إلى الحظر.
customContextMenu?		(p1: Array<ContextMenuOption | LegacyContextMenuOption>) => void	(اختياري)
التحليل؟		(p1: Workspace) => BlockSvg	(اختياري)
height		الرقم	ارتفاع هذا القسم، بدون تضمين أي أقسام بيانات أعلى أو أسفل. يتم قياس الارتفاع بوحدات مساحة العمل.
INLINE	static readonly	(لم يتم الإفصاح عنها)	ثابت لتحديد الصفوف التي سيتم عرضها مضمّنة. عدم التعارض مع Blockly.inputTypes
mutator		MutatorIcon | null	رمز أداة التعديل الخاصة بالكتلة (إن وُجد).
nextConnection		RenderedConnection
outputConnection		RenderedConnection
previousConnection		RenderedConnection
rendered	readonly	(لم يتم الإفصاح عنها)	هل هذه الكتلة هي BlockSVG؟
saveConnections?		(rootBlock: BlockSvg) => void	(اختياري) طريقة اختيارية تحفظ سجلّاً للكتل المرتبطة بهذه الكتلة حتى يمكن استعادتها لاحقًا بعد إعادة إنشاء هذه الكتلة (إعادة ضبطها). تسجّل هذه السمة عادةً الكتل المرتبطة في المواقع أو الكتل في قائمة الأدوات المنبثقة الخاصة بأداة التعديل، وذلك لكي تؤدي إعادة ترتيب كتل المكوّنات إلى إعادة ترتيب الكتل المرتبطة المقابلة تلقائيًا في هذه الكتلة بعد إعادة إنشاء هذه الكتلة. لإبقاء معلومات الاتصال المحفوظة محدَّثة، يرتب MutatorIcon أن يستدعي مستمع الأحداث هذه الطريقة في أي وقت يكون فيه عنصر التحكّم المنبثق الخاص بأداة التعديل مفتوحًا ويحدث تغيير في مساحة عمل هذا البلوك.
style		BlockStyle
width		الرقم	عرض هذا المربّع، بما في ذلك أي مربّعات قيم مرتبطة يتم تحديد العرض بوحدات مساحة العمل.
workspace		WorkspaceSvg

الطُرق

الطريقة	مفاتيح التعديل	الوصف
addClass(className)		أضِف فئة CSS إلى مجموعة SVG الخاصة بهذا البلوك.
addIcon(icon)
addSelect()		يضيف التأثير المرئي "اختيار" إلى البلوك، ولكنّه لا يختاره فعليًا أو ينشئ حدثًا.
appendInput(input)
bringToFront(blockOnly)		انقل هذا المربّع إلى مقدّمة مساحة العمل المرئية. لا تراعي علامات ترتيب العناصر في المحور z، لذا يعرض SVG هذه العلامات بالترتيب الذي تظهر به في نموذج المستند. من خلال وضع هذه الكتلة أولاً ضمن لمجموعة الكتل، سيتم عرضها فوق أي كتل أخرى. استخدِم هذه الطريقة باعتدال لأنّها مكلفة بسبب إعادة ترتيب عقد DOM.
bumpNeighbours()		تؤدي إلى إخراج الكتل غير المرتبطة من المحاذاة. يجب ألا تتطابق محاذاة مربّعين غير مرتبطين فعليًا على الشاشة، لأنّ ذلك يؤدي إلى إرباك المستخدِمين النهائيين.
calculateContextMenuLocation(e)	protected	تعرض هذه السمة الموقع الجغرافي الذي ستظهر فيه قائمة السياق الخاصة بهذه الكتلة. استخدِم الموقع الجغرافي للنقرة إذا تم النقر على الحظر، أو الموقع الجغرافي استنادًا إلى حقول الحظر في الحالات الأخرى.
canBeFocused()		راجِع IFocusableNode.canBeFocused.
checkAndDelete()		احذف إحدى الوحدات وأخفِ البيانات الوهمية عند إجراء ذلك. لن يتم حذف الوحدة إذا كانت في قائمة منبثقة. يتم استدعاء هذا الإجراء من قائمة السياق ومن اختصارات لوحة المفاتيح كإجراء حذف كامل. إذا كنت ستتخلص من كتلة من مساحة العمل ولا تحتاج إلى إجراء عمليات التحقّق من القائمة المنبثقة أو التعامل مع تجميع الأحداث أو إخفاء البيانات غير الضرورية، استخدِم block.dispose() مباشرةً.
dispose(healStack, animate)		تجاهُل هذا البلوك
disposeInternal()		تتخلص من هذه المجموعة بدون تنفيذ الإجراءات المطلوبة من المجموعة العلوية. على سبيل المثال، هل يؤدي إلى تشغيل تأثيرات واجهة المستخدم أو إزالة العُقد أو غير ذلك؟
drag(newLoc, e)		يسحب هذا الإجراء الكتلة إلى الموقع الجغرافي المحدّد.
endDrag(e)		ينهي عملية السحب على المربّع.
generateContextMenu(e)	protected	أنشئ قائمة السياق لهذا المقطع.
getBoundingRectangle()		تعرض هذه السمة إحداثيات مربّع محيط يصف أبعاد هذه الكتلة وأي كتل مكدّسة أسفلها. نظام الإحداثيات: إحداثيات مساحة العمل
getBoundingRectangleWithoutChildren()		تعرض هذه السمة إحداثيات مربّع حدود يصف أبعاد هذه الكتلة وحدها. نظام الإحداثيات: إحداثيات مساحة العمل
getChildren(ordered)		تعرض هذه السمة جميع الوحدات التي تكون متداخلة مباشرةً داخل هذه الوحدة. يتضمّن هذا القسم إدخالات القيمة والعبارة، بالإضافة إلى أي عبارة تالية. يستثني أي اتصال في علامة تبويب الإخراج أو أي عبارة سابقة. يتم ترتيب الحظر اختياريًا حسب الموضع، من الأعلى إلى الأسفل.
getColour()		الحصول على لون أحد المربّعات
getColourSecondary()		الحصول على اللون الثانوي لأحد المربّعات
getColourTertiary()		الحصول على اللون الثانوي لكتلة
getFocusableElement()		راجِع IFocusableNode.getFocusableElement.
getFocusableTree()		راجِع IFocusableNode.getFocusableTree.
getNextBlock()		لعرض كتلة العبارة التالية المرتبطة مباشرةً بهذه الكتلة
getPreviousBlock()		تعرض هذه السمة الكتلة المرتبطة بالاتصال السابق.
getRelativeToSurfaceXY()‎		تعرض هذه السمة إحداثيات الزاوية العلوية اليسرى لهذه الكتلة بالنسبة إلى نقطة الأصل (0,0) في سطح الرسم، بوحدات مساحة العمل. إذا كان الحظر في مساحة العمل، تكون نقطة الأصل لنظام إحداثيات مساحة العمل هي (0, 0). ولا يتغير ذلك مع حجم مساحة العمل.
getStyle()		تعرض هذه السمة عنصر BlockStyle المستخدَم لتصميم هذا الحظر.
getSvgRoot()		لعرض العقدة الجذرية لملف SVG أو قيمة فارغة في حال عدم توفّرها
initSvg()		أنشئ تمثيل SVG للكتلة وفعِّله. قد يتم استدعاؤه أكثر من مرة.
isCopyable()		تعرض هذه السمة ما إذا كان يمكن نسخ هذا المكوّن أو لا.
isMovable()		تعرض هذه السمة ما إذا كانت هذه الكتلة قابلة للنقل أم لا.
jsonInit(json)
markDirty()		إرسال إشعار بشأن كل إدخال في هذه الكتلة لوضع علامة "تم التعديل" على حقولها الحقل غير النظيف هو حقل يجب إعادة عرضه.
moveBy(dx, dy, reason)		نقل كتلة بإزاحة نسبية
moveNumberedInputBefore(inputIndex, refIndex)		نقل إدخال مرقّم إلى مكان مختلف في هذا البلوك
moveTo(xy, reason)		نقل جزء من المسألة إلى موضع
onNodeBlur()		راجِع IFocusableNode.onNodeBlur.
onNodeFocus()		راجِع IFocusableNode.onNodeFocus.
removeClass(className)		إزالة فئة CSS من مجموعة SVG لهذا البلوك
removeIcon(type)
removeInput(name, opt_quiet)		إزالة إدخال من هذا المكوّن
removeSelect()		يزيل تأثير "التحديد" المرئي من البلوك، ولكنّه لا يزيل التحديد أو ينشئ حدثًا.
render()		يتم على الفور عرض وتعديل موضع أحد الأقسام استنادًا إلى محتواه وإعداداته.
revertDrag()		تنقل هذه السمة الكتلة إلى الموضع الذي كانت فيه في بداية عملية السحب.
scheduleSnapAndBump()		محاذاة العناصر مع الشبكة، ثم إبعاد الكتل المجاورة في نهاية عملية العرض التالية
select()		يتم اختيار هذا المربّع. تمييز الحظر بشكل مرئي
setCollapsed(collapsed)		تحديد ما إذا كان سيتم تصغير حجم الكتلة أم لا
setColour(colour)		تغيير لون أحد المربّعات
setDeletable(deletable)		إضافة فئة blocklyNotDeletable عندما لا يمكن حذف الكتلة أو إزالة الفئة عندما يمكن حذف الكتلة
setDisabledReason(disabled, reason)		أضِف سببًا قد يؤدي إلى إيقاف الحظر أو أزِله. إذا كان هناك أي أسباب لإيقاف إحدى الوحدات الإعلانية، سيتم اعتبار الوحدة الإعلانية نفسها متوقفة. يمكن إيقاف الحظر لعدة أسباب مستقلة في الوقت نفسه، مثلاً عندما يوقفه المستخدم يدويًا أو عندما يكون الحظر غير صالح.
setDragStrategy(dragStrategy)		تضبط هذه السمة استراتيجية السحب لهذا البلوك.
setEditable(editable)		تحديد ما إذا كانت هذه الفقرة قابلة للتعديل أم لا
setHighlighted(highlighted)		تحديد ما إذا كان سيتم تمييز الحظر أم لا يتم غالبًا استخدام تمييز الحظر لتحديد الحظر الذي يتم تنفيذه حاليًا بشكل مرئي.
setInputsInline(newBoolean)		تحديد ما إذا كانت مدخلات القيم مرتّبة أفقيًا أو رأسيًا
setMovable(movable)		تحديد ما إذا كان يمكن نقل هذا المربّع أم لا
setMutator(mutator)		امنح هذه الكتلة مربّع حوار معدِّل.
setNextStatement(newBoolean, opt_check)		تحديد ما إذا كان يمكن ربط كتلة أخرى بأسفل هذه الكتلة
setOutput(newBoolean, opt_check)		تحديد ما إذا كانت هذه الكتلة تعرض قيمة
setPreviousStatement(newBoolean, opt_check)		تحديد ما إذا كان يمكن ربط هذا المربّع بأسفل مربّع آخر
setStyle(blockStyleName)		ضبط قيم النمط واللون لأحد الأقسام
setWarningText(text, id)		اضبط نص التحذير الخاص بهذه الكتلة.
snapToGrid()		يمكنك محاذاة هذا المربّع مع أقرب نقطة في الشبكة.
startDrag(e)		يبدأ عملية سحب للكتلة.
toCopyData()		ترميز كتلة للنسخ
toFlyoutInfo()		تعرض هذه الطريقة تمثيلاً لهذا المكوّن يمكن عرضه في قائمة منبثقة.
translate(x, y)		تحويل أحد المربّعات من خلال ضبط الترجمة على سمة التحويل في SVG الخاص بالمربّع
unselect()		لإلغاء اختيار هذه الكتلة إزالة التمييز المرئي للمقطع