指標マネージャーは、Blockly ワークスペースに関連するすべての指標を収集してレポートします。このガイドでは、各指標セットの意味について説明します。 Metrics Manager から返された値。Metrics Manager 画面について詳しくは、 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 指標は、ワークスペースの親 SVG の width
と height
で構成されます。メイン ワークスペースの場合、これは blocklySvg
クラスの SVG です。この
SVG には、表示されるワークスペースとツールボックスが含まれています。
指標を表示
workspace.getMetricsManager().getViewMetrics(opt_getWorkspaceCoordinates);
ビュー指標は、ビューポートの height
、width
、top
、left
で構成されます。ビューポートは、ワークスペースの中で表示される部分です。この
どちらのタイプのツールボックスも含まれていない。
左上は、ワークスペースの原点を基準とします。ドラッグ&ドロップで ワークスペースの上下に配置できます。 更新しました。
絶対指標
workspace.getMetricsManager().getAbsoluteMetrics();
絶対指標は、ビューポートの top
オフセットと left
オフセットで構成されます
使用します。ツールボックスがワークスペースのどこに配置されているかによって異なりますが、通常はツールボックスの幅または高さです。
コンテンツの統計情報
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
ワークスペース座標は通常、ブロックやワークスペースのコメントなど、ワークスペース上にあるアイテムに使用されます。ワークスペースの座標は変わらない ユーザーがズームイン / ズームアウトするにつれ。
指標のオーバーライド
ワークスペースに関する独自の指標を提供したいデベロッパー
代替の指標マネージャー オブジェクトを登録できます。
IMetricsManager
インターフェースまたは Blockly.MetricsManager
を拡張します。
この例は、Continuous Toolbox plugin または Fixed Edges プラグインにあります。