Definir blocos personalizados

Os blocos são usados para programar. Eles representam expressões e instruções em linguagens de programação baseadas em texto.

Para mais informações sobre blocos e suas partes, consulte o glossário visual.

Definição de bloco

Uma definição de bloco especifica as conexões e os campos de peças de quebra-cabeça no bloco. A maior parte do visual e do estilo dos blocos é especificada de outras maneiras. A string (geralmente um código) para a qual o bloco é convertido é definida como um gerador de código de bloco.

A maneira mais fácil de definir blocos simples é usando JSON.

Este snippet de código define um bloco "avançar" com conexões anteriores e seguintes e um campo para a distância.

// Create the definition.
const definitions = Blockly.common.createBlockDefinitionsFromJsonArray([
  {
    // The type is like the "class name" for your block. It is used to construct
    // new instances. E.g. in the toolbox.
    type: 'my_custom_block',
    // The message defines the basic text of your block, and where inputs or
    // fields will be inserted.
    message0: 'move forward %1',
    args0: [
      // Each arg is associated with a %# in the message.
      // This one gets substituted for %1.
      {
        // The type specifies the kind of input or field to be inserted.
        type: 'field_number',
        // The name allows you to reference the field and get its value.
        name: 'FIELD_NAME',
      }
    ],
    // Adds an untyped previous connection to the top of the block.
    previousStatement: null,
    // Adds an untyped next connection to the bottom of the block.
    nextStatement: null,
  }
]);

// Register the definition.
Blockly.common.defineBlocks(definitions);

Para mais informações sobre como definir e adicionar blocos à sua caixa de ferramentas, consulte Visão geral dos blocos personalizados.