/** * @license * Copyright 2012 Google LLC * SPDX-License-Identifier: Apache-2.0 */ /** * @fileoverview List blocks for Blockly. * * This file is scraped to extract a .json file of block definitions. The array * passed to defineBlocksWithJsonArray(..) must be strict JSON: double quotes * only, no outside references, no functions, no trailing commas, etc. The one * exception is end-of-line comments, which the scraper will remove. * @author fraser@google.com (Neil Fraser) */ 'use strict'; goog.provide('Blockly.Constants.Lists'); goog.require('Blockly'); goog.require('Blockly.Blocks'); goog.require('Blockly.FieldDropdown'); goog.require('Blockly.FieldLabel'); goog.require('Blockly.Mutator'); goog.require('Blockly.PXTBlockly.Extensions'); /** * Unused constant for the common HSV hue for all blocks in this category. * @deprecated Use Blockly.Msg['LISTS_HUE']. (2018 April 5) */ Blockly.Constants.Lists.HUE = 260; Blockly.defineBlocksWithJsonArray([ // BEGIN JSON EXTRACT // Block for creating an empty list // The 'list_create_with' block is preferred as it is more flexible. // // // { "type": "lists_create_empty", "message0": "%{BKY_LISTS_CREATE_EMPTY_TITLE}", "output": "Array", "outputShape": Blockly.OUTPUT_SHAPE_ROUND, "style": "list_blocks", "tooltip": "%{BKY_LISTS_CREATE_EMPTY_TOOLTIP}", "helpUrl": "%{BKY_LISTS_CREATE_EMPTY_HELPURL}" }, // Block for creating a list with one element repeated. { "type": "lists_repeat", "message0": "%{BKY_LISTS_REPEAT_TITLE}", "args0": [ { "type": "input_value", "name": "ITEM" }, { "type": "input_value", "name": "NUM", "check": "Number" } ], "output": "Array", "outputShape": Blockly.OUTPUT_SHAPE_ROUND, "style": "list_blocks", "tooltip": "%{BKY_LISTS_REPEAT_TOOLTIP}", "helpUrl": "%{BKY_LISTS_REPEAT_HELPURL}" }, // Block for reversing a list. { "type": "lists_reverse", "message0": "%{BKY_LISTS_REVERSE_MESSAGE0}", "args0": [ { "type": "input_value", "name": "LIST", "check": "Array" } ], "output": "Array", "outputShape": Blockly.OUTPUT_SHAPE_ROUND, "inputsInline": true, "style": "list_blocks", "tooltip": "%{BKY_LISTS_REVERSE_TOOLTIP}", "helpUrl": "%{BKY_LISTS_REVERSE_HELPURL}" }, // Block for checking if a list is empty { "type": "lists_isEmpty", "message0": "%{BKY_LISTS_ISEMPTY_TITLE}", "args0": [ { "type": "input_value", "name": "VALUE", "check": ["String", "Array"] } ], "output": "Boolean", "outputShape": Blockly.OUTPUT_SHAPE_HEXAGONAL, "style": "list_blocks", "tooltip": "%{BKY_LISTS_ISEMPTY_TOOLTIP}", "helpUrl": "%{BKY_LISTS_ISEMPTY_HELPURL}" }, // Block for getting the list length { "type": "lists_length", "message0": "%{BKY_LISTS_LENGTH_TITLE}", "args0": [ { "type": "input_value", "name": "VALUE", "check": ["String", "Array"] } ], "output": "Number", "outputShape": Blockly.OUTPUT_SHAPE_ROUND, "style": "list_blocks", "tooltip": "%{BKY_LISTS_LENGTH_TOOLTIP}", "helpUrl": "%{BKY_LISTS_LENGTH_HELPURL}" } ]); // END JSON EXTRACT (Do not delete this comment.) Blockly.Blocks['lists_create_with'] = { /** * Block for creating a list with any number of elements of any type. * @this {Blockly.Block} */ init: function() { Blockly.Extensions.apply('inline-svgs', this, false); this.setHelpUrl(Blockly.Msg['LISTS_CREATE_WITH_HELPURL']); this.setStyle('list_blocks'); this.itemCount_ = 3; this.horizontalAfter_ = 3; this.updateShape_(); this.setOutput(true, 'Array'); this.setOutputShape(Blockly.OUTPUT_SHAPE_ROUND); this.setInputsInline(true); //this.setMutator(new Blockly.Mutator(['lists_create_with_item'])); this.setTooltip(Blockly.Msg['LISTS_CREATE_WITH_TOOLTIP']); }, /** * Create XML to represent list inputs. * @return {!Element} XML storage element. * @this {Blockly.Block} */ mutationToDom: function() { var container = Blockly.utils.xml.createElement('mutation'); container.setAttribute('items', this.itemCount_); if (this.horizontalAfter_) { container.setAttribute('horizontalafter', this.horizontalAfter_); } return container; }, /** * Parse XML to restore the list inputs. * @param {!Element} xmlElement XML storage element. * @this {Blockly.Block} */ domToMutation: function(xmlElement) { this.itemCount_ = parseInt(xmlElement.getAttribute('items'), 10); var horizontalAfterOverride = xmlElement.getAttribute('horizontalafter'); if (horizontalAfterOverride) { this.horizontalAfter_ = parseInt(horizontalAfterOverride, 10); } this.updateShape_(); }, /** * Populate the mutator's dialog with this block's components. * @param {!Blockly.Workspace} workspace Mutator's workspace. * @return {!Blockly.Block} Root block in mutator. * @this {Blockly.Block} */ // pxtblockly: Removing the cogwheel for array with // decompose: function(workspace) { // var containerBlock = workspace.newBlock('lists_create_with_container'); // containerBlock.initSvg(); // var connection = containerBlock.getInput('STACK').connection; // for (var i = 0; i < this.itemCount_; i++) { // var itemBlock = workspace.newBlock('lists_create_with_item'); // itemBlock.initSvg(); // connection.connect(itemBlock.previousConnection); // connection = itemBlock.nextConnection; // } // return containerBlock; // }, /** * Reconfigure this block based on the mutator dialog's components. * @param {!Blockly.Block} containerBlock Root block in mutator. * @this {Blockly.Block} */ // pxtblockly: Removing the cogwheel for array with // compose: function(containerBlock) { // var itemBlock = containerBlock.getInputTargetBlock('STACK'); // // Count number of inputs. // var connections = []; // while (itemBlock && !itemBlock.isInsertionMarker()) { // connections.push(itemBlock.valueConnection_); // itemBlock = itemBlock.nextConnection && // itemBlock.nextConnection.targetBlock(); // } // // Disconnect any children that don't belong. // for (var i = 0; i < this.itemCount_; i++) { // var connection = this.getInput('ADD' + i).connection.targetConnection; // if (connection && connections.indexOf(connection) == -1) { // connection.disconnect(); // } // } // this.itemCount_ = connections.length; // this.updateShape_(); // // Reconnect any child blocks. // for (var i = 0; i < this.itemCount_; i++) { // Blockly.Mutator.reconnect(connections[i], this, 'ADD' + i); // } // }, /** * Store pointers to any connected child blocks. */ storeConnections_: function() { this.valueConnections_ = []; for (var i = 0; i < this.itemCount_; i++) { this.valueConnections_.push(this.getInput('ADD' + i).connection.targetConnection); } }, restoreConnections_: function() { for (var i = 0; i < this.itemCount_; i++) { Blockly.Mutator.reconnect(this.valueConnections_[i], this, 'ADD' + i); } }, addItem_: function() { this.storeConnections_(); var update = function() { this.itemCount_++; }; this.update_(update); this.restoreConnections_(); // Add shadow block if (this.itemCount_ > 1) { // Find shadow type var firstInput = this.getInput('ADD' + 0); if (firstInput && firstInput.connection.targetConnection) { // Create a new shadow DOM with the same type as the first input // but with an empty default value var newInput = this.getInput('ADD' + (this.itemCount_ - 1)); var shadowInputDom = firstInput.connection.getShadowDom(); var newShadowType = shadowInputDom && shadowInputDom.getAttribute('type'); if (newShadowType) { var shadowDom = createBlockDom('shadow', newShadowType); var childValues = getChildrenByTag(shadowInputDom, 'value'); for (var i = 0; i < childValues.length; i++) { var input = childValues[i]; var inputName = input.getAttribute('name'); var valueShadow = getChildrenByTag(input, 'shadow')[0]; var valueShadowType = valueShadow && valueShadow.getAttribute('type'); appendValueDom(shadowDom, inputName, valueShadowType); } newInput.connection.setShadowDom(shadowDom); } var targetConnection = firstInput.connection.targetConnection; var connectedBlock = targetConnection && targetConnection.getSourceBlock(); var newFieldType = connectedBlock && connectedBlock.type; if (!newFieldType || newFieldType === newShadowType) { // block in the slot matches shadow; respawn to emit shadow block newInput.connection.respawnShadow_(); } else { // copy field as well if it's not the same type as the shadow var blockDom = createBlockDom('block', newFieldType); if (connectedBlock) { if (newFieldType === Blockly.FUNCTION_CALL_OUTPUT_BLOCK_TYPE) { var mutation = goog.dom.createDom('mutation'); mutation.setAttribute('name', connectedBlock.getName()); blockDom.appendChild(mutation); } else if (connectedBlock.inputList) { for (var i = 0; i < connectedBlock.inputList.length; i++) { var input = connectedBlock.inputList[i]; var valueShadow = input.connection && input.connection.getShadowDom(); var valueShadowType = valueShadow && valueShadow.getAttribute('type'); appendValueDom(blockDom, input.name, valueShadowType); } } } var fieldBlock = Blockly.Xml.domToBlock(blockDom, this.workspace); newInput.connection.connect(fieldBlock.outputConnection); } } } function getChildrenByTag(domNode, tag) { var output = []; if (!domNode || !domNode.children) return output; for (var i = 0; i < domNode.children.length; i++) { var child = domNode.children[i]; if (child.tagName === tag) { output.push(child); } } return output; } function appendValueDom(parent, name, type) { if (!name || !type) return; var value = Blockly.utils.xml.createElement('value'); value.setAttribute('name', name); value.appendChild(createBlockDom('shadow', type)); parent.appendChild(value); } function createBlockDom(tag, type) { var shadowDom = Blockly.utils.xml.createElement(tag); shadowDom.setAttribute('type', type); shadowDom.setAttribute('id', Blockly.utils.genUid()); return shadowDom; } }, removeItem_: function() { this.storeConnections_(); var update = function() { this.itemCount_--; }; this.update_(update); this.restoreConnections_(); }, update_: function(update) { Blockly.Events.setGroup(true); var block = this; var oldMutationDom = block.mutationToDom(); var oldMutation = oldMutationDom && Blockly.Xml.domToText(oldMutationDom); // Switch off rendering while the source block is rebuilt. var savedRendered = block.rendered; block.rendered = false; // Update the mutation if (update) update.call(this); // Allow the source block to rebuild itself. this.updateShape_(); // Restore rendering and show the changes. block.rendered = savedRendered; // Mutation may have added some elements that need initializing. block.initSvg(); // Ensure that any bump is part of this mutation's event group. var group = Blockly.Events.getGroup(); var newMutationDom = block.mutationToDom(); var newMutation = newMutationDom && Blockly.Xml.domToText(newMutationDom); if (oldMutation != newMutation) { Blockly.Events.fire(new Blockly.Events.BlockChange( block, 'mutation', null, oldMutation, newMutation)); setTimeout(function() { Blockly.Events.setGroup(group); block.bumpNeighbours(); Blockly.Events.setGroup(false); }, Blockly.BUMP_DELAY); } if (block.rendered) { block.render(); } Blockly.Events.setGroup(false); }, /** * Modify this block to have the correct number of inputs. * @private * @this {Blockly.Block} */ updateShape_: function() { var that = this; var add = function() { that.addItem_(); }; var remove = function() { that.removeItem_(); }; if (this.itemCount_) { if (this.getInput('EMPTY')) this.removeInput('EMPTY'); if (!this.getInput('TITLE')) { this.appendDummyInput('TITLE') .appendField(Blockly.Msg['LISTS_CREATE_WITH_INPUT_WITH']); } } else { if (this.getInput('TITLE')) this.removeInput('TITLE'); if (!this.getInput('EMPTY')) { this.appendDummyInput('EMPTY') .appendField(Blockly.Msg['LISTS_CREATE_EMPTY_TITLE']); } } var i = 0; // Add new inputs. for (i = 0; i < this.itemCount_; i++) { if (!this.getInput('ADD' + i)) { this.appendValueInput('ADD' + i); // pxt-blockly: Unused // var input = this.appendValueInput('ADD' + i) // .setAlign(Blockly.ALIGN_RIGHT); // if (i == 0) { // input.appendField(Blockly.Msg['LISTS_CREATE_WITH_INPUT_WITH']); // } } } // Remove deleted inputs. while (this.getInput('ADD' + i)) { this.removeInput('ADD' + i); i++; } if (this.getInput('BUTTONS')) this.removeInput('BUTTONS'); var buttons = this.appendDummyInput('BUTTONS'); if (this.itemCount_ > 0) { buttons.appendField(new Blockly.FieldImage(this.REMOVE_IMAGE_DATAURI, 24, 24, "*", remove, false)); } buttons.appendField(new Blockly.FieldImage(this.ADD_IMAGE_DATAURI, 24, 24, "*", add, false)); /* Switch to vertical list when the list is too long */ var showHorizontalList = this.itemCount_ <= this.horizontalAfter_; this.setInputsInline(showHorizontalList); this.setOutputShape(showHorizontalList ? Blockly.OUTPUT_SHAPE_ROUND : Blockly.OUTPUT_SHAPE_SQUARE); } }; Blockly.Blocks['lists_create_with_container'] = { /** * Mutator block for list container. * @this {Blockly.Block} */ init: function() { this.setStyle('list_blocks'); this.appendDummyInput() .appendField(Blockly.Msg['LISTS_CREATE_WITH_CONTAINER_TITLE_ADD']); this.appendStatementInput('STACK'); this.setTooltip(Blockly.Msg['LISTS_CREATE_WITH_CONTAINER_TOOLTIP']); this.contextMenu = false; } }; Blockly.Blocks['lists_create_with_item'] = { /** * Mutator block for adding items. * @this {Blockly.Block} */ init: function() { this.setStyle('list_blocks'); this.appendDummyInput() .appendField(Blockly.Msg['LISTS_CREATE_WITH_ITEM_TITLE']); this.setPreviousStatement(true); this.setNextStatement(true); this.setTooltip(Blockly.Msg['LISTS_CREATE_WITH_ITEM_TOOLTIP']); this.contextMenu = false; } }; Blockly.Blocks['lists_indexOf'] = { /** * Block for finding an item in the list. * @this {Blockly.Block} */ init: function() { var OPERATORS = [ [Blockly.Msg['LISTS_INDEX_OF_FIRST'], 'FIRST'], [Blockly.Msg['LISTS_INDEX_OF_LAST'], 'LAST'] ]; this.setHelpUrl(Blockly.Msg['LISTS_INDEX_OF_HELPURL']); this.setStyle('list_blocks'); this.setOutput(true, 'Number'); this.setOutputShape(Blockly.OUTPUT_SHAPE_ROUND); this.appendValueInput('VALUE') .setCheck('Array') .appendField(Blockly.Msg['LISTS_INDEX_OF_INPUT_IN_LIST']); this.appendValueInput('FIND') .appendField(new Blockly.FieldDropdown(OPERATORS), 'END'); this.setInputsInline(true); // Assign 'this' to a variable for use in the tooltip closure below. var thisBlock = this; this.setTooltip(function() { return Blockly.Msg['LISTS_INDEX_OF_TOOLTIP'].replace('%1', thisBlock.workspace.options.oneBasedIndex ? '0' : '-1'); }); } }; Blockly.Blocks['lists_getIndex'] = { /** * Block for getting element at index. * @this {Blockly.Block} */ init: function() { var MODE = [ [Blockly.Msg['LISTS_GET_INDEX_GET'], 'GET'], [Blockly.Msg['LISTS_GET_INDEX_GET_REMOVE'], 'GET_REMOVE'], [Blockly.Msg['LISTS_GET_INDEX_REMOVE'], 'REMOVE'] ]; this.WHERE_OPTIONS = [ [Blockly.Msg['LISTS_GET_INDEX_FROM_START'], 'FROM_START'], [Blockly.Msg['LISTS_GET_INDEX_FROM_END'], 'FROM_END'], [Blockly.Msg['LISTS_GET_INDEX_FIRST'], 'FIRST'], [Blockly.Msg['LISTS_GET_INDEX_LAST'], 'LAST'], [Blockly.Msg['LISTS_GET_INDEX_RANDOM'], 'RANDOM'] ]; this.setHelpUrl(Blockly.Msg['LISTS_GET_INDEX_HELPURL']); this.setStyle('list_blocks'); this.setOutputShape(Blockly.OUTPUT_SHAPE_ROUND); var modeMenu = new Blockly.FieldDropdown(MODE, function(value) { var isStatement = (value == 'REMOVE'); this.getSourceBlock().updateStatement_(isStatement); }); this.appendValueInput('VALUE') .setCheck('Array') .appendField(Blockly.Msg['LISTS_GET_INDEX_INPUT_IN_LIST']); this.appendDummyInput() .appendField(modeMenu, 'MODE') .appendField('', 'SPACE'); this.appendDummyInput('AT'); if (Blockly.Msg['LISTS_GET_INDEX_TAIL']) { this.appendDummyInput('TAIL') .appendField(Blockly.Msg['LISTS_GET_INDEX_TAIL']); } this.setInputsInline(true); this.setOutput(true); this.updateAt_(true); // Assign 'this' to a variable for use in the tooltip closure below. var thisBlock = this; this.setTooltip(function() { var mode = thisBlock.getFieldValue('MODE'); var where = thisBlock.getFieldValue('WHERE'); var tooltip = ''; switch (mode + ' ' + where) { case 'GET FROM_START': case 'GET FROM_END': tooltip = Blockly.Msg['LISTS_GET_INDEX_TOOLTIP_GET_FROM']; break; case 'GET FIRST': tooltip = Blockly.Msg['LISTS_GET_INDEX_TOOLTIP_GET_FIRST']; break; case 'GET LAST': tooltip = Blockly.Msg['LISTS_GET_INDEX_TOOLTIP_GET_LAST']; break; case 'GET RANDOM': tooltip = Blockly.Msg['LISTS_GET_INDEX_TOOLTIP_GET_RANDOM']; break; case 'GET_REMOVE FROM_START': case 'GET_REMOVE FROM_END': tooltip = Blockly.Msg['LISTS_GET_INDEX_TOOLTIP_GET_REMOVE_FROM']; break; case 'GET_REMOVE FIRST': tooltip = Blockly.Msg['LISTS_GET_INDEX_TOOLTIP_GET_REMOVE_FIRST']; break; case 'GET_REMOVE LAST': tooltip = Blockly.Msg['LISTS_GET_INDEX_TOOLTIP_GET_REMOVE_LAST']; break; case 'GET_REMOVE RANDOM': tooltip = Blockly.Msg['LISTS_GET_INDEX_TOOLTIP_GET_REMOVE_RANDOM']; break; case 'REMOVE FROM_START': case 'REMOVE FROM_END': tooltip = Blockly.Msg['LISTS_GET_INDEX_TOOLTIP_REMOVE_FROM']; break; case 'REMOVE FIRST': tooltip = Blockly.Msg['LISTS_GET_INDEX_TOOLTIP_REMOVE_FIRST']; break; case 'REMOVE LAST': tooltip = Blockly.Msg['LISTS_GET_INDEX_TOOLTIP_REMOVE_LAST']; break; case 'REMOVE RANDOM': tooltip = Blockly.Msg['LISTS_GET_INDEX_TOOLTIP_REMOVE_RANDOM']; break; } if (where == 'FROM_START' || where == 'FROM_END') { var msg = (where == 'FROM_START') ? Blockly.Msg['LISTS_INDEX_FROM_START_TOOLTIP'] : Blockly.Msg['LISTS_INDEX_FROM_END_TOOLTIP']; tooltip += ' ' + msg.replace('%1', thisBlock.workspace.options.oneBasedIndex ? '#1' : '#0'); } return tooltip; }); }, /** * Create XML to represent whether the block is a statement or a value. * Also represent whether there is an 'AT' input. * @return {!Element} XML storage element. * @this {Blockly.Block} */ mutationToDom: function() { var container = Blockly.utils.xml.createElement('mutation'); var isStatement = !this.outputConnection; container.setAttribute('statement', isStatement); var isAt = this.getInput('AT').type == Blockly.INPUT_VALUE; container.setAttribute('at', isAt); return container; }, /** * Parse XML to restore the 'AT' input. * @param {!Element} xmlElement XML storage element. * @this {Blockly.Block} */ domToMutation: function(xmlElement) { // Note: Until January 2013 this block did not have mutations, // so 'statement' defaults to false and 'at' defaults to true. var isStatement = (xmlElement.getAttribute('statement') == 'true'); this.updateStatement_(isStatement); var isAt = (xmlElement.getAttribute('at') != 'false'); this.updateAt_(isAt); }, /** * Switch between a value block and a statement block. * @param {boolean} newStatement True if the block should be a statement. * False if the block should be a value. * @private * @this {Blockly.Block} */ updateStatement_: function(newStatement) { var oldStatement = !this.outputConnection; if (newStatement != oldStatement) { this.unplug(true, true); if (newStatement) { this.setOutput(false); this.setPreviousStatement(true); this.setNextStatement(true); } else { this.setPreviousStatement(false); this.setNextStatement(false); this.setOutput(true); } } }, /** * Create or delete an input for the numeric index. * @param {boolean} isAt True if the input should exist. * @private * @this {Blockly.Block} */ updateAt_: function(isAt) { // Destroy old 'AT' and 'ORDINAL' inputs. this.removeInput('AT'); this.removeInput('ORDINAL', true); // Create either a value 'AT' input or a dummy input. if (isAt) { this.appendValueInput('AT').setCheck('Number'); if (Blockly.Msg['ORDINAL_NUMBER_SUFFIX']) { this.appendDummyInput('ORDINAL') .appendField(Blockly.Msg['ORDINAL_NUMBER_SUFFIX']); } } else { this.appendDummyInput('AT'); } var menu = new Blockly.FieldDropdown(this.WHERE_OPTIONS, function(value) { var newAt = (value == 'FROM_START') || (value == 'FROM_END'); // The 'isAt' variable is available due to this function being a closure. if (newAt != isAt) { var block = this.getSourceBlock(); block.updateAt_(newAt); // This menu has been destroyed and replaced. Update the replacement. block.setFieldValue(value, 'WHERE'); return null; } return undefined; }); this.getInput('AT').appendField(menu, 'WHERE'); if (Blockly.Msg['LISTS_GET_INDEX_TAIL']) { this.moveInputBefore('TAIL', null); } } }; Blockly.Blocks['lists_setIndex'] = { /** * Block for setting the element at index. * @this {Blockly.Block} */ init: function() { var MODE = [ [Blockly.Msg['LISTS_SET_INDEX_SET'], 'SET'], [Blockly.Msg['LISTS_SET_INDEX_INSERT'], 'INSERT'] ]; this.WHERE_OPTIONS = [ [Blockly.Msg['LISTS_GET_INDEX_FROM_START'], 'FROM_START'], [Blockly.Msg['LISTS_GET_INDEX_FROM_END'], 'FROM_END'], [Blockly.Msg['LISTS_GET_INDEX_FIRST'], 'FIRST'], [Blockly.Msg['LISTS_GET_INDEX_LAST'], 'LAST'], [Blockly.Msg['LISTS_GET_INDEX_RANDOM'], 'RANDOM'] ]; this.setHelpUrl(Blockly.Msg['LISTS_SET_INDEX_HELPURL']); this.setStyle('list_blocks'); this.appendValueInput('LIST') .setCheck('Array') .appendField(Blockly.Msg['LISTS_SET_INDEX_INPUT_IN_LIST']); this.appendDummyInput() .appendField(new Blockly.FieldDropdown(MODE), 'MODE') .appendField('', 'SPACE'); this.appendDummyInput('AT'); this.appendValueInput('TO') .appendField(Blockly.Msg['LISTS_SET_INDEX_INPUT_TO']); this.setInputsInline(true); this.setPreviousStatement(true); this.setNextStatement(true); this.setTooltip(Blockly.Msg['LISTS_SET_INDEX_TOOLTIP']); this.updateAt_(true); // Assign 'this' to a variable for use in the tooltip closure below. var thisBlock = this; this.setTooltip(function() { var mode = thisBlock.getFieldValue('MODE'); var where = thisBlock.getFieldValue('WHERE'); var tooltip = ''; switch (mode + ' ' + where) { case 'SET FROM_START': case 'SET FROM_END': tooltip = Blockly.Msg['LISTS_SET_INDEX_TOOLTIP_SET_FROM']; break; case 'SET FIRST': tooltip = Blockly.Msg['LISTS_SET_INDEX_TOOLTIP_SET_FIRST']; break; case 'SET LAST': tooltip = Blockly.Msg['LISTS_SET_INDEX_TOOLTIP_SET_LAST']; break; case 'SET RANDOM': tooltip = Blockly.Msg['LISTS_SET_INDEX_TOOLTIP_SET_RANDOM']; break; case 'INSERT FROM_START': case 'INSERT FROM_END': tooltip = Blockly.Msg['LISTS_SET_INDEX_TOOLTIP_INSERT_FROM']; break; case 'INSERT FIRST': tooltip = Blockly.Msg['LISTS_SET_INDEX_TOOLTIP_INSERT_FIRST']; break; case 'INSERT LAST': tooltip = Blockly.Msg['LISTS_SET_INDEX_TOOLTIP_INSERT_LAST']; break; case 'INSERT RANDOM': tooltip = Blockly.Msg['LISTS_SET_INDEX_TOOLTIP_INSERT_RANDOM']; break; } if (where == 'FROM_START' || where == 'FROM_END') { tooltip += ' ' + Blockly.Msg['LISTS_INDEX_FROM_START_TOOLTIP'] .replace('%1', thisBlock.workspace.options.oneBasedIndex ? '#1' : '#0'); } return tooltip; }); }, /** * Create XML to represent whether there is an 'AT' input. * @return {!Element} XML storage element. * @this {Blockly.Block} */ mutationToDom: function() { var container = Blockly.utils.xml.createElement('mutation'); var isAt = this.getInput('AT').type == Blockly.INPUT_VALUE; container.setAttribute('at', isAt); return container; }, /** * Parse XML to restore the 'AT' input. * @param {!Element} xmlElement XML storage element. * @this {Blockly.Block} */ domToMutation: function(xmlElement) { // Note: Until January 2013 this block did not have mutations, // so 'at' defaults to true. var isAt = (xmlElement.getAttribute('at') != 'false'); this.updateAt_(isAt); }, /** * Create or delete an input for the numeric index. * @param {boolean} isAt True if the input should exist. * @private * @this {Blockly.Block} */ updateAt_: function(isAt) { // Destroy old 'AT' and 'ORDINAL' input. this.removeInput('AT'); this.removeInput('ORDINAL', true); // Create either a value 'AT' input or a dummy input. if (isAt) { this.appendValueInput('AT').setCheck('Number'); if (Blockly.Msg['ORDINAL_NUMBER_SUFFIX']) { this.appendDummyInput('ORDINAL') .appendField(Blockly.Msg['ORDINAL_NUMBER_SUFFIX']); } } else { this.appendDummyInput('AT'); } var menu = new Blockly.FieldDropdown(this.WHERE_OPTIONS, function(value) { var newAt = (value == 'FROM_START') || (value == 'FROM_END'); // The 'isAt' variable is available due to this function being a closure. if (newAt != isAt) { var block = this.getSourceBlock(); block.updateAt_(newAt); // This menu has been destroyed and replaced. Update the replacement. block.setFieldValue(value, 'WHERE'); return null; } return undefined; }); this.moveInputBefore('AT', 'TO'); if (this.getInput('ORDINAL')) { this.moveInputBefore('ORDINAL', 'TO'); } this.getInput('AT').appendField(menu, 'WHERE'); } }; Blockly.Blocks['lists_getSublist'] = { /** * Block for getting sublist. * @this {Blockly.Block} */ init: function() { this['WHERE_OPTIONS_1'] = [ [Blockly.Msg['LISTS_GET_SUBLIST_START_FROM_START'], 'FROM_START'], [Blockly.Msg['LISTS_GET_SUBLIST_START_FROM_END'], 'FROM_END'], [Blockly.Msg['LISTS_GET_SUBLIST_START_FIRST'], 'FIRST'] ]; this['WHERE_OPTIONS_2'] = [ [Blockly.Msg['LISTS_GET_SUBLIST_END_FROM_START'], 'FROM_START'], [Blockly.Msg['LISTS_GET_SUBLIST_END_FROM_END'], 'FROM_END'], [Blockly.Msg['LISTS_GET_SUBLIST_END_LAST'], 'LAST'] ]; this.setHelpUrl(Blockly.Msg['LISTS_GET_SUBLIST_HELPURL']); this.setStyle('list_blocks'); this.appendValueInput('LIST') .setCheck('Array') .appendField(Blockly.Msg['LISTS_GET_SUBLIST_INPUT_IN_LIST']); this.appendDummyInput('AT1'); this.appendDummyInput('AT2'); if (Blockly.Msg['LISTS_GET_SUBLIST_TAIL']) { this.appendDummyInput('TAIL') .appendField(Blockly.Msg['LISTS_GET_SUBLIST_TAIL']); } this.setInputsInline(true); this.setOutput(true, 'Array'); this.setOutputShape(Blockly.OUTPUT_SHAPE_ROUND); this.updateAt_(1, true); this.updateAt_(2, true); this.setTooltip(Blockly.Msg['LISTS_GET_SUBLIST_TOOLTIP']); }, /** * Create XML to represent whether there are 'AT' inputs. * @return {!Element} XML storage element. * @this {Blockly.Block} */ mutationToDom: function() { var container = Blockly.utils.xml.createElement('mutation'); var isAt1 = this.getInput('AT1').type == Blockly.INPUT_VALUE; container.setAttribute('at1', isAt1); var isAt2 = this.getInput('AT2').type == Blockly.INPUT_VALUE; container.setAttribute('at2', isAt2); return container; }, /** * Parse XML to restore the 'AT' inputs. * @param {!Element} xmlElement XML storage element. * @this {Blockly.Block} */ domToMutation: function(xmlElement) { var isAt1 = (xmlElement.getAttribute('at1') == 'true'); var isAt2 = (xmlElement.getAttribute('at2') == 'true'); this.updateAt_(1, isAt1); this.updateAt_(2, isAt2); }, /** * Create or delete an input for a numeric index. * This block has two such inputs, independent of each other. * @param {number} n Specify first or second input (1 or 2). * @param {boolean} isAt True if the input should exist. * @private * @this {Blockly.Block} */ updateAt_: function(n, isAt) { // Create or delete an input for the numeric index. // Destroy old 'AT' and 'ORDINAL' inputs. this.removeInput('AT' + n); this.removeInput('ORDINAL' + n, true); // Create either a value 'AT' input or a dummy input. if (isAt) { this.appendValueInput('AT' + n).setCheck('Number'); if (Blockly.Msg['ORDINAL_NUMBER_SUFFIX']) { this.appendDummyInput('ORDINAL' + n) .appendField(Blockly.Msg['ORDINAL_NUMBER_SUFFIX']); } } else { this.appendDummyInput('AT' + n); } var menu = new Blockly.FieldDropdown(this['WHERE_OPTIONS_' + n], function(value) { var newAt = (value == 'FROM_START') || (value == 'FROM_END'); // The 'isAt' variable is available due to this function being a // closure. if (newAt != isAt) { var block = this.getSourceBlock(); block.updateAt_(n, newAt); // This menu has been destroyed and replaced. // Update the replacement. block.setFieldValue(value, 'WHERE' + n); return null; } }); this.getInput('AT' + n) .appendField(menu, 'WHERE' + n); if (n == 1) { this.moveInputBefore('AT1', 'AT2'); if (this.getInput('ORDINAL1')) { this.moveInputBefore('ORDINAL1', 'AT2'); } } if (Blockly.Msg['LISTS_GET_SUBLIST_TAIL']) { this.moveInputBefore('TAIL', null); } } }; Blockly.Blocks['lists_sort'] = { /** * Block for sorting a list. * @this {Blockly.Block} */ init: function() { this.jsonInit({ "message0": Blockly.Msg['LISTS_SORT_TITLE'], "args0": [ { "type": "field_dropdown", "name": "TYPE", "options": [ [Blockly.Msg['LISTS_SORT_TYPE_NUMERIC'], "NUMERIC"], [Blockly.Msg['LISTS_SORT_TYPE_TEXT'], "TEXT"], [Blockly.Msg['LISTS_SORT_TYPE_IGNORECASE'], "IGNORE_CASE"] ] }, { "type": "field_dropdown", "name": "DIRECTION", "options": [ [Blockly.Msg['LISTS_SORT_ORDER_ASCENDING'], "1"], [Blockly.Msg['LISTS_SORT_ORDER_DESCENDING'], "-1"] ] }, { "type": "input_value", "name": "LIST", "check": "Array" } ], "output": "Array", "outputShape": Blockly.OUTPUT_SHAPE_ROUND, "style": "list_blocks", "tooltip": Blockly.Msg['LISTS_SORT_TOOLTIP'], "helpUrl": Blockly.Msg['LISTS_SORT_HELPURL'] }); } }; Blockly.Blocks['lists_split'] = { /** * Block for splitting text into a list, or joining a list into text. * @this {Blockly.Block} */ init: function() { // Assign 'this' to a variable for use in the closures below. var thisBlock = this; var dropdown = new Blockly.FieldDropdown( [ [Blockly.Msg['LISTS_SPLIT_LIST_FROM_TEXT'], 'SPLIT'], [Blockly.Msg['LISTS_SPLIT_TEXT_FROM_LIST'], 'JOIN'] ], function(newMode) { thisBlock.updateType_(newMode); }); this.setHelpUrl(Blockly.Msg['LISTS_SPLIT_HELPURL']); this.setStyle('list_blocks'); this.appendValueInput('INPUT') .setCheck('String') .appendField(dropdown, 'MODE'); this.appendValueInput('DELIM') .setCheck('String') .appendField(Blockly.Msg['LISTS_SPLIT_WITH_DELIMITER']); this.setInputsInline(true); this.setOutput(true, 'Array'); this.setOutputShape(Blockly.OUTPUT_SHAPE_ROUND); this.setTooltip(function() { var mode = thisBlock.getFieldValue('MODE'); if (mode == 'SPLIT') { return Blockly.Msg['LISTS_SPLIT_TOOLTIP_SPLIT']; } else if (mode == 'JOIN') { return Blockly.Msg['LISTS_SPLIT_TOOLTIP_JOIN']; } throw Error('Unknown mode: ' + mode); }); }, /** * Modify this block to have the correct input and output types. * @param {string} newMode Either 'SPLIT' or 'JOIN'. * @private * @this {Blockly.Block} */ updateType_: function(newMode) { var mode = this.getFieldValue('MODE'); if (mode != newMode) { var inputConnection = this.getInput('INPUT').connection; inputConnection.setShadowDom(null); var inputBlock = inputConnection.targetBlock(); if (inputBlock) { inputConnection.disconnect(); if (inputBlock.isShadow()) { inputBlock.dispose(); } else { this.bumpNeighbours(); } } } if (newMode == 'SPLIT') { this.outputConnection.setCheck('Array'); this.getInput('INPUT').setCheck('String'); } else { this.outputConnection.setCheck('String'); this.getInput('INPUT').setCheck('Array'); } }, /** * Create XML to represent the input and output types. * @return {!Element} XML storage element. * @this {Blockly.Block} */ mutationToDom: function() { var container = Blockly.utils.xml.createElement('mutation'); container.setAttribute('mode', this.getFieldValue('MODE')); return container; }, /** * Parse XML to restore the input and output types. * @param {!Element} xmlElement XML storage element. * @this {Blockly.Block} */ domToMutation: function(xmlElement) { this.updateType_(xmlElement.getAttribute('mode')); } };