Question

工作区上的每个更改都会触发一个事件。这些事件完整地描述了每个变化的前后状态。

监听事件

工作区具有可用于侦听事件流的addChangeListener方法和removeChangeListener方法。一个例子是 实时生成代码。另一个例子是 最大块限制演示。通常情况下，这两个例子都不关心触发事件是什么。他们只是查看工作区的当前状态。

更复杂的事件监听器将查看触发事件。以下示例检测用户何时创建其第一条评论，发出警报，然后停止监听，以便不再触发其他警报。

function onFirstComment(event) {
  if (event.type == Blockly.Events.CHANGE &&
      event.element == 'comment' &&
      !event.oldValue && event.newValue) {
    alert('Congratulations on creating your first comment!')
    workspace.removeChangeListener(onFirstComment);
  }
}
workspace.addChangeListener(onFirstComment);

模块具有另一种侦听事件流的方法。模块可以定义onchange 函数，只要块的工作空间发生更改，就会调用该函数。

事件类型

所有事件共享以下常见属性：

Name	类型	描述
type	串	Blockly.Events.CREATE，Blockly.Events.DELETE，Blockly.Events.CHANGE，Blockly.Events.MOVE，Blockly.Events.UI之一
workspaceId	串	工作区的UUID。可以找到工作区Blockly.Workspace.getById(event.workspaceId)
blockId	串	块的UUID。该块可以找到workspace.getBlockById(event.blockId)
group	串	组的UUID。某些事件是不可分割的组的一部分，例如在堆栈中插入语句

块创建事件（Blockly.Events.BLOCK_CREATE）

块创建事件有两个附加属性：

Name	类型	描述
xml	宾语	定义新块和任何连接子块的XML树
ids	排列	一个数组，包含新块的UUID和任何连接的子块

块删除事件（Blockly.Events.BLOCK_DELETE）

块删除事件有两个附加属性：

Name	类型	描述
oldXml	宾语	定义已删除块和任何已连接子块的XML树
ids	排列	包含已删除块的UUID和任何已连接子块的数组

块变更事件（Blockly.Events.BLOCK_DCHANGE）

块删除事件有两个附加属性：

Name	类型	描述
element	串	'field'，'comment'，'collapsed'，'disabled'，'inline'，'mutate'之一
name	串	当字段更改时字段的名称
oldValue	值	原有值
newValue	值	新值

块移动事件（Blockly.Events.BLOCK_MOVE）

块删除事件有两个附加属性：

Name	类型	描述
oldParentId	串	旧父块的UUID。如果它是顶级块，则未定义
oldInputName	串	旧父块的输入名称。如果它是顶级块或父级的下一个块，则为未定义
oldCoordinate	宾语	X和Y坐标，如果它是顶级块。如果有父块，则未定义
newParentId	串	新父块的UUID。如果它是顶级块，则为未定义
newInputName	串	新父母的输入名称。如果它是顶级块或父级的下一个块，则为未定义
newCoordinate	宾语	X和Y坐标，如果它是顶级块。如果它有父项，则为未定义

变量创建事件（Blockly.Events.VAR_CREATE）

变量创建事件有两个附加属性：

Name	类型	描述
varType	串	变量的类型，如'int'或'string'。不需要是唯一的。这将默认为“”，这是一种特定类型
varName	串	变量的名称。这在变量和过程中是唯一的
varId	串	变量的唯一ID

变量删除事件（Blockly.Events.VAR_DELETE）

变量删除事件有两个附加属性。

Name	类型	描述
varType	串	变量的类型，如'int'或'string'。不需要是唯一的。这将默认为“”，这是一种特定类型
varName	串	变量的名称。这在变量和过程中是唯一的
varId	串	变量的唯一ID

变量重命名事件(Blockly.Events.VAR_RENAME)

变量重命名事件有两个附加属性。

Name	类型	描述
oldName	串	变量的当前名称。这在变量和过程中是唯一的
newName	串	变量的新名称。这在变量和过程中是唯一的
varId	串	变量的唯一ID

UI事件(lockly.Events.UI)

UI事件有三个附加属性。

Name	类型	描述
element	串	'selected'，'category'，'click'，'commentOpen'，'mutatorOpen'，'warningOpen'，'theme'之一
oldValue	值	原始价值
newValue	值	改变了价值

预计由UI事件表示的UI动作列表将随着时间的推移变得更加全面。例如滚动，缩放，拖动气泡等事件。