Le gestionnaire de métriques collecte et génère des rapports sur toutes les métriques liées à l'espace de travail Blockly. Ce guide décrit la signification de chaque ensemble de métriques renvoyées par le Gestionnaire de métriques. Pour en savoir plus sur le Gestionnaire de métriques, vous pouvez également regarder notre présentation détaillée des métriques 2021.
Métriques
Métriques de la boîte à outils
workspace.getMetricsManager().getToolboxMetrics();
Les métriques de la boîte à outils sont composées des éléments height, width et position de
une boîte à outils de catégorie. Cela n'inclut pas les informations sur le panneau déroulant associé à la boîte à outils.
L'élément position de la boîte à outils est de type Blockly.utils.toolbox.Position.
Métriques des pop-ups
workspace.getMetricsManager().getFlyoutMetrics();
Les métriques du panneau déroulant sont composées des height, width et position d'une boîte à outils déroulante. Notez qu'il ne s'agit pas du menu déroulant
à la boîte à outils des catégories. Cela ne concerne que les boîtes à outils qui s'ouvrent en vue, comme illustré sur la photo ci-dessous.
Le position du menu déroulant est de type Blockly.utils.toolbox.Position.
Métriques SVG
workspace.getMetricsManager().getSvgMetrics();
Les métriques SVG se composent des éléments width et height du parent de l'espace de travail.
SVG. Pour l'espace de travail principal, il s'agit du SVG avec la classe blocklySvg. Ce fichier SVG inclut l'espace de travail visible ainsi que la boîte à outils.
Afficher les métriques
workspace.getMetricsManager().getViewMetrics(opt_getWorkspaceCoordinates);
Les métriques sur les vues se composent des éléments height, width, top et left des
fenêtre d'affichage. La fenêtre d'affichage est la partie de l'espace de travail qui est visible. Ce
n'inclut aucun type de boîte à outils.
L'angle supérieur gauche est relatif à l'origine de l'espace de travail. Pendant que nous faisons glisser autour de l'espace de travail. Les positions supérieure et gauche de la fenêtre d'affichage mis à jour.
Métriques absolues
workspace.getMetricsManager().getAbsoluteMetrics();
Les métriques absolues sont composées du décalage de top et left de la fenêtre d'affichage
à partir du pareng SVG. Selon l'emplacement de la boîte à outils sur l'espace de travail, il s'agit généralement de la largeur ou de la hauteur de la boîte à outils.
Mesures du réseau de contenu
workspace.getMetricsManager().getContentMetrics(opt_getWorkspaceCoordinates);
Les métriques de contenu se composent des éléments suivants : height, width, top et left.
du cadre de délimitation autour des blocs ou des commentaires de l'espace de travail.
Métriques de défilement
workspace.getMetricsManager().getScrollMetrics(opt_getWorkspaceCoordinates);
Les métriques de défilement se composent des éléments height, width, top et left de
la zone déroulante. Pour un espace de travail amovible, la zone déroulante correspond au contenu
plus une marge intérieure.
Systèmes de coordonnées
Par défaut, toutes les métriques calculées par le gestionnaire de métriques sont renvoyées sous forme de pixels.
coordonnées. Le cas échéant, vous pouvez obtenir certaines métriques en coordonnées d'espace de travail en transmettant true aux méthodes de métriques. Exemple : metricsManager.getViewMetrics(true).
workspaceCoordinate = pixelCoordinates / workspace.scale
Les coordonnées de l'espace de travail sont généralement utilisées pour les éléments qui se trouvent dans l'espace de travail, tels que les blocs et les commentaires sur l'espace de travail. Les coordonnées de l'espace de travail ne changent pas lorsque l'utilisateur fait un zoom avant ou arrière.
Ignorer des métriques
Développeurs qui souhaitent fournir leurs propres métriques pour l'espace de travail
vous pouvez enregistrer un objet de remplacement du gestionnaire de métriques qui implémente la
IMetricsManager ou étend Blockly.MetricsManager.
Vous trouverez un exemple de ce type dans le plug-in Continuous Toolbox ou dans le plug-in Fix Edge.