Gestore delle metriche raccoglie e genera report su tutte le metriche relative all'area di lavoro di Blockly. Questa guida descrive il significato di ogni insieme di metriche restituito da Gestione metriche. Per saperne di più su Metrics Manager, puoi anche guardare il nostro Approfondimento sulle metriche del 2021.
Metriche
Metriche degli strumenti
workspace.getMetricsManager().getToolboxMetrics();
Le metriche della casella degli strumenti sono composte da height
, width
e position
di
una casella degli strumenti per le categorie. Non sono incluse le informazioni sul riquadro a scomparsa
allegato alla toolbox.
Il position
della casella degli strumenti è del tipo Blockly.utils.toolbox.Position
.
Metriche Flyout
workspace.getMetricsManager().getFlyoutMetrics();
Le metriche a popup sono composte da height
, width
e position
di una casella degli strumenti a comparsa. È importante notare che non si tratta del riquadro a scomparsa
associato alla casella degli strumenti delle categorie. Ciò riguarda solo gli strumenti a scomparsa, come
mostrato nella foto di seguito.
Il position
del riquadro a comparsa è del tipo Blockly.utils.toolbox.Position
.
Metriche SVG
workspace.getMetricsManager().getSvgMetrics();
Le metriche SVG sono composte da width
e height
del file SVG principale dell'area di lavoro. Per l'area di lavoro principale, è il file SVG con la classe blocklySvg
. Questo file SVG include l'area di lavoro visibile e la casella degli strumenti.
Visualizza metriche
workspace.getMetricsManager().getViewMetrics(opt_getWorkspaceCoordinates);
Le metriche delle viste sono composte da height
, width
, top
e left
dell'area visibile. L'area visibile è la parte dell'area di lavoro visibile. Non sono inclusi nessuno dei due tipi di strumenti.
L'angolo in alto a sinistra è relativo all'origine dell'area di lavoro. Mentre trasciniamo l'area di lavoro, vengono aggiornate le posizioni in alto e a sinistra dell'area visibile.
Metriche assolute
workspace.getMetricsManager().getAbsoluteMetrics();
Le metriche assolute sono composte dall'offset top
e left
dell'area visibile
rispetto al file SVG di ritaglio. A seconda della posizione della casella degli strumenti nell'area di lavoro, generalmente si tratta della larghezza o dell'altezza dell'area di lavoro.
Parametri per i contenuti
workspace.getMetricsManager().getContentMetrics(opt_getWorkspaceCoordinates);
Le metriche relative ai contenuti sono composte da height
, width
, top
e left
del riquadro di delimitazione attorno a qualsiasi blocco o commento dell'area 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 un'area di lavoro spostabile, l'area scorrevole è l'area del contenuto più una spaziatura interna.
Sistemi di coordinate
Per impostazione predefinita, tutte le metriche calcolate da Metrics Manager vengono restituite come coordinate di pixel. Ove applicabile, è possibile ottenere determinate metriche nelle coordinate dell'area di lavoro passando true
ai metodi delle metriche. Ad esempio, metricsManager.getViewMetrics(true)
.
workspaceCoordinate = pixelCoordinates / workspace.scale
Le coordinate dell'area di lavoro sono generalmente utilizzate per gli elementi che si trovano nell'area di lavoro, come blocchi e commenti dell'area di lavoro. Le coordinate dell'area di lavoro non cambiano con lo zoom avanti e indietro.
Override delle metriche
Gli sviluppatori che vogliono fornire le proprie metriche per l'area di lavoro
possono registrare un oggetto Metrics Manager che implementa l'interfaccia IMetricsManager
o estende Blockly.MetricsManager
.
Un esempio è disponibile nel plug-in Continuoous Toolbox o nel plug-in Fixed Edges.