Usar blocos de procedimento integrados

Como usar o plug-in

Para usar blocos de procedimento, recomendamos o @blockly/block-shareable-procedures plug-in. Para saber a diferença entre os blocos de plug-in e os blocos integrados legados, consulte a visão geral.

Instalação

Yarn: shell yarn add @blockly/block-shareable-procedures

NPM: shell npm install @blockly/block-shareable-procedures

Uso

import Blockly from 'blockly';
import {blocks, unregisterProcedureBlocks} '@blockly/block-shareable-procedures';

unregisterProcedureBlocks();
Blockly.common.defineBlocks(blocks);

Isso vai definir blocos de procedimento que têm os mesmos nomes dos blocos de procedimento integrados legados. Portanto, se você estiver carregando JSON ou XML salvo com os blocos de procedimento antigos, eles continuarão sendo carregados corretamente.

Como adicionar à caixa de ferramentas

Depois de definir os blocos (os do plug-in ou os integrados legados), você precisa disponibilizá-los aos usuários. Isso exige o uso de uma caixa de ferramentas de estilo de categoria, porque a categoria de procedimento é preenchida dinamicamente, o que não é compatível com a caixa de ferramentas flutuante.

É possível adicionar a categoria dinâmica à caixa de ferramentas desta forma:

JSON

{
  "kind": "categoryToolbox",
  "contents": [
    {
      "kind": "category",
      "name": "Functions",
      "custom": "PROCEDURE"
    }
  ]
};

XML

<xml id="toolbox" style="display: none">
  <category name="Functions" custom="PROCEDURE">
</xml>