מנהל המדדים

מנהל המדדים אוסף ומדווח על כל המדדים הקשורים חסימה של סביבת עבודה. במדריך הזה מוסבר מה המשמעות של כל קבוצת מדדים שמוחזרת ממנהל המדדים. למידע נוסף על Metrics Manager, אפשר גם לצפות בניתוח מעמיק של המדדים לשנת 2021.

מדדים

מדדי ארגז הכלים

workspace.getMetricsManager().getToolboxMetrics();

המדדים של ארגז הכלים מורכבים מהמדדים height, width ו-position ארגז כלים של קטגוריות. המידע הזה לא כולל מידע על התפריט הנפתח שמצורף לתיבת הכלים.

סביבת העבודה של Blockly עם חיצים שמראים את הרוחב והגובה של ארגז הכלים.

ה-position של תיבת הכלים הוא מסוג Blockly.utils.toolbox.Position.

מדדים בחלונית הקופצת

workspace.getMetricsManager().getFlyoutMetrics();

מדדי הזרימה קדימה מורכבים מהמדדים height, width ו-position של מתוך ארגז הכלים של Google. חשוב לציין, שזו לא רשת הערכים מצורף לארגז הכלים של הקטגוריה. זה מתייחס רק לארגזי כלים עגולים כמו שמוצגת בתמונה למטה.

סביבת העבודה של Blockly עם חצים שמציגים את הרוחב והגובה של התפריט הנפתח.

הערך 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 עם מלבן כחול סביב האזור שלא כולל את תיבת הכלים.

הפינה הימנית העליונה היא ביחס למקור של סביבת העבודה. כשאנחנו גוררים סביב סביבת העבודה, מופיעים המיקומים העליונים והשמאליים של אזור התצוגה עודכן.

סביבת העבודה של Blockly עם מלבן כחול מסביב לאזור שלא כולל את ארגז הכלים, והמקור שמוצג בסטייה מהפינה הימנית העליונה.

מדדים מוחלטים

workspace.getMetricsManager().getAbsoluteMetrics();

המדדים המוחלטים מורכבים מההיסט top ו-left של אזור התצוגה מה-SVG של ההורה. בהתאם למיקום של תיבת הכלים במרחב העבודה, בדרך כלל זהו הרוחב או הגובה של תיבת הכלים.

סביבת העבודה של Blockly עם קו כחול שמופיע מימין לתיבת הכלים ומעל סביבת העבודה. סביבת העבודה של Blockly עם תיבת כלים אופקית. קו כחול מופיע בצד ימין של סביבת העבודה, מתחת לתיבת הכלים.

מדדי תוכן

workspace.getMetricsManager().getContentMetrics(opt_getWorkspaceCoordinates);

מדדי התוכן מורכבים מהערכים height,‏ width,‏ top ו-left של תיבת הגבול סביב חסימה או תגובה ב-Workspace.

סביבת העבודה של Blockly עם תיבה כחולה סביב התוכן של סביבת העבודה.

מדדי גלילה

workspace.getMetricsManager().getScrollMetrics(opt_getWorkspaceCoordinates);

מדדי הגלילה מורכבים מהמדדים height, width, top ו-left של באזור שניתן לגלול. עבור סביבת עבודה שניתנת לנייד, האזור הגלילה הוא התוכן שטח עם מרווח פנימי מסוים.

סביבת העבודה של Blockly עם תיבה כחולה גדולה שמקיפה אותה.

מערכות ניהול צוותים

כברירת מחדל, כל המדדים שמחושבים על ידי מנהל המדדים מוחזרים כקואורדינטות של פיקסלים. במקרים הרלוונטיים, אפשר לקבל מדדים מסוימים בקואורדינטות של סביבת העבודה על ידי העברת true לשיטות המדדים. לדוגמה, metricsManager.getViewMetrics(true).

workspaceCoordinate = pixelCoordinates / workspace.scale

בדרך כלל משתמשים בקואורדינטות של סביבת העבודה לפריטים שנמצאים בסביבת העבודה, כמו בלוקים ותגובות בסביבת העבודה. הקואורדינטות של Workspace לא משתנות כשמשתמש מגדיל ומקטין את התצוגה.

שינוי מדדים

מפתחים שרוצים לספק מדדים משלהם לסביבת העבודה יכולים לרשום אובייקט חלופי של מנהל מדדים שמטמיע את הממשק IMetricsManager או מרחיב את Blockly.MetricsManager.

ניתן למצוא דוגמה לכך בפלאגין של ארגז כלים רציף או בפלאגין של 'דפים קבועים'.