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

يجمع مدير المقاييس جميع المقاييس المتعلقة بمساحة العمل 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 هذا مساحة العمل المرئية بالإضافة إلى صندوق الأدوات.

مساحة العمل Blockly الذي يحيط بها مستطيل أزرق.

عرض المقاييس

workspace.getMetricsManager().getViewMetrics(opt_getWorkspaceCoordinates);

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

مساحة العمل المحظورة مع مستطيل أزرق حول المنطقة لا يشمل صندوق الأدوات

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

مساحة العمل Blockly التي تحتوي على مستطيل أزرق حول المنطقة لا يحتوي على مربع الأدوات، وأصل معروض من الزاوية العلوية اليسرى.

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

workspace.getMetricsManager().getAbsoluteMetrics();

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

مساحة العمل بشكل حظر مع خط أزرق على يمين مربع الأدوات وأعلى مساحة العمل مساحة العمل بشكل حظر مع مجموعة أدوات أفقية يوجد خط أزرق على يسار مساحة العمل وأسفل مربع الأدوات.

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

workspace.getMetricsManager().getContentMetrics(opt_getWorkspaceCoordinates);

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

مساحة العمل بشكل حظر مع مربّع أزرق حول محتويات مساحة العمل

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

workspace.getMetricsManager().getScrollMetrics(opt_getWorkspaceCoordinates);

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

مساحة العمل Blockly ويحيط بها مربّع أزرق كبير.

تنسيق الأنظمة

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

workspaceCoordinate = pixelCoordinates / workspace.scale

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

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

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

يمكن العثور على مثال على ذلك في المكوّن الإضافي "مجموعة الأدوات المستمر" أو في المكوّن الإضافي "Fixed Edge" (الحواف الثابتة).