يجمع مدير المقاييس جميع المقاييس المتعلقة بمساحة العمل 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 بشكل عام للعناصر الموجودة في مساحة العمل، مثل الكتل وتعليقات مساحة العمل. لا تتغير إحداثيات Workspace أثناء تكبير المستخدم وتصغيره.
تجاوز المقاييس
ويمكن للمطوّرين الذين يريدون تقديم مقاييس خاصة بهم لمساحة العمل تسجيل عنصر بديل لمدير المقاييس ينفّذ واجهة IMetricsManager
أو يوسِّع Blockly.MetricsManager
.
يمكن العثور على مثال على ذلك في المكوّن الإضافي "مجموعة الأدوات المستمر" أو في المكوّن الإضافي "Fixed Edge" (الحواف الثابتة).