Gestore metriche

Il Gestore metriche raccoglie e genera report su tutte le metriche relative al Area di lavoro Blockly. Questa guida descrive il significato di ogni insieme di metriche da Gestore delle metriche. Per saperne di più su Metrics Manager, puoi anche guardare il nostro approfondimento sulle metriche del 2021.

Metriche

Metriche della cassetta degli attrezzi

workspace.getMetricsManager().getToolboxMetrics();

Le metriche della cassetta degli attrezzi sono composte da height, width e position di una cassetta degli attrezzi della categoria. Non sono incluse le informazioni sul riquadro a scomparsa a questo strumento.

L'area di lavoro di Blockly con le frecce che mostrano la larghezza e l'altezza della cassetta degli attrezzi.

position della casella degli strumenti è di tipo Blockly.utils.toolbox.Position.

Metriche popup

workspace.getMetricsManager().getFlyoutMetrics();

Le metriche generali sono composte da height, width e position di un casella degli strumenti a comparsa. È importante notare che questo non è il menu a scomparsa associato alla cassetta degli attrezzi delle categorie. Questo riguarda solo le casse degli attrezzi a scomparsa come показано показаноnella foto di seguito.

L'area di lavoro Blockly con frecce che mostrano la larghezza e l'altezza del riquadro a scomparsa.

Il position del riquadro a scomparsa è di tipo Blockly.utils.toolbox.Position.

Metriche SVG

workspace.getMetricsManager().getSvgMetrics();

Le metriche SVG sono composte dai seguenti elementi (width e height) dell'elemento padre dell'area di lavoro in formato SVG Per l'area di lavoro principale, questo è il file SVG con la classe blocklySvg. Questo Il file SVG include l'area di lavoro visibile e gli strumenti.

Lo spazio di lavoro di Blockly con un rettangolo blu attorno.

Visualizza metriche

workspace.getMetricsManager().getViewMetrics(opt_getWorkspaceCoordinates);

Le metriche di visualizzazione sono composte dai seguenti elementi: height, width, top e left dei area visibile. L'area visibile è la parte dell'area di lavoro visibile. Questo non include nessuno dei due tipi di strumenti.

Lo spazio di lavoro Blockly con un rettangolo blu intorno all'area che non include la casella degli strumenti.

L'angolo in alto a sinistra è relativo all'origine dello spazio di lavoro. Mentre trasciniamo la posizione superiore e sinistra dell'area visibile viene aggiornata.

L'area di lavoro di Blockly con un rettangolo blu attorno all'area che non include la cassetta degli attrezzi e un'origine mostrata spostata dall'angolo in alto a sinistra.

Metriche assolute

workspace.getMetricsManager().getAbsoluteMetrics();

Le metriche assolute sono composte dall'offset top e left del viewport rispetto all'elemento SVG pareng. A seconda di dove è posizionata la cassetta degli attrezzi nello spazio di lavoro, in genere si tratta della larghezza o dell'altezza della cassetta degli attrezzi.

Lo spazio di lavoro Blockly con una linea blu a destra della casella degli strumenti e sopra l'area di lavoro. L'area di lavoro di Blockly con una cassetta degli attrezzi orizzontale. A sinistra dell'area di lavoro e sotto la cassetta degli attrezzi è presente una linea blu.

Parametri per i contenuti

workspace.getMetricsManager().getContentMetrics(opt_getWorkspaceCoordinates);

Le metriche dei contenuti sono composte da height, width, top e left del riquadro di delimitazione attorno a eventuali blocchi o commenti dello spazio di lavoro.

Lo spazio di lavoro di Blockly con una casella blu attorno ai contenuti dello spazio di lavoro.

Metriche di scorrimento

workspace.getMetricsManager().getScrollMetrics(opt_getWorkspaceCoordinates);

Le metriche di scorrimento sono composte da height, width, top e left dell'area scorrevole. Per uno spazio di lavoro mobile, l'area scorrevole è l'area dei contenuti più un po' di spaziatura interna.

Lo spazio di lavoro di Blockly con una grande casella blu che lo circonda.

Sistemi di coordinate

Per impostazione predefinita, tutte le metriche calcolate da Gestore delle metriche vengono restituite come pixel coordinate. Ove applicabile, è possibile ottenere determinate metriche in coordinate dello spazio di lavoro passando true ai metodi delle metriche. Ad esempio, metricsManager.getViewMetrics(true).

workspaceCoordinate = pixelCoordinates / workspace.scale

Le coordinate dello spazio di lavoro vengono generalmente utilizzate per gli elementi che si trovano nello spazio di lavoro, come blocchi e commenti nell'area di lavoro. Le coordinate dello spazio di lavoro non cambiano quando l'utente aumenta e diminuisce lo zoom.

Metriche di override

Sviluppatori che vogliono fornire le proprie metriche per l'area di lavoro registrare un oggetto Metrics Manager sostitutivo che implementa IMetricsManager o estende Blockly.MetricsManager.

Ne è un esempio il plug-in Continuoous Toolbox o il plug-in Fixed Edges.