ワークスペースの変更ごとにイベントがトリガーされます。これらのイベントは、各変更の前後の状態を完全に記述します。
イベントのリッスン
ワークスペースには、イベント ストリームのリッスンに使用できる addChangeListener
メソッドと removeChangeListener
メソッドがあります。その一例が、コードのリアルタイム生成です。もう一つの例は、最大ブロック上限のデモです。多くの場合、これらの 2 つの例のどちらも、トリガー イベントが何であるかは気にしません。ワークスペースの現在の状態を確認するだけです。
より高度なイベント リスナーは、トリガーとなるイベントを確認します。次の例では、ユーザーが最初のコメントを作成したときに検出してアラートを発行し、その後はリッスンを停止して、アラートがトリガーされないようにします。
function onFirstComment(event) {
if (event.type == Blockly.Events.BLOCK_CHANGE &&
event.element == 'comment' &&
!event.oldValue && event.newValue) {
alert('Congratulations on creating your first comment!')
workspace.removeChangeListener(onFirstComment);
}
}
workspace.addChangeListener(onFirstComment);
フライアウト内で発生したイベントをリッスンするために、フライアウトのワークスペースにリスナーを追加できます。
var flyoutWorkspace = yourWorkspace.getFlyout().getWorkspace();
flyoutWorkspace.addChangeListener(onFirstComment);
ブロックには、イベント ストリームをリッスンする別の方法があります。ブロックでは、onchange
関数を定義するか、setOnChange を使用して、ブロックのワークスペースで変更が発生するたびに呼び出される関数を設定できます。
イベントタイプ
個々のイベントについては、リファレンス ドキュメントをご覧ください。
デモ
イベントでできることの例については、ミラーのデモをご覧ください。このデモには 2 つの Blockly ワークスペースがあり、イベントを使用して同期されています。