Administrador de métricas

El Administrador de métricas recopila y, luego, informa todas las métricas relacionadas con el espacio de trabajo de Blockly. En esta guía, se describe el significado de cada conjunto de métricas que muestra el Administrador de métricas. Para obtener más información sobre el Administrador de métricas, también puedes mirar nuestro Análisis detallado de las métricas de 2021.

Métricas

Métricas de Toolbox

workspace.getMetricsManager().getToolboxMetrics();

Las métricas de la caja de herramientas se componen de los elementos height, width y position de una caja de herramientas de categoría. Esto no incluye información sobre el menú flotante que es unido a la caja de herramientas.

El lugar de trabajo de Blockly con flechas que muestran el ancho y la altura de la caja de herramientas.

El position de la caja de herramientas es del tipo Blockly.utils.toolbox.Position.

Métricas de Flyout

workspace.getMetricsManager().getFlyoutMetrics();

Las métricas flotantes se componen de height, width y position de una caja de herramientas flotante. Es importante tener en cuenta que este no es el menú flotante adjunta a la caja de herramientas de la categoría. Esto solo se aplica a las cajas de herramientas flotantes, como se muestra en la siguiente foto.

El lugar de trabajo de Blockly con flechas que muestran el ancho y la altura del menú flotante.

El position del menú flotante es del tipo Blockly.utils.toolbox.Position.

Métricas de SVG

workspace.getMetricsManager().getSvgMetrics();

Las métricas de SVG se componen de width y height del SVG superior del lugar de trabajo. Para el lugar de trabajo principal, se trata del SVG con la clase blocklySvg. Este SVG incluye el espacio de trabajo visible y la caja de herramientas.

El espacio de trabajo de Blockly con un rectángulo azul a su alrededor.

Ver métricas

workspace.getMetricsManager().getViewMetrics(opt_getWorkspaceCoordinates);

Las métricas de vista están compuestas por height, width, top y left de las viewport. El viewport es la parte del espacio de trabajo que es visible. Esto no incluye ningún tipo de caja de herramientas.

El lugar de trabajo de Blockly con un rectángulo azul alrededor del área que no incluye la caja de herramientas.

La esquina superior izquierda está relacionada con el origen del lugar de trabajo. A medida que arrastramos el área de trabajo, se actualizan la posición superior y la izquierda de la ventana de visualización.

El lugar de trabajo de Blockly con un rectángulo azul alrededor del área que no incluye la caja de herramientas y un origen que se muestra desplazado desde la esquina superior izquierda.

Métricas absolutas

workspace.getMetricsManager().getAbsoluteMetrics();

Las métricas absolutas se componen del desplazamiento top y left del viewport desde el SVG de pareng. Según dónde se ubique la caja de herramientas en el del espacio de trabajo, este suele ser el ancho o la altura de la caja de herramientas.

El lugar de trabajo de Blockly con una línea azul a la derecha de la caja de herramientas y en la parte superior del espacio de trabajo. El lugar de trabajo de Blockly con una caja de herramientas horizontal. Hay una línea azul a la izquierda del espacio de trabajo y debajo de la caja de herramientas.

Cifras del contenido

workspace.getMetricsManager().getContentMetrics(opt_getWorkspaceCoordinates);

Las métricas de contenido se componen de height, width, top y left del cuadro de límite alrededor de cualquier bloque o comentario del espacio de trabajo.

El espacio de trabajo de Blockly con un cuadro azul alrededor de su contenido.

Métricas de desplazamiento

workspace.getMetricsManager().getScrollMetrics(opt_getWorkspaceCoordinates);

Las métricas de desplazamiento se componen de height, width, top y left del área desplazable. En el caso de un espacio de trabajo móvil, el área desplazable es el área de contenido más un padding.

El espacio de trabajo de Blockly con una caja azul grande a su alrededor.

Sistemas de coordenadas

De forma predeterminada, todas las métricas que calcula el Administrador de métricas se muestran como coordenadas de píxeles. Cuando es aplicable, existe la opción de obtener ciertas métricas en coordenadas del lugar de trabajo pasando true a los métodos de métricas. Por ejemplo, metricsManager.getViewMetrics(true)

workspaceCoordinate = pixelCoordinates / workspace.scale

Por lo general, las coordenadas del lugar de trabajo se usan para los elementos que se encuentran en ese espacio, como bloques y comentarios del espacio de trabajo. Las coordenadas del espacio de trabajo no cambian a medida que el usuario acerca y aleja la imagen.

Anula métricas

Desarrolladores que desean proporcionar sus propias métricas para el lugar de trabajo puede registrar un objeto de administrador de métricas sustituto que implemente el IMetricsManager o extiende Blockly.MetricsManager.

Puedes encontrar un ejemplo de esto en el complemento Continuous Toolbox o en el complemento Fixed Edges.