Bloqueios

Blocos são o que você usa para programar. Elas representam expressões e declarações em linguagens de programação baseadas em texto.

Para mais informações sobre blocos e como são as partes deles, consulte o glossário visual.

Definição de bloco

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

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

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

// Create the definition.
const definitions = Blockly.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.defineBlocks(definitions);

Para mais informações sobre como definir blocos, consulte Definir blocos.

Para saber mais sobre como incluir o bloco na caixa de ferramentas, consulte Visão geral da caixa de ferramentas.