Namespace: Events

Blockly.Events

namespace   static

Events fired as a result of actions in Blockly's editor.

Classes

Abstract

Abstract class for an event.

BlockBase

Abstract class for a block event.

BlockChange

Class for a block change event.

BlockCreate

Class for a block creation event.

BlockDelete

Class for a block deletion event.

BlockMove

Class for a block move event. Created before the move.

Change

Class for a block change event.

CommentBase

Abstract class for a comment event.

CommentChange

Class for a comment change event.

CommentCreate

Class for a comment creation event.

CommentDelete

Class for a comment deletion event.

CommentMove

Class for a comment move event. Created before the move.

Create

Class for a block creation event.

Delete

Class for a block deletion event.

FinishedLoading

Class for a finished loading event. Used to notify the developer when the workspace has finished loading (i.e domToWorkspace). Finished loading events do not record undo or redo.

Move

Class for a block move event. Created before the move.

Ui

Class for a UI event. UI events are events that don't need to be sent over the wire for multi-user editing to work (e.g. scrolling the workspace, zooming, opening toolbox categories). UI events do not undo or redo.

VarBase

Abstract class for a variable event.

VarCreate

Class for a variable creation event.

VarDelete

Class for a variable deletion event.

VarRename

Class for a variable rename event.

Properties

BLOCK_CHANGE

constant   static

Name of event that changes a block.

BLOCK_CREATE

constant   static

Name of event that creates a block.

BLOCK_DELETE

constant   static

Name of event that deletes a block.

BLOCK_MOVE

constant   static

Name of event that moves a block.

BUMP_EVENTS

constant   static

List of events that cause objects to be bumped back into the visible portion of the workspace (only used for non-movable workspaces).

Not to be confused with bumping so that disconnected connections to do not appear connected.

CHANGE

constant   static

Name of event that changes a block. Will be deprecated for BLOCK_CHANGE.

COMMENT_CHANGE

constant   static

Name of event that changes a comment.

COMMENT_CREATE

constant   static

Name of event that creates a comment.

COMMENT_DELETE

constant   static

Name of event that deletes a comment.

COMMENT_MOVE

constant   static

Name of event that moves a comment.

CREATE

constant   static

Name of event that creates a block. Will be deprecated for BLOCK_CREATE.

DELETE

constant   static

Name of event that deletes a block. Will be deprecated for BLOCK_DELETE.

FINISHED_LOADING

static

Name of event that records a workspace load.

MOVE

constant   static

Name of event that moves a block. Will be deprecated for BLOCK_MOVE.

recordUndo

static

boolean

Sets whether the next event should be added to the undo stack.

UI

constant   static

Name of event that records a UI change.

VAR_CREATE

constant   static

Name of event that creates a variable.

VAR_DELETE

constant   static

Name of event that deletes a variable.

VAR_RENAME

constant   static

Name of event that renames a variable.

Methods

clearPendingUndo

static

clearPendingUndo()

Modify pending undo events so that when they are fired they don't land in the undo stack. Called by Blockly.Workspace.clearUndo.

CommentCreateDeleteHelper

static

CommentCreateDeleteHelper(event, create)

Helper function for Comment[Create|Delete]

Parameter
event	(non-null Blockly.Events.CommentCreate or non-null Blockly.Events.CommentDelete) The event to run.
create	boolean if True then Create, if False then Delete

disable

static

disable()

Stop sending events. Every call to this function MUST also call enable.

disableOrphans

static

disableOrphans(event)

Enable/disable a block depending on whether it is properly connected. Use this on applications where all blocks should be connected to a top block. Recommend setting the 'disable' option to 'false' in the config so that users don't try to re-enable disabled orphan blocks.

Parameter
event	Blockly.Events.Abstract Custom data for event. Value must not be null.

enable

static

enable()

Start sending events. Unless events were already disabled when the corresponding call to disable was made.

filter

static

filter(queueIn, forward) returns Array of non-null Blockly.Events.Abstract

Filter the queued events and merge duplicates.

Parameter
queueIn	Array of non-null Blockly.Events.Abstract Array of events. Value must not be null.
forward	boolean True if forward (redo), false if backward (undo).

Returns

non-null Array of non-null Blockly.Events.Abstract Array of filtered events.

fire

static

fire(event)

Create a custom event and fire it.

Parameter
event	Blockly.Events.Abstract Custom data for event. Value must not be null.

fromJson

static

fromJson(json, workspace) returns Blockly.Events.Abstract

Decode the JSON into an event.

Parameter
json	Object JSON representation. Value must not be null.
workspace	Blockly.Workspace Target workspace for event. Value must not be null.

Throws

Error if an event type is not found in the registry.

Returns

non-null Blockly.Events.Abstract The event represented by the JSON.

getDescendantIds

package   static

getDescendantIds(block) returns Array of string

Compute a list of the IDs of the specified block and all its descendants.

Parameter
block	Blockly.Block The root block. Value must not be null.

Returns

non-null Array of string List of block IDs.

getGroup

static

getGroup() returns string

Current group.

Returns

string ID string.

isEnabled

static

isEnabled() returns boolean

Returns whether events may be fired or not.

Returns

boolean True if enabled.

setGroup

static

setGroup(state)

Start or stop a group.

Parameter
state	(boolean or string) True to start new group, false to end group. String to set group explicitly.