指標マネージャー

指標マネージャーは、Blockly ワークスペースに関連するすべての指標を収集してレポートします。このガイドでは、各指標セットの意味について説明します。 Metrics Manager から返された値。Metrics Manager 画面について詳しくは、 2021 年の指標の詳細もご覧ください。

指標

ツールボックスの指標

workspace.getMetricsManager().getToolboxMetrics();

ツールボックス指標は、カテゴリ ツールボックスの heightwidthposition で構成されます。これには、クリックするポップアップの 取り付けます。

ツールボックスの幅と高さを示す矢印が表示された Blockly ワークスペース。

ツールボックスの positionBlockly.utils.toolbox.Position 型です。

フライトアウトの指標

workspace.getMetricsManager().getFlyoutMetrics();

フライアウト指標は、フライアウト ツールボックスの heightwidthposition で構成されます。これは、カテゴリ ツールボックスに接続されているフライアウトとは異なります。これは、以下の写真に示すように、フライアウト ツールボックスにのみ適用されます。

フライアウトの幅と高さを示す矢印が表示された Blockly ワークスペース。

フライアウトの positionBlockly.utils.toolbox.Position 型です。

SVG 指標

workspace.getMetricsManager().getSvgMetrics();

SVG 指標は、ワークスペースの親 SVG の widthheight で構成されます。メイン ワークスペースの場合、これは blocklySvg クラスの SVG です。この SVG には、表示されるワークスペースとツールボックスが含まれています。

青い長方形で囲まれた Blockly ワークスペース。

指標を表示

workspace.getMetricsManager().getViewMetrics(opt_getWorkspaceCoordinates);

ビュー指標は、ビューポートの heightwidthtopleft で構成されます。ビューポートは、ワークスペースの中で表示される部分です。この どちらのタイプのツールボックスも含まれていない。

ツールボックスを除く領域の周囲に青い長方形がある Blockly ワークスペース。

左上は、ワークスペースの原点を基準とします。ドラッグ&ドロップで ワークスペースの上下に配置できます。 更新しました。

ツールボックスを除く領域が青い長方形で囲まれ、左上隅からオフセットされた原点が表示されている Blockly ワークスペース。

絶対指標

workspace.getMetricsManager().getAbsoluteMetrics();

絶対指標は、ビューポートの top オフセットと left オフセットで構成されます 使用します。ツールボックスがワークスペースのどこに配置されているかによって異なりますが、通常はツールボックスの幅または高さです。

ツールボックスの右側とワークスペースの上部に青い線がある Blockly ワークスペース。 水平ツールボックスのある Blockly ワークスペース。ワークスペースの左側とツールボックスの下に青い線があります。

コンテンツの統計情報

workspace.getMetricsManager().getContentMetrics(opt_getWorkspaceCoordinates);

コンテンツ指標は、heightwidthtopleft で構成されます。 ブロックやワークスペースのコメントを囲みます。

ワークスペースの内容が青いボックスで囲まれている Blockly ワークスペース。

スクロール指標

workspace.getMetricsManager().getScrollMetrics(opt_getWorkspaceCoordinates);

スクロール指標は、heightwidthtopleft で構成されます。 スクロール可能な領域を定義します移動可能なワークスペースの場合、スクロール可能な領域はコンテンツ領域とパディングです。

大きな青いボックスで囲まれた Blockly ワークスペース。

座標系

デフォルトでは、指標マネージャーによって計算されたすべての指標はピクセル座標として返されます。必要に応じて、特定の指標を取得するオプションを true を指標メソッドに渡します。例: metricsManager.getViewMetrics(true)

workspaceCoordinate = pixelCoordinates / workspace.scale

ワークスペース座標は通常、ブロックやワークスペースのコメントなど、ワークスペース上にあるアイテムに使用されます。ワークスペースの座標は変わらない ユーザーがズームイン / ズームアウトするにつれ。

指標のオーバーライド

ワークスペースに関する独自の指標を提供したいデベロッパー 代替の指標マネージャー オブジェクトを登録できます。 IMetricsManager インターフェースまたは Blockly.MetricsManager を拡張します。

この例は、Continuous Toolbox plugin または Fixed Edges プラグインにあります。