Convenções de nomenclatura de plug-ins

Informações gerais

Nomes consistentes de plug-ins são úteis para organizar e pesquisar plug-ins e para encontrar plug-ins publicados no NPM.

Nesta página, listamos nossas convenções de nomenclatura padrão de plug-ins. Se o plug-in não se encaixar em nenhuma das categorias, use o formato de nomenclatura genérico do plug-in no final da página.

Recomendamos que você adicione as tags sugeridas no package.json para que seja mais fácil encontrar seu plug-in no npm.

Tipos de plug-ins

Campo

Um plug-in de campo publica um único campo personalizado.

O carregamento de um plug-in de campo registra um novo tipo de campo que pode ser usado em todos os espaços de trabalho do Blockly na página.

Leia mais sobre como criar campos personalizados.

App próprio Terceiros Exemplo Tags sugeridas
@blockly/field-* blockly-field-* @blockly/field-slider blockly-plugin, field

Tema

Um plug-in de tema publica um único tema do Blockly.

O carregamento de um plug-in de tema define um novo tema que pode ser usado em todos os espaços de trabalho do Blockly na página.

Leia mais sobre temas.

App próprio Terceiros Exemplo Tags sugeridas
@blockly/theme-* blockly-theme-* @blockly/theme-modern blockly-plugin, theme

Bloquear

Um plug-in de bloqueio publica uma ou mais definições de bloco.

O carregamento de um plug-in de blocos define esses blocos para todos os espaços de trabalho do Blockly na página.

Leia mais sobre como criar blocos personalizados.

App próprio Terceiros Exemplo Tags sugeridas
@blockly/block(s)-* blockly-block(s)-* @blockly/blocks-plus-minus blockly-plugin, block, blocks

Bloquear extensão

Um plug-in de extensão de bloqueio publica uma ou mais extensões de bloqueio, que podem ser usadas para compartilhar o comportamento entre blocos de forma programática.

O carregamento de um plug-in de extensão de bloco registra as extensões para uso em todos os espaços de trabalho do Blockly na página.

Leia mais sobre as extensões.

App próprio Terceiros Exemplo Tags sugeridas
@blockly/extension-* blockly-extension-* Nenhum ainda blockly-plugin,block-extension

Workspace

Um plug-in do Workspace adiciona um comportamento a um único espaço de trabalho.

O carregamento de um plug-in do Workspace não acontece até que ele seja inicializado em um espaço de trabalho do Blockly.

App próprio Terceiros Exemplo Tags sugeridas
@blockly/workspace-* blockly-workspace-* Nenhum ainda blockly-plugin,workspace

Plug-in genérico

Esse é o tipo de plug-in mais geral. Use essa convenção de nomenclatura se o plug-in não atender aos requisitos de nenhum outro tipo de plug-in.

App próprio Terceiros Exemplo Tags sugeridas
@blockly/plugin-* blockly-plugin-* @blockly/plugin-modal blockly-plugin