Pengelola Metrik

Metrics Manager mengumpulkan dan melaporkan semua metrik yang terkait dengan Ruang kerja blok. Panduan ini menjelaskan arti setiap kumpulan metrik yang ditampilkan dari Pengelola Metrik. Untuk mengetahui informasi selengkapnya tentang Metrics Manager Anda juga dapat menonton Pembahasan Mendalam Metrik 2021.

Metrik

Metrik Toolbox

workspace.getMetricsManager().getToolboxMetrics();

Metrik toolbox terdiri dari height, width, dan position dari toolbox kategori. Ini tidak termasuk informasi {i>flyout<i} yang yang dilampirkan ke {i>toolbox<i}.

Ruang kerja Blockly dengan panah yang menunjukkan lebar dan tinggi toolbox.

position toolbox adalah dari jenis Blockly.utils.toolbox.Position.

Metrik Flyout

workspace.getMetricsManager().getFlyoutMetrics();

Metrik flyout terdiri dari height, width, dan position dari {i>flyout toolbox<i}. Perlu diperhatikan bahwa ini bukan flyout yang disertakan ke toolbox kategori. Hal ini hanya berlaku untuk toolbox flyout seperti yang ditunjukkan pada foto di bawah.

Ruang kerja Blockly dengan panah yang menunjukkan lebar dan tinggi flyout.

position flyout adalah jenis Blockly.utils.toolbox.Position.

Metrik SVG

workspace.getMetricsManager().getSvgMetrics();

Metrik SVG terdiri dari width dan height dari induk ruang kerja SVG. Untuk ruang kerja utama, ini adalah SVG dengan class blocklySvg. SVG ini mencakup ruang kerja yang terlihat serta toolbox.

Ruang kerja Blockly dengan persegi panjang biru di sekitarnya.

Melihat Metrik

workspace.getMetricsManager().getViewMetrics(opt_getWorkspaceCoordinates);

Metrik tampilan terdiri dari height, width, top, dan left dari area pandang. Area pandang adalah bagian ruang kerja yang terlihat. Hal ini tidak mencakup kedua jenis toolbox.

Ruang kerja Blockly dengan persegi panjang biru di sekitar area yang tidak termasuk kotak peralatan.

Kiri atas berhubungan dengan asal ruang kerja. Saat kita menarik di sekitar ruang kerja, posisi atas dan kiri area pandang diperbarui.

Ruang kerja Blockly dengan persegi panjang biru di sekitar area yang tidak termasuk kotak alat, dan asal yang ditampilkan offset dari sudut kiri atas.

Metrik Absolut

workspace.getMetricsManager().getAbsoluteMetrics();

Metrik absolut terdiri dari offset top dan left dari area pandang dari pareng SVG. Bergantung pada posisi toolbox di ruang kerja, ini biasanya lebar atau tinggi toolbox.

Ruang kerja Blockly dengan garis biru di sebelah kanan {i>toolbox<i} dan di atas ruang kerja. Ruang kerja Blockly dengan kotak alat horizontal. Ada garis biru di sebelah kiri ruang kerja dan di bawah toolbox.

Metrik Konten

workspace.getMetricsManager().getContentMetrics(opt_getWorkspaceCoordinates);

Metrik konten terdiri dari height, width, top, dan left kotak pembatas di sekitar blok atau komentar ruang kerja.

Ruang kerja Blockly dengan kotak biru di sekitar konten ruang kerja.

Metrik Scroll

workspace.getMetricsManager().getScrollMetrics(opt_getWorkspaceCoordinates);

Metrik scroll terdiri dari height, width, top, dan left dari area yang dapat di-scroll. Untuk ruang kerja yang dapat dipindahkan, area yang dapat di-scroll adalah konten dan beberapa padding.

Ruang kerja Blockly dengan kotak biru besar yang mengelilinginya.

Sistem Koordinat

Secara default, semua metrik yang dihitung oleh Pengelola Metrik ditampilkan sebagai koordinat piksel. Jika memungkinkan, ada opsi untuk mendapatkan metrik tertentu dalam koordinat ruang kerja dengan meneruskan true ke metode metrik. Misalnya, metricsManager.getViewMetrics(true).

workspaceCoordinate = pixelCoordinates / workspace.scale

Koordinat ruang kerja umumnya digunakan untuk item yang berada di ruang kerja, seperti blok dan komentar ruang kerja. Koordinat Workspace tidak berubah saat pengguna memperbesar dan memperkecil.

Mengganti Metrik

Developer yang ingin menyediakan metrik mereka sendiri untuk ruang kerja dapat mendaftarkan objek pengelola metrik pengganti yang menerapkan IMetricsManager terhubung atau memperluas Blockly.MetricsManager.

Contohnya dapat ditemukan di plugin Continuous Toolbox atau di plugin Tetap Edge.