Convenciones de nombres de complementos

Descripción general

Los nombres de complementos coherentes son útiles para organizar y buscar complementos, y para encontrar complementos publicados en npm.

En esta página, se enumeran nuestras convenciones de nombres de complementos estándar. Si tu complemento no se ajusta a ninguna de las categorías, usa el formato de nombres genérico de complementos al final de la página.

Te recomendamos que agregues las etiquetas sugeridas a package.json para que sea más fácil encontrar el complemento en npm.

Tipos de complementos

Campo

Los complementos de campo publican un único campo personalizado.

Cuando se carga un complemento de campo, se registra un nuevo tipo de campo que se puede usar en todos los lugares de trabajo de Blockly en la página.

Obtén más información para crear campos personalizados.

Propio Externo Ejemplo Etiquetas sugeridas
@blockly/field-* blockly-field-* @blockly/field-slider blockly-plugin, field

Tema

Un complemento de tema publica un solo tema de Blockly.

Cuando cargas un complemento de tema, se define un tema nuevo que se puede usar en todos los lugares de trabajo de Blockly en la página.

Obtén más información sobre los temas.

Propio Externo Ejemplo Etiquetas sugeridas
@blockly/theme-* blockly-theme-* @blockly/theme-modern blockly-plugin, theme

Bloqueo

Un complemento de bloque publica una o más definiciones de bloques.

La carga de un complemento de bloque define esos bloques para todos los lugares de trabajo de Blockly en la página.

Obtén más información sobre cómo crear bloques personalizados.

Propio Externo Ejemplo Etiquetas sugeridas
@blockly/block(s)-* blockly-block(s)-* @blockly/blocks-plus-minus blockly-plugin, block y blocks

Bloquear extensión

Un complemento de extensión de bloque publica una o más extensiones de bloqueo, que se pueden usar para compartir el comportamiento entre bloques de manera programática.

Si cargas un complemento de extensión de bloqueo, se registrarán las extensiones para usar en todos los lugares de trabajo de Blockly en la página.

Obtén más información sobre las extensiones.

Propio Externo Ejemplo Etiquetas sugeridas
@blockly/extension-* blockly-extension-* Aún no hay valor o fuente blockly-plugin,block-extension

Espacio de trabajo

Un complemento de Workspace agrega comportamiento a un solo espacio de trabajo.

Cargar un complemento de lugar de trabajo no hace nada hasta que se inicializa en un lugar de trabajo de Blockly.

Propio Externo Ejemplo Etiquetas sugeridas
@blockly/workspace-* blockly-workspace-* Aún no hay valor o fuente blockly-plugin,workspace

Complemento genérico

Este es el tipo de complemento más general. Usa esta convención de nombres si tu complemento no cumple con los requisitos de ningún otro tipo de complemento.

Propio Externo Ejemplo Etiquetas sugeridas
@blockly/plugin-* blockly-plugin-* @blockly/plugin-modal blockly-plugin