指標管理工具

Metrics Manager 會收集並記錄與 區塊化工作區。本指南說明每組指標的意義 從 Metrics Manager 傳回的資訊如要進一步瞭解 Metrics Manager 你也可以觀看我們的 2021 年指標深入解析影片。

指標

Toolbox 指標

workspace.getMetricsManager().getToolboxMetrics();

工具箱指標是由下列值的 height、width 和 position 組成： 類別工具箱並不包含 工具箱中附加的映像檔

有箭頭顯示工具箱寬度和高度的 Blockly 工作區。

工具箱的 position 屬於 Blockly.utils.toolbox.Position 類型。

Flyout 指標

workspace.getMetricsManager().getFlyoutMetrics();

飛出指標是由以下文字的 height、width 和 position 組成。 快閃工具箱需要注意的是，這並非 類別工具箱都有這只適用於向外擴充工具箱 如下方相片所示

含有顯示飛出寬度和高度的 Blockly 工作區。

飛出的 position 屬於 Blockly.utils.toolbox.Position 類型。

SVG 指標

workspace.getMetricsManager().getSvgMetrics();

SVG 指標由工作區父項的 width 和 height 組成 SVG。在主要工作區中，這是包含 blocklySvg 類別的 SVG。這個 SVG 內含可見工作區和工具箱。

周圍有藍色矩形的 Blockly 工作區。

查看指標

workspace.getMetricsManager().getViewMetrics(opt_getWorkspaceCoordinates);

檢視指標由下列項目的 height、width、top 和 left 組成 檢視區域可視區域是指工作區中可見的部分。這個 都不包含任一類型的工具箱。

「Blockly」工作區的周圍有藍色矩形，不包含工具箱。

畫面左上方以工作區來源為基準。在拖曳 工作區內螢幕的頂端和左側位置周圍 已更新。

「Blockly」工作區的周圍有藍色矩形 (不包含工具箱)，且畫面左上角顯示位移。

絕對指標

workspace.getMetricsManager().getAbsoluteMetrics();

絕對指標是由可視區域的 top 和 left 偏移組成 從 Pareng SVG 建立的視工具箱在 工作區，通常是工具箱的寬度或高度。

Blockly 工作區在工具箱右側和工作區上方有一條藍線。 含有橫向工具箱的 Blockly 工作區。工作區左側和工具箱下方有一個藍線。

內容指標

workspace.getMetricsManager().getContentMetrics(opt_getWorkspaceCoordinates);

內容指標由 height、width、top 和 left 組成 方塊或工作區註解周圍的定界框中。

「Blockly」工作區的工作區內容周圍有藍色方塊。

捲動指標

workspace.getMetricsManager().getScrollMetrics(opt_getWorkspaceCoordinates);

捲動指標由以下元素組成：height、width、top 和 left 可捲動區域如果是可移動的工作區，可捲動區域就是內容 加上一些邊框間距

「Blockly」工作區周圍有大型藍色方塊。

座標系統

根據預設，指標管理工具計算的所有指標都會以像素的形式傳回 座標。而且還能選擇在適用情況下 將 true 傳入指標方法，即可看到工作區座標。例如 metricsManager.getViewMetrics(true)。

workspaceCoordinate = pixelCoordinates / workspace.scale

Workspace 座標通常用於工作區、 例如區塊和 Workspace 註解工作區座標維持不變 縮放情形

覆寫指標

想為工作區提供專屬指標的開發人員 可以註冊替代指標管理工具物件 IMetricsManager 介面或擴充 Blockly.MetricsManager。

您可以在 Continuous Toolbox 外掛程式或固定 Edges 外掛程式中找到相關範例。