Convenções de nomenclatura de plug-ins

Visão geral

Nomes de plug-ins consistentes são úteis para organizar e pesquisar plug-ins, além de encontrar plug-ins publicados no npm.

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

Recomendamos que você adicione as tags sugeridas no seu package.json para facilitar a localização do plug-in no npm.

Tipos de plug-in

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.

Primários 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.

Carregar 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.

Primários Terceiros Exemplo Tags sugeridas
@blockly/theme-* blockly-theme-* @blockly/theme-modern blockly-plugin, theme

Bloquear

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

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

Primários 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 bloco publica uma ou mais extensões de bloco, que podem ser usadas para compartilhar 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.

Primários Terceiros Exemplo Tags sugeridas
@blockly/extension-* blockly-extension-* Nenhum ainda blockly-plugin,block-extension

Espaço de trabalho

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

Carregar um plug-in do espaço de trabalho não faz nada até que ele seja inicializado em um espaço de trabalho do Blockly.

Primários 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.

Primários Terceiros Exemplo Tags sugeridas
@blockly/plugin-* blockly-plugin-* @blockly/plugin-modal blockly-plugin