Blocos personalizados

Este documento é destinado a desenvolvedores que querem criar novos blocos no Blockly. Presume-se que uma pessoa tem uma cópia local do Blockly que pode ser editada, uma tem familiaridade com o uso do Blockly e outra tem noções básicas sobre JavaScript.

O Blockly vem com um grande número de blocos predefinidos. Tudo, desde funções matemáticas até estruturas de loop. No entanto, para interagir com um aplicativo externo, é necessário criar blocos personalizados para formar uma API. Por exemplo, ao criar um programa de desenho, pode ser necessário criar um bloco "desenho círculo de raio R".

Na maioria dos casos, a abordagem mais fácil é encontrar um bloco realmente semelhante que já existe, copiá-lo e modificá-lo conforme necessário. A documentação a seguir é destinada a quem precisa de mais ajuda.

Definir um bloco

O primeiro passo é criar um bloco, especificando a forma, os campos e os pontos de conexão. Usar as Ferramentas para desenvolvedores da Blockly é a maneira mais fácil de escrever esse código.

→ Mais informações sobre as Ferramentas para desenvolvedores do Blockly...

Como alternativa, é possível escrever esse código manualmente depois de estudar a API.

→ Mais informações sobre Como definir bloqueios...

Os blocos avançados podem mudar dinamicamente a forma em resposta ao usuário ou a outros fatores.

→ Mais informações sobre Mutadores...

Geração de código

A segunda etapa é criar o gerador de código de bloco para exportar o novo bloco para uma linguagem de programação como JavaScript, Python, PHP, Lua ou Dart.

→ Mais informações sobre geradores de código de bloqueio...

Usar o novo bloqueio

Depois de criar o bloco, não se esqueça de adicioná-lo à caixa de ferramentas ou usá-lo em um espaço de trabalho.

→ Mais informações sobre como adicionar blocos personalizados...