phina.jsのほとんどのクラスはEventDispatcherを継承しています。そして、そのEventDispatcherには以下のメソッドが定義されています。

• on(addEventListener)
• off(removeEventListener)
• one(別名なし)
• fire(dispatchEvent)
• flare(dispatchEventByType)
• has(hasEventListener)
• clear(clearEventListener)

順に説明していきます。

• on, flare

  イベントとは、あらかじめ特定の名前といくつかの関数(イベントリスナと呼ぶ)を関連付けておき、後に何らかのタイミングでその名前に関連付けられた全ての関数をまとめて実行する機能です。任意のオブジェクトを引数に渡すことも出来ます。そのために使うのがonメソッドとflareメソッドです。基本的な使い方としては、
  var object = phina.util.EventDispatcher(); object.on("hello", function(e) { console.log("Hello," + (e.name || "World") + "!"); }); object.flare("hello", {name: "axion014"}); // Hello, axion014!
  のようになります。まず、onメソッドはobjectの中で渡された第一引数の文字列と第二引数の関数を関連付け(イベントリスナを定義)ます。そしてflareメソッドは、objectの中から、渡された第一引数の文字列と関連付けられた全ての関数を順番に実行(イベントを発火)します。その関数には、第二引数のオブジェクトが渡されます。その結果、このサンプルでは "Hello, axion014!" が出力されます。このサンプル内のonメソッドは「helloイベントに対応するイベントリスナを定義」、flareメソッドは「helloイベントを発火」しています。

• off

  offメソッドは、onメソッドの丁度逆の働きをします。あるオブジェクトのonメソッドを実行した後、全く同じ引数でそのオブジェクトのoffメソッドを実行すると、onメソッドによる関連付けは取り消されます。すなわち、offメソッドはイベントリスナを削除します。
  var object = phina.util.EventDispatcher(); var func = function(e) { console.log("Hello," + (e.name || "World") + "!"); }; object.on("hello", func); object.off("hello", func); object.flare("hello", {name: "axion014"});
  このコードは、実行しても何も出力されません。文字列 "hello" と関数funcの関連付けはoffメソッドによって取り消されたからです。

• one

  oneメソッドは、onメソッドと同じようにイベントリスナを定義します。しかし、flareメソッドや後述のfireメソッドによって一度関数が実行されると、そのイベントリスナは削除されます。その結果、関数は最初の一度だけ実行されます。
  var object = phina.util.EventDispatcher(); object.one("hello", function(e) { console.log("Hello," + (e.name || "World") + "!"); }); object.flare("hello", {name: "axion014"}); // Hello, axion014! object.flare("hello", {name: "axion014"});
  このコードを実行すると、 "Hello, axion014!" が一度だけ出力されます。二度は出力されません。このコードは、
  var object = phina.util.EventDispatcher(); var func = function(e) { console.log("Hello," + (e.name || "World") + "!"); object.off("hello", func); }; object.on("hello", func); object.flare("hello", {name: "axion014"}); // Hello, axion014! object.flare("hello", {name: "axion014"});
  と同等です。

• fire

  fireメソッドは、flareメソッドと同様にイベントリスナを実行します。ただし、flareメソッドで第二引数に指定していたオブジェクトを第一引数に指定し、第一引数に指定していた文字列を第二引数のtypeプロパティーに指定することが異なります。flareメソッドは、内部でfireメソッドを呼び出しています。
  object.flare("something", {s: "hoge"});
object.fire({type: "something", s: "hoge"});
  この二つのコードは同等です。

• has

  hasメソッドは、第一引数に渡された文字列に対応するイベントリスナがこのオブジェクトに含まれているかをboolean型で返します。
  var object = phina.util.EventDispatcher(); object.on("something", function() {}); console.log(object.has("something"));
  このコードはtrueを、
  var object = phina.util.EventDispatcher(); console.log(object.has("something"));
  このコードはfalseを出力します。

• clear

  clearメソッドは、第一引数に渡された文字列に対応するイベントリスナを全てまとめて削除します。
  var object = phina.util.EventDispatcher(); object.on("something", function() {}); object.on("something", function() {}); object.clear("something"); console.log(object.has("something"));
  このコードを実行すると、falseが出力されます。