Files
mixly3/boards/default_src/python/blocks/utility.js
2024-07-19 10:16:00 +08:00

446 lines
14 KiB
JavaScript

/**
* @license
* Visual Blocks Editor
*
* Copyright 2012 Google Inc.
* https://developers.google.com/blockly/
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @fileoverview Utility blocks for Blockly.
* @author acbart@vt.edu (Austin Cory Bart)
*/
import * as Blockly from 'blockly/core';
const UTILITY_HUE = 160;
export const raw_table = {
// Container.
init: function () {
this.setColour(UTILITY_HUE);
this.setPreviousStatement(true);
this.setNextStatement(true);
this.appendDummyInput()
.appendField('Tabular Abstraction:');
this.appendDummyInput()
.appendField(new Blockly.FieldTable(''), 'TEXT');
}
};
export const raw_block = {
// Container.
init: function () {
this.setColour(UTILITY_HUE);
this.setPreviousStatement(true);
this.setNextStatement(true);
this.appendDummyInput()
.appendField('Code Block:');
this.appendDummyInput()
.appendField(new Blockly.FieldMultilineInput(''), 'TEXT');
}
};
export const raw_expression = {
// Container.
init: function () {
this.setColour(UTILITY_HUE);
this.appendDummyInput()
.appendField('Code Expression:');
this.appendDummyInput()
.appendField(new Blockly.FieldMultilineInput(''), 'TEXT');
this.setOutput(true);
}
};
export const raw_empty = {
// Container.
init: function () {
this.setColour(UTILITY_HUE);
this.setPreviousStatement(true);
this.setNextStatement(true);
this.appendValueInput('VALUE')
.appendField('');
this.setInputsInline(false);
}
};
export const text_comment = {
// Text value.
init: function () {
this.setColour(UTILITY_HUE);
this.appendDummyInput()
.appendTitle('Comment:')
.appendTitle(new Blockly.FieldTextInput(''), 'TEXT');
this.setPreviousStatement(true);
this.setNextStatement(true);
this.setTooltip('This comment will be ignored by Python');
}
};
export const type_check = {
// Set element at index.
init: function () {
this.setColour(UTILITY_HUE);
this.appendValueInput('VALUE')
.appendField(Blockly.Msg.TYPE_CHECK);
this.setInputsInline(false);
this.setOutput(true, 'Type');
//this.setPreviousStatement(true);
//this.setNextStatement(true);
}
};
export const text_print_multiple = {
/**
* Block for printing multiple things (including nothing)
* @this Blockly.Block
*/
init: function () {
this.setColour(UTILITY_HUE);
this.itemCount_ = 1;
this.updateShape_();
this.setPreviousStatement(true);
this.setNextStatement(true);
this.setMutator(new Blockly.icons.MutatorIcon(['text_print_multiple_item'], this));
this.setTooltip(Blockly.Msg.TEXT_PRINT_TOOLTIP);
},
/**
* Create XML to represent print inputs.
* @return {Element} XML storage element.
* @this Blockly.Block
*/
mutationToDom: function () {
var container = document.createElement('mutation');
container.setAttribute('items', this.itemCount_);
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);
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
*/
decompose: function (workspace) {
var containerBlock = Blockly.Block.obtain(workspace,
'text_print_multiple_container');
containerBlock.initSvg();
var connection = containerBlock.getInput('STACK').connection;
for (var x = 0; x < this.itemCount_; x++) {
var itemBlock = workspace.newBlock('text_print_multiple_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
*/
compose: function (containerBlock) {
var itemBlock = containerBlock.getInputTargetBlock('STACK');
// Count number of inputs.
var connections = [];
var i = 0;
while (itemBlock) {
connections[i] = itemBlock.valueConnection_;
itemBlock = itemBlock.nextConnection &&
itemBlock.nextConnection.targetBlock();
i++;
}
this.itemCount_ = i;
this.updateShape_();
// Reconnect any child blocks.
for (var i = 0; i < this.itemCount_; i++) {
if (connections[i]) {
this.getInput('PRINT' + i).connection.connect(connections[i]);
}
}
},
/**
* Store pointers to any connected child blocks.
* @param {!Blockly.Block} containerBlock Root block in mutator.
* @this Blockly.Block
*/
saveConnections: function (containerBlock) {
// Store a pointer to any connected child blocks.
var itemBlock = containerBlock.getInputTargetBlock('STACK');
var x = 0;
while (itemBlock) {
var input = this.getInput('PRINT' + x);
itemBlock.valueConnection_ = input && input.connection.targetConnection;
x++;
itemBlock = itemBlock.nextConnection &&
itemBlock.nextConnection.targetBlock();
}
},
/**
* Modify this block to have the correct number of inputs.
* @private
* @this Blockly.Block
*/
updateShape_: function () {
// Delete everything.
if (this.getInput('EMPTY')) {
this.removeInput('EMPTY');
} else {
var i = 0;
while (this.getInput('PRINT' + i)) {
this.removeInput('PRINT' + i);
i++;
}
}
// Rebuild block.
if (this.itemCount_ == 0) {
this.appendDummyInput('EMPTY')
.appendField("print");
} else {
for (var i = 0; i < this.itemCount_; i++) {
var input = this.appendValueInput('PRINT' + i);
if (i == 0) {
input.appendField("print");
}
}
}
}
};
export const text_print_multiple_container = {
// Container.
init: function () {
this.setColour(UTILITY_HUE);
this.appendDummyInput()
.appendField('print');
this.appendStatementInput('STACK');
this.setTooltip('');
this.contextMenu = false;
}
};
export const text_print_multiple_item = {
// Add items.
init: function () {
this.setColour(UTILITY_HUE);
this.appendDummyInput()
.appendField('item');
this.setInputsInline(true);
this.setPreviousStatement(true);
this.setNextStatement(true);
this.setTooltip('');
this.contextMenu = false;
}
};
export const function_call = {
/**
* Block for printing multiple things (including nothing)
* @this Blockly.Block
*/
init: function () {
this.setColour(UTILITY_HUE);
this.itemCount_ = 1;
this.hasReturn_ = false;
this.appendDummyInput()
.appendField(new Blockly.FieldTextInput("str"), 'NAME');
this.updateShape_();
this.setMutator(new Blockly.icons.MutatorIcon(['function_call_item'], this));
this.setTooltip("Can be used to call any function");
},
/**
* Create XML to represent print inputs.
* @return {Element} XML storage element.
* @this Blockly.Block
*/
mutationToDom: function () {
var container = document.createElement('mutation');
container.setAttribute('items', this.itemCount_);
container.setAttribute('hasReturn', this.hasReturn_ ? "TRUE" : "FALSE");
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);
this.hasReturn_ = xmlElement.getAttribute('hasReturn') === "TRUE";
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
*/
decompose: function (workspace) {
var containerBlock = Blockly.Block.obtain(workspace,
'function_call_container');
containerBlock.initSvg();
containerBlock.setFieldValue(this.hasStatements_ ? 'TRUE' : 'FALSE',
'RETURN');
var connection = containerBlock.getInput('STACK').connection;
for (var x = 0; x < this.itemCount_; x++) {
var itemBlock = workspace.newBlock('function_call_item');
itemBlock.initSvg();
connection.connect(itemBlock.previousConnection);
connection = itemBlock.nextConnection;
}
return containerBlock;
},
/**
* Notification that the procedure's return state has changed.
* @param {boolean} returnState New return state
* @this Blockly.Block
*/
setReturn: function (returnState) {
this.unplug(true, true);
this.setOutput(returnState);
this.setPreviousStatement(!returnState);
this.setNextStatement(!returnState);
if (this.rendered) {
this.render();
}
},
/**
* Reconfigure this block based on the mutator dialog's components.
* @param {!Blockly.Block} containerBlock Root block in mutator.
* @this Blockly.Block
*/
compose: function (containerBlock) {
var itemBlock = containerBlock.getInputTargetBlock('STACK');
// Count number of inputs.
var connections = [];
var i = 0;
while (itemBlock) {
connections[i] = itemBlock.valueConnection_;
itemBlock = itemBlock.nextConnection &&
itemBlock.nextConnection.targetBlock();
i++;
}
this.itemCount_ = i;
this.hasReturn_ = containerBlock.getFieldValue("RETURN") === "TRUE";
this.updateShape_();
// Reconnect any child blocks.
for (var i = 0; i < this.itemCount_; i++) {
if (connections[i]) {
this.getInput('ARGUMENT' + i).connection.connect(connections[i]);
}
}
},
/**
* Store pointers to any connected child blocks.
* @param {!Blockly.Block} containerBlock Root block in mutator.
* @this Blockly.Block
*/
saveConnections: function (containerBlock) {
// Store a pointer to any connected child blocks.
var itemBlock = containerBlock.getInputTargetBlock('STACK');
var x = 0;
while (itemBlock) {
var input = this.getInput('ARGUMENT' + x);
itemBlock.valueConnection_ = input && input.connection.targetConnection;
x++;
itemBlock = itemBlock.nextConnection &&
itemBlock.nextConnection.targetBlock();
}
},
/**
* Modify this block to have the correct number of inputs.
* @private
* @this Blockly.Block
*/
updateShape_: function () {
// Delete everything.
if (this.getInput('EMPTY')) {
this.removeInput('EMPTY');
} else {
var i = 0;
while (this.getInput('ARGUMENT' + i)) {
this.removeInput('ARGUMENT' + i);
i++;
}
}
// Rebuild block.
for (var i = 0; i < this.itemCount_; i++) {
this.appendValueInput('ARGUMENT' + i);
}
// Set whether returns anything
this.setReturn(this.hasReturn_);
}
};
export const function_call_container = {
// Container.
init: function () {
this.setColour(UTILITY_HUE);
this.appendDummyInput()
.appendField('Arguments');
this.appendStatementInput('STACK');
this.appendDummyInput()
.setAlign(Blockly.inputs.Align.RIGHT)
.appendField('has return')
.appendField(new Blockly.FieldCheckbox('TRUE'),
'RETURN');
this.setTooltip('');
this.contextMenu = false;
}
};
export const function_call_item = {
// Add items.
init: function () {
this.setColour(UTILITY_HUE);
this.appendDummyInput()
.appendField('argument');
this.setInputsInline(true);
this.setPreviousStatement(true);
this.setNextStatement(true);
this.setTooltip('');
this.contextMenu = false;
}
};
export const attribute_access = {
init: function () {
this.appendValueInput("MODULE")
.setCheck(null);
this.appendValueInput("NAME")
.setCheck(null)
.appendField(".");
this.setInputsInline(true);
this.setOutput(true, null);
this.setColour(230);
this.setTooltip('');
this.setHelpUrl('');
}
};