مدير المقاييس

يجمع "مدير المقاييس" جميع المقاييس المتعلّقة بمساحة عمل Blockly ويُعدّ تقارير عنها. يوضّح هذا الدليل معنى كل مجموعة من المقاييس التي يتم إرجاعها من مدير المقاييس. لمزيد من المعلومات عن "مدير المقاييس" يمكنك أيضًا مشاهدة معلومات مفصّلة عن المقاييس لعام 2021.

المقاييس

مقاييس مجموعة الأدوات

workspace.getMetricsManager().getToolboxMetrics();

تتألّف مقاييس صندوق الأدوات من height وwidth وposition لصندوق أدوات الفئة. لا يشمل هذا المعلومات على القائمة المنبثقة مرفق بصندوق الأدوات.

position لصندوق الأدوات من النوع Blockly.utils.toolbox.Position.

مقاييس النوافذ المنبثقة

workspace.getMetricsManager().getFlyoutMetrics();

تتكون مقاييس القائمة المنبثقة من height وwidth وposition المنبثقة. من المهم ملاحظة أن هذا ليس القائمة المنبثقة التي مرفق بمربع أدوات الفئة. لا ينطبق ذلك إلا على أدوات الصندوق المنبثق كما هو موضح في الصورة أدناه.

position النافذة المنبثقة من النوع Blockly.utils.toolbox.Position.

مقاييس SVG

workspace.getMetricsManager().getSvgMetrics();

تتألّف مقاييس SVG من width وheight من العنصر الرئيسي لمساحة العمل SVG. بالنسبة إلى مساحة العمل الرئيسية، هذا هو SVG مع الفئة blocklySvg. يتضمّن ملف SVG هذا مساحة العمل المرئية بالإضافة إلى صندوق الأدوات.

عرض المقاييس

workspace.getMetricsManager().getViewMetrics(opt_getWorkspaceCoordinates);

تتألف مقاييس العرض من height وwidth وtop وleft لحدود العرض. إطار العرض هو الجزء المرئي من مساحة العمل. هذا النمط لا تتضمن أيًا من نوعي مربع الأدوات.

تكون أعلى يمين الصفحة بالنسبة إلى نقطة أصل مساحة العمل. أثناء السحب حول مساحة العمل، يكون الموضع العلوي والأيسر من إطار العرض تحديث.

المقاييس المطلقة

workspace.getMetricsManager().getAbsoluteMetrics();

تتألّف المقاييس المطلقة من الإزاحة top وleft لمساحة العرض من ملف SVG الأصلي. وعادةً ما يكون هذا هو عرض أو ارتفاع صندوق الأدوات، وذلك استنادًا إلى موضع صندوق الأدوات في مساحة العمل.

معايير المحتوى

workspace.getMetricsManager().getContentMetrics(opt_getWorkspaceCoordinates);

تتألف مقاييس المحتوى من height وwidth وtop وleft للمربّع المحيط بأيّ وحدات أو تعليقات في مساحة العمل.

ملاحظة: لا تأخذ مقاييس المحتوى في الاعتبار التعليقات المحظورة، بل تعليقات workspace فقط.

مقاييس التمرير

workspace.getMetricsManager().getScrollMetrics(opt_getWorkspaceCoordinates);

تتألف مقاييس التمرير من height وwidth وtop وleft من المنطقة القابلة للتمرير. بالنسبة إلى مساحة العمل المتنقلة، تكون المنطقة القابلة للتمرير هي المحتوى المنطقة بالإضافة إلى بعض المساحة المتروكة.

أنظمة الإحداثيات

يتم تلقائيًا عرض جميع المقاييس المحسوبة بواسطة "مدير المقاييس" على شكل وحدات بكسل. الإحداثيات. يتوفّر خيار الحصول على مقاييس معيّنة في إحداثيات مساحة العمل، وذلك حسب الاقتضاء، من خلال تمرير true إلى طُرق المقاييس. على سبيل المثال: metricsManager.getViewMetrics(true)

workspaceCoordinate = pixelCoordinates / workspace.scale

تُستخدم إحداثيات Workspace بشكل عام للعناصر الموجودة في مساحة العمل، مثل عمليات الحظر والتعليقات على Workspace لا تتغيّر إحداثيات مساحة العمل عندما يكبّر المستخدم الصورة أو يصغرها.

المقاييس التي يتمّ إلغاؤها

يمكن للمطوّرين الذين يريدون تقديم مقاييس خاصة بهم لمساحة العمل تسجيل عنصر بديل لإدارة المقاييس ينفِّذ واجهة IMetricsManager أو يمدّد Blockly.MetricsManager.

يمكنك العثور على مثال على ذلك في مكوّن "صندوق الأدوات المستمر" الإضافي أو في مكوّن "الحواف الثابتة" الإضافي.