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 nomenclatura de complementos estándar. Si tu complemento no se ajusta a ninguna de las categorías, usa el formato de nomenclatura genérico que se encuentra al final de la página.

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

Tipos de complementos

Campo

Un complemento de campo publica un solo campo personalizado.

Cargar un complemento de campo registra un nuevo tipo de campo que se puede usar en todos los espacios de trabajo de Blockly de la página.

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.

Cargar un complemento de tema define un tema nuevo que se puede usar en todos los espacios de trabajo de Blockly de la página.

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

Bloquear

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

Cargar un complemento de bloques define esos bloques para todos los espacios de trabajo de Blockly en la página.

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

Extensión de bloqueo

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

Cargar un complemento de extensión de bloques registra las extensiones para su uso en todos los espacios de trabajo de Blockly de la página.

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

Workspace

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

Cargar un complemento del espacio de trabajo no hace nada hasta que se inicializa en un espacio 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