@blockly/block-plus-minus Built on Blockly

A group of Blockly blocks that replace the built-in mutator UI with a +/- based UI.

Currently this only affects the built-in blocks that use mutators (controls_if, text_join, list_create_with, procedures_defnoreturn, and procedures_defreturn).

But the ability to easily add this to your own mutators may be added in the future.

Installation

Yarn

yarn add @blockly/block-plus-minus

npm

npm install @blockly/block-plus-minus --save

Usage

Import

import Blockly from 'blockly';
import '@blockly/block-plus-minus';

Blockly Languages

We do not currently support translating the text in this plugin to different languages. However, if you would like to support multiple languages the messages can be translated by assigning the following properties of Blockly.Msg

  • PROCEDURE_VARIABLE (Default: "variable:"): The label which signals the text input is a variable.
Blockly.Msg['PROCEDURE_VARIABLE'] = 'variabele:'; // Dutch
// Inject workspace, etc...

XML

Blocks will automatically use the +/- UI when loaded from XML. But here is some example XML incase you are trying to add specific mutations of blocks:

If

<block type="controls_if"></block>

<block type="controls_if">
    <mutation elseif="1"></mutation>
</block>

<block type="controls_if">
    <mutation elseif="1" else="1"></mutation>
</block>

Text Join

<block type="text_join"></block>

<block type="text_join">
    <mutation items="0"></mutation>
</block>

List Create

<block type="lists_create_with"></block>

<block type="lists_create_with">
    <mutation items="0"></mutation>
</block>

License

Apache 2.0