This commit is contained in:
Neil Fraser
2019-09-12 18:24:48 -07:00
parent e43e19d19a
commit 5650fe51a2
12 changed files with 21 additions and 21 deletions

View File

@@ -483,10 +483,10 @@ Blockly.Constants.Logic.CONTROLS_IF_MUTATOR_MIXIN = {
}, },
/** /**
* Reconnects child blocks. * Reconnects child blocks.
* @param {!Array<?Blockly.RenderedConnection>} valueConnections List of value * @param {!Array.<?Blockly.RenderedConnection>} valueConnections List of
* connectsions for if input. * value connections for 'if' input.
* @param {!Array<?Blockly.RenderedConnection>} statementConnections List of * @param {!Array.<?Blockly.RenderedConnection>} statementConnections List of
* statement connections for do input. * statement connections for 'do' input.
* @param {?Blockly.RenderedConnection} elseStatementConnection Statement * @param {?Blockly.RenderedConnection} elseStatementConnection Statement
* connection for else input. * connection for else input.
* @this {Blockly.Block} * @this {Blockly.Block}

View File

@@ -208,7 +208,7 @@ Blockly.Block = function(workspace, prototypeName, opt_id) {
}; };
/** /**
* Optional text data that round-trips beween blocks and XML. * Optional text data that round-trips between blocks and XML.
* Has no effect. May be used by 3rd parties for meta information. * Has no effect. May be used by 3rd parties for meta information.
* @type {?string} * @type {?string}
*/ */

View File

@@ -679,7 +679,7 @@ Blockly.checkBlockColourConstants = function() {
* Checks for a constant in the Blockly namespace, verifying it is undefined or * Checks for a constant in the Blockly namespace, verifying it is undefined or
* has the old/original value. Prints a warning if this is not true. * has the old/original value. Prints a warning if this is not true.
* @param {string} msgName The Msg constant identifier. * @param {string} msgName The Msg constant identifier.
* @param {Array<string>} blocklyNamePath The name parts of the tested * @param {Array.<string>} blocklyNamePath The name parts of the tested
* constant. * constant.
* @param {number|undefined} expectedValue The expected value of the constant. * @param {number|undefined} expectedValue The expected value of the constant.
* @private * @private

View File

@@ -268,7 +268,7 @@ Blockly.MenuItem.prototype.setEnabled = function(enabled) {
/** /**
* Handles click events. If the component is enabled, trigger * Handles click events. If the component is enabled, trigger
* the action assosiated with this menu item. * the action associated with this menu item.
* @param {Event} _e Mouse event to handle. * @param {Event} _e Mouse event to handle.
* @package * @package
*/ */

View File

@@ -70,7 +70,7 @@ Blockly.tree.TreeControl.prototype.getTree = function() {
}; };
/** /**
* Returns the assosiated toolbox. * Returns the associated toolbox.
* @return {Blockly.Toolbox} The toolbox. * @return {Blockly.Toolbox} The toolbox.
* @package * @package
*/ */

View File

@@ -194,7 +194,7 @@ Blockly.Generator.prototype.blockToCode = function(block, opt_thisOnly) {
} }
// First argument to func.call is the value of 'this' in the generator. // First argument to func.call is the value of 'this' in the generator.
// Prior to 24 September 2013 'this' was the only way to access the block. // Prior to 24 September 2013 'this' was the only way to access the block.
// The current prefered method of accessing the block is through the second // The current preferred method of accessing the block is through the second
// argument to func.call, which becomes the first parameter to the generator. // argument to func.call, which becomes the first parameter to the generator.
var code = func.call(block, block); var code = func.call(block, block);
if (Array.isArray(code)) { if (Array.isArray(code)) {

View File

@@ -32,7 +32,7 @@ goog.provide('Blockly.ASTNode');
* It is recommended that you use one of the createNode methods instead of * It is recommended that you use one of the createNode methods instead of
* creating a node directly. * creating a node directly.
* @constructor * @constructor
* @param {!string} type The type of the location. * @param {string} type The type of the location.
* Must be in Bockly.ASTNode.types. * Must be in Bockly.ASTNode.types.
* @param {Blockly.Block|Blockly.Connection|Blockly.Field|Blockly.Workspace} * @param {Blockly.Block|Blockly.Connection|Blockly.Field|Blockly.Workspace}
* location The position in the AST. * location The position in the AST.

View File

@@ -50,7 +50,7 @@ Blockly.user.keyMap.modifierKeys = {
/** /**
* Update the key map to contain the new action. * Update the key map to contain the new action.
* @param {!string} keyCode The key code serialized by the serializeKeyEvent. * @param {string} keyCode The key code serialized by the serializeKeyEvent.
* @param {!Blockly.Action} action The action to be executed when the keys * @param {!Blockly.Action} action The action to be executed when the keys
* corresponding to the serialized key code is pressed. * corresponding to the serialized key code is pressed.
* @package * @package
@@ -116,7 +116,7 @@ Blockly.user.keyMap.getKeyByAction = function(action) {
/** /**
* Serialize the key event. * Serialize the key event.
* @param {!Event} e A key up event holding the key code. * @param {!Event} e A key up event holding the key code.
* @return {!string} A string containing the serialized key event. * @return {string} A string containing the serialized key event.
*/ */
Blockly.user.keyMap.serializeKeyEvent = function(e) { Blockly.user.keyMap.serializeKeyEvent = function(e) {
var modifiers = Blockly.utils.object.values(Blockly.user.keyMap.modifierKeys); var modifiers = Blockly.utils.object.values(Blockly.user.keyMap.modifierKeys);
@@ -132,8 +132,8 @@ Blockly.user.keyMap.serializeKeyEvent = function(e) {
/** /**
* Create the serialized key code that will be used in the key map. * Create the serialized key code that will be used in the key map.
* @param {!number} keyCode Number code representing the key. * @param {number} keyCode Number code representing the key.
* @param {!Array<string>} modifiers List of modifiers to be used with the key. * @param {!Array.<string>} modifiers List of modifiers to be used with the key.
* All valid modifiers can be found in the Blockly.user.keyMap.modifierKeys. * All valid modifiers can be found in the Blockly.user.keyMap.modifierKeys.
* @return {string} The serialized key code for the given modifiers and key. * @return {string} The serialized key code for the given modifiers and key.
*/ */

View File

@@ -770,7 +770,7 @@ Blockly.navigation.moveCursorOnBlockMutation = function(mutatedBlock) {
/** /**
* Handler for all the keyboard navigation events. * Handler for all the keyboard navigation events.
* @param {Event} e The keyboard event. * @param {Event} e The keyboard event.
* @return {!boolean} True if the key was handled false otherwise. * @return {boolean} True if the key was handled false otherwise.
*/ */
Blockly.navigation.onKeyPress = function(e) { Blockly.navigation.onKeyPress = function(e) {
var key = Blockly.user.keyMap.serializeKeyEvent(e); var key = Blockly.user.keyMap.serializeKeyEvent(e);
@@ -1070,7 +1070,7 @@ Blockly.navigation.ACTION_TOGGLE_KEYBOARD_NAV = new Blockly.Action(
/** /**
* List of actions that can be performed in read only mode. * List of actions that can be performed in read only mode.
* @type {!Array<!Blockly.Action>} * @type {!Array.<!Blockly.Action>}
*/ */
Blockly.navigation.READONLY_ACTION_LIST = [ Blockly.navigation.READONLY_ACTION_LIST = [
Blockly.navigation.ACTION_PREVIOUS, Blockly.navigation.ACTION_PREVIOUS,

View File

@@ -448,7 +448,7 @@ Blockly.utils.aria.removeRole = function(element) {
* @param {!(Blockly.utils.aria.State|string)} stateName State attribute being set. * @param {!(Blockly.utils.aria.State|string)} stateName State attribute being set.
* Automatically adds prefix 'aria-' to the state name if the attribute is * Automatically adds prefix 'aria-' to the state name if the attribute is
* not an extra attribute. * not an extra attribute.
* @param {string|boolean|number|!Array<string>} value Value * @param {string|boolean|number|!Array.<string>} value Value
* for the state attribute. * for the state attribute.
*/ */
Blockly.utils.aria.setState = function(element, stateName, value) { Blockly.utils.aria.setState = function(element, stateName, value) {

View File

@@ -323,7 +323,7 @@ BlockDefinitionExtractor.input_ = function(input, align) {
/** /**
* Constructs a sequence <block> elements representing the field definition. * Constructs a sequence <block> elements representing the field definition.
* @param {Array<Blockly.Field>} fieldRow A list of fields in a Blockly.Input. * @param {Array.<Blockly.Field>} fieldRow A list of fields in a Blockly.Input.
* @return {Element} The fist <block> element of the sequence * @return {Element} The fist <block> element of the sequence
* (and the root of the constructed DOM). * (and the root of the constructed DOM).
* @private * @private
@@ -600,7 +600,7 @@ BlockDefinitionExtractor.buildFieldImage_ =
/** /**
* Creates a <block> element a group of allowed connection constraint types. * Creates a <block> element a group of allowed connection constraint types.
* *
* @param {Array<string>} types List of type names in this group. * @param {Array.<string>} types List of type names in this group.
* @return {Element} The <block> element representing the group, with child * @return {Element} The <block> element representing the group, with child
* types attached. * types attached.
* @private * @private

View File

@@ -59,8 +59,8 @@ function isEqualArrays(array1, array2) {
* the parameters if any exist. * the parameters if any exist.
* @param {!Object} scope The scope of the method to be mocked out. * @param {!Object} scope The scope of the method to be mocked out.
* @param {!string} funcName The name of the function we're going to mock. * @param {!string} funcName The name of the function we're going to mock.
* @param {Array<Object>} parameters The parameters to call the mock with. * @param {Array.<Object>} parameters The parameters to call the mock with.
* @param {Array<!Object>} return_values The values to return when called. * @param {Array.<!Object>} return_values The values to return when called.
* @return {!sinon.SinonStub} The stub method. * @return {!sinon.SinonStub} The stub method.
*/ */
function setUpMockMethod(scope, funcName, parameters, return_values) { function setUpMockMethod(scope, funcName, parameters, return_values) {