blockly > WorkspaceSvg

حصة WorkspaceSvg

صف للحصول على مساحة عمل. هذه منطقة على الشاشة بها سلة مهملات اختيارية وأشرطة تمرير وفقاعات فقاعات وسحب.

Signature:

export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationSvg 

للتوسيع: Workspace

التنفيذ: IASTNodeLocationSvg

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

الشركة المصنِّعة	مفاتيح التعديل	الوصف
(دالة الإنشاء)(options)		إنشاء مثيل جديد لفئة WorkspaceSvg

أماكن إقامة

الموقع	مفاتيح التعديل	النوع	الوصف
configureContextMenu		((listOptions: ContextقائمةOption[], e: الحدث) => باطل) | فارغ	يمكن للمطوّرين تحديد هذه الوظيفة لإضافة خيارات قوائم مخصّصة إلى قائمة سياقات مساحة العمل أو تعديل مجموعة خيارات القوائم التي تم إنشاؤها في مساحة العمل.
keyboardAccessibilityMode		منطقي	يتم الضبط على "صحيح" في حال تفعيل وضع تسهيل الاستخدام في لوحة المفاتيح، ويكون الخيار "خطأ" في الحالات الأخرى.
معروض		منطقي	حالة عرض مساحة عمل SVG. تعرض false لمساحات العمل التي بلا واجهة مستخدم رسومية وصحيح لمثيلات WorkspaceSvg.
المقياس		الرقم	الميزان الحالي
شريط التمرير		ScrollbarPair | فارغ	أشرطة التمرير في مساحة العمل هذه، إذا كانت متوفّرة
scrollX		الرقم	إزاحة التمرير الأفقي الحالية بوحدات البكسل، مقارنةً بأصل مساحة العمل من المفيد النظر في طريقة عرض، ولوحة تتحرك أسفل هذا العرض. وكلما تحركت اللوحة إلى اليمين، تصبح هذه القيمة أكثر إيجابية، وأصبحت طريقة العرض الآن "رؤية" الجانب الأيسر من لوحة الرسم. وكلما تحركت اللوحة إلى اليسار، تصبح هذه القيمة سلبية أكثر، وأصبح العرض الآن "يرى" الجانب الأيمن من اللوحة. الأمر المحير في هذه القيمة هو أنّها لا تشتمل على إزاحة مطلقة لليسار ويجب ألّا تتضمّنها. ويرجع ذلك إلى استخدامها لحساب قيمة viewLeft. ترتبط طريقة viewLeft بأصل مساحة العمل (ولكن بوحدات البكسل). مصدر مساحة العمل هو أعلى يمين مساحة العمل (على الأقل عند تفعيلها). حيث تم نقله من أعلى يسار الفقرة "blocklyDiv" حتى لا تكون أسفل مربع الأدوات. عند تفعيل مساحة العمل، يكون العرض الأيسر وأصل مساحة العمل في موقع X نفسه. وعندما تنزلق لوحة الرسم نحو اليمين أسفل العرض، تصبح هذه القيمة (scrollX) أكثر إيجابية، وتصبح طريقة viewLeft سلبية أكثر بالنسبة إلى مصدر مساحة العمل (تخيَّل مصدر مساحة العمل كنقطة على لوحة الرسم تنزلق إلى اليمين مع حركة اللوحة). لذا، إذا كان عنصر ScrollX سيتضمن حرف absuteLeft، فإن هذا سيكون بطريقة "unshift" أصل مساحة العمل. وهذا يعني أن viewLeft سيمثل الحافة اليسرى لblocklyDiv، بدلاً من الحافة اليسرى لمساحة العمل.
scrollY		الرقم	إزاحة التمرير العمودي الحالية بوحدات البكسل، مقارنةً بأصل مساحة العمل من المفيد النظر في طريقة عرض، ولوحة تتحرك أسفل هذا العرض. وكلما تحركت اللوحة لأسفل، تصبح هذه القيمة أكثر إيجابية، وأصبحت طريقة العرض الآن "ظهور". الجزء العلوي من لوحة الرسم. وكلما تحركت اللوحة للأعلى، تصبح هذه القيمة سلبية أكثر، وأصبح العرض "ظهور". الجزء السفلي من لوحة الرسم. وهذا الأمر المحير بشأن هذه القيمة هو أنها لا تشتمل على معادلة فرقعة مطلقة، ويجب ألا تتضمن. ويرجع ذلك إلى استخدامه لحساب قيمة viewTop. ترتبط viewTop بأصل مساحة العمل (ولكن بوحدات البكسل). مصدر مساحة العمل هو أعلى يمين مساحة العمل (على الأقل عند تفعيلها). حيث تم نقله من أعلى يسار الفقرة "blocklyDiv" حتى لا تكون أسفل مربع الأدوات. عند تفعيل مساحة العمل، يكون مصدر العرض ومصدر مساحة العمل في موقع Y نفسه. وعندما تنزلق هذه القيمة (التمرير Y) إلى أسفل اللوحة، تصبح هذه القيمة (التمرير Y) أكثر إيجابية، وتصبح قيمة viewTop سلبية بالنسبة إلى مصدر مساحة العمل (الصورة في مصدر مساحة العمل كنقطة على لوحة الرسم تنزلق لأسفل مع تحرك لوحة الرسم). لذا، إذا كان لـ ScrollY تضمين أعلى مطلقة، فإن هذا سيكون بطريقة "إلغاء التغيير" أصل مساحة العمل. وهذا يعني أن viewTop سيمثل الحافة العلوية لـ blocklyDiv، بدلاً من الحافة العلوية لمساحة العمل.
startScrollX		الرقم	قيمة التمرير الأفقي عند بدء التمرير بوحدات البكسل.
startScrollY		الرقم	قيمة التمرير العمودي عند بدء التمرير بوحدات البكسل.
svgBackground_		SVGElement
svgBlockCanvas_		SVGElement
svgBubbleCanvas_		SVGElement
svgGroup_		SVGElement
themeManager_	protected	ThemeManager
المهملات		المهملات | فارغ	سلة مهملات مساحة العمل (إن وجدت).
zoomControls_		ZoomControls | فارغ

الطُرق

الطريقة	مفاتيح التعديل	الوصف
addTopBlock(block)		يؤدي هذا الخيار إلى إضافة مربّع إلى قائمة أهم الأقسام.
addTopBoundedElement(element)		لإضافة عنصر محدود إلى قائمة العناصر ذات الحدود العلوية.
addTopComment(comment)		لإضافة تعليق إلى قائمة أهم التعليقات
centerOnBlock(id, blockOnly)		مرِّر مساحة العمل لتوسيط في المجموعة المحدّدة. إذا كانت الكتلة تحتوي على كتل أخرى مكدسة أسفلها، سيتم توسيط مساحة العمل على الحزمة، ما لم يتم ضبط blockOnly على "صحيح".
cleanUp()		قم بتنظيف مساحة العمل عن طريق طلب جميع الكتل في عمود.
clear()		تخلّص من جميع القوالب في مساحة العمل، مع التحسين لمنع حدوث تغييرات الحجم.
createDom(opt_backgroundClass, injectionDiv)		أنشِئ عناصر DOM في Workspace.
createVariable(name, opt_type, opt_id)		أنشئ متغيّرًا جديدًا بالاسم المحدّد. قم بتحديث القائمة المنبثقة لإظهار المتغير الجديد على الفور.
deleteVariableById(id)		احذف متغيّرًا من خلال رقم التعريف الذي تم ضبطه. قم بتحديث القائمة المنبثقة لتظهر على الفور أنه تم حذف المتغير.
dispose()		تخلّص من مساحة العمل هذه. يمكنك إلغاء الربط بجميع عناصر DOM لمنع تسرُّب الذاكرة.
getAllBlocks(ordered)		العثور على جميع الوحدات الأساسية في مساحة العمل يتم فرز القوالب اختياريًا حسب الموضع؛ من أعلى إلى أسفل (مع تحيز LTR أو RTL طفيف).
getAudioManager()		الحصول على مدير الصوت لمساحة العمل هذه
getBlockById(id)		ابحث عن القطعة في مساحة العمل هذه باستخدام المعرّف المحدّد.
getBlocksBoundingBox()		احسب مربع الإحاطة للكتل في مساحة العمل. نظام التنسيق: إحداثيات مساحة العمل
getBubbleCanvas()		احصل على عنصر SVG الذي يشكّل سطح الفقاعة التفسيرية.
getButtonCallback(key)		احصل على دالة معاودة الاتصال المرتبطة بمفتاح معين، للنقرات على الأزرار والتسميات في القائمة المنبثقة.
getCanvas()		احصل على عنصر SVG الذي يشكّل سطح الرسم.
getComponentManager()		الحصول على مدير المكوّنات لمساحة العمل هذه.
getCursor()		مؤشر مساحة العمل هذه
getDragTarget(e)		لعرض هدف السحب الذي انتهى حدث المؤشر.
getFlyout(opt_own)		يمكنك الحصول على القائمة المنبثقة المرتبطة بمساحة العمل هذه. قد تكون هذه القائمة المنبثقة مملوكة لصندوق الأدوات أو مساحة العمل، حسب إعدادات صندوق الأدوات. ستكون فارغة إذا لم يكن هناك قائمة منبثقة.
getGrid()		احصل على كائن الشبكة لمساحة العمل هذه، أو فارغًا إذا لم يكن هناك أي شيء.
getInverseScreenCTM()		الحصول على التحايل على التدابير التكنولوجية (CTM) للشاشة المقلوبة
getLayerManager()
getMarkerManager()		احصل على مدير محدّد الموقع لمساحة العمل هذه.
getMetricsManager()		يحصل على مدير المقاييس لمساحة العمل هذه.
getParentSvg()		يمكنك الحصول على عنصر SVG الذي يحتوي على مساحة العمل هذه. ملاحظة: نفترض أنّ ذلك لا يتم استدعاءه إلا بعد إدخال مساحة العمل في نموذج العناصر في المستند (DOM).
getRenderer()		احصل على عارض الكتل المرفق بمساحة العمل هذه.
getRootWorkspace()
getScale()		احصل على عامل التكبير أو التصغير لمساحة العمل. إذا كان لمساحة العمل عنصر رئيسي، نستدعي الوحدة الرئيسية للحصول على مقياس Workspace.
getSvgGroup()		تعرض مجموعة SVG لمساحة العمل.
getTheme()		احصل على كائن مظهر Workspace.
getToolbox()		ابحث عن صندوق الأدوات المرتبط بمساحة العمل هذه، إن توفّر.
getToolboxCategoryCallback(key)		احصل على دالة معاودة الاتصال المرتبطة بمفتاح معيّن لتعبئة فئات صندوق الأدوات المخصّصة في مساحة العمل هذه.
getTopBlocks(ordered)		العثور على مربّعات المستوى الأعلى وإرجاعها يتم فرز القوالب اختياريًا حسب الموضع؛ من أعلى إلى أسفل (مع تحيز LTR أو RTL طفيف).
getTopBoundedElements()		للعثور على العناصر المحددة ذات المستوى الأعلى وعرضها.
getWidth()		تعرض الإزاحة الأفقية لمساحة العمل. مخصص للتوافق مع LTR/RTL في XML.
hideChaff(onlyClosePopups)		إغلاق التلميحات وقوائم السياقات والتحديدات المنسدلة وما إلى ذلك
hideComponents(onlyClosePopups)		إخفاء أي مكونات قابلة للإخفاء التلقائي (مثل القائمة المنبثقة وسلة المهملات وأي مكونات مسجّلة للمستخدم).
highlightBlock(id, opt_state)		يمكنك تمييز جزء في مساحة العمل أو إلغاء تمييزه. غالبًا ما يتم استخدام تمييز الكتل لوضع علامة مرئية على الكتل التي يتم تنفيذها حاليًا.
isDraggable()		هل مساحة العمل هذه قابلة للسحب؟
isDragging()		هل يسحب المستخدم حاليًا كتلة أو يمرر في القائمة المنبثقة/مساحة العمل؟
isMovable()		هل مساحة العمل هذه قابلة للنقل؟ وهذا يعني أنه يمكن للمستخدم تغيير موضع إحداثيات X Y لمساحة العمل من خلال الإدخال. يمكن أن يكون ذلك من خلال أشرطة التمرير أو عجلة التمرير أو السحب أو من خلال التكبير أو التصغير باستخدام عجلة التمرير أو استخدام الإصبعين للتكبير/التصغير (حيث يتم توسيط التكبير أو التصغير في موضع الماوس). هذا لا يشمل التكبير/التصغير باستخدام عناصر التحكم في التكبير/التصغير حيث يتم تحديد الإحداثيات X Y برمجيًا.
isMovableHorizontally()		هل يمكن نقل مساحة العمل هذه أفقيًا؟
isMovableVertically()		هل مساحة العمل هذه قابلة للنقل عموديًا؟
isVisible()		مفتاح الحصول على كلمة isvisible
markFocused()		وضع علامة على مساحة العمل هذه باعتبارها مساحة العمل الرئيسية محل التركيز حاليًا.
moveDrag(e)		تتبُّع سحب عنصر في مساحة العمل هذه
newBlock(prototypeName, opt_id)		الحصول على وحدة حظر تم إنشاؤها حديثًا
newComment(id)		الحصول على تعليق تم إنشاؤه حديثًا.
recordDragTargets()		يمكنك إنشاء قائمة بجميع المناطق المحذوفة لمساحة العمل هذه.
refreshTheme()		إعادة تحميل جميع الوحدات الأساسية في مساحة العمل بعد تعديل المظهر.
registerButtonCallback(key, func)		سجل دالة استدعاء مرتبطة بمفتاح معين للنقرات على الأزرار والتصنيفات في القائمة المنبثقة. على سبيل المثال، يجب مطابقة الزر المحدّد بـ XML مع طلب تسجيلButtonCallback("CREATE_VARIABLE", yourCallbackFunction).
registerToolboxCategoryCallback(key, func)		سجِّل دالة رد اتصال مرتبطة بمفتاح معيّن لتعبئة فئات مجموعات الأدوات المخصّصة في مساحة العمل هذه. اطّلع على فئات المتغيرات والإجراءات كمثال.
removeButtonCallback(key)		إزالة معاودة الاتصال للنقر على زر في القائمة المنبثقة.
removeToolboxCategoryCallback(key)		إزالة استدعاء النقر على اسم فئة مخصَّصة في مربع الأدوات
removeTopBlock(block)		يؤدي هذا الخيار إلى إزالة مجموعة من قائمة الأقسام العليا.
removeTopBoundedElement(element)		لإزالة عنصر محدد من قائمة العناصر ذات الحدود العلوية.
removeTopComment(comment)		لإزالة تعليق من قائمة أهم التعليقات.
renameVariableById(id, newName)		أعِد تسمية متغيّر من خلال تعديل اسمه في خريطة المتغيّر. يمكنك تعديل القائمة المنبثقة لإظهار المتغير الذي تمت إعادة تسميته على الفور.
render()		عرض جميع الأجزاء في مساحة العمل
resize()		يمكنك تغيير حجم كل مساحة العمل في Chrome وتغيير موضعها (مربع الأدوات والمهملات وأشرطة التمرير وما إلى ذلك) ويجب طلب ذلك عندما يتغير شيء ما يتطلب إعادة حساب أبعاد ومواضع المهملات أو التكبير أو التصغير أو صندوق الأدوات وما إلى ذلك (على سبيل المثال، تغيير حجم النافذة).
scrollCenter()		اجعل مساحة العمل في وسطها.
setResizeHandlerWrapper(handler)		حفظ بيانات معالج تغيير الحجم حتى نتمكن من حذفها لاحقًا والتخلص منها.
setResizesEnabled(enabled)		عدِّل ما إذا تم تفعيل ميزة تغيير الحجم في مساحة العمل هذه. وفي حال تفعيله، سيتم تغيير حجم مساحة العمل عندما يكون ذلك مناسبًا. وفي حال إيقافها، لن يتم تغيير حجم مساحة العمل إلى أن تتم إعادة تفعيلها. استخدِم هذه السمة لتجنّب تغيير الحجم أثناء إجراء عملية مجمّعة لتعزيز الأداء.
setScale(newScale)		اضبط عامل التكبير أو التصغير لمساحة العمل.
setTheme(theme)		إعداد عنصر مظهر مساحة العمل إذا لم يتم تمرير أي مظهر، سيتم ضبط المظهر التلقائي على Classic.
setVisible(isVisible)		تبديل إذن الوصول إلى مساحة العمل هذه الميزة مخصَّصة حاليًا لمساحة العمل الرئيسية فقط.
startDrag(e, xy)		يمكنك البدء بتتبّع سحب عنصر في مساحة العمل هذه.
الترجمة(x, y)		ترجمة مساحة العمل هذه إلى إحداثيات جديدة
updateInverseScreenCTM()		وضع علامة على الشاشة المعكوسة CTM على أنها غير نظيفة.
updateToolbox(toolboxDef)		عدِّل شجرة الحظر في صندوق الأدوات الحالي.
التكبير(x, y, amount)		تكبير مساحة العمل أو تصغيرها بالنسبة إلى/توسيطها على الإحداثي (x، y).
zoomCenter(type)		تكبير المربّعات التي يتم توسيطها في مركز العرض عن طريق التكبير أو التصغير
zoomToFit()		تكبير المربّعات لتلائم مساحة العمل، إن أمكن.