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

يجمع "مدير المقاييس" جميع المقاييس المتعلّقة بمساحة عمل 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.getMetricsManager().getScrollMetrics(opt_getWorkspaceCoordinates);

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

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

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

workspaceCoordinate = pixelCoordinates / workspace.scale

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

تجاوز المقاييس

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

يمكنك العثور على مثال على ذلك في المكوّن الإضافي Continuous Toolbox أو في المكوّن الإضافي Fixed Edges.