Prototype-element-fire

提供:Dev Guides
移動先:案内検索

プロトタイプ-fire()メソッド

このメソッドは、現在の要素をターゲットとしてカスタムイベントを発生させるために使用されます。

カスタムイベントには、ネイティブイベントと同じプロパティとメソッドがすべてあります。 ネイティブイベントのように、伝播が明示的に停止されない限り、DOMを介してバブルアップします。

カスタムイベントは同期的にディスパッチされます。Element#fireは、イベントのライフサイクルが終了するまで待機し、イベント自体を返します。

構文

element.fire(eventName[, memo]);

オプションの2番目の引数は、イベントハンドラーが読み取れるように、イベントオブジェクトの memo プロパティに割り当てられます。

戻り値

カスタムイベントを返します

この例では、ID(firstDiv)frobbed widget#19の要素。

<html>
   <head>
      <title>Prototype examples</title>
      <script type = "text/javascript" src = "/javascript/prototype.js"></script>

      <script>
         document.observe("widget:frobbed", function(event) {
            alert("Element with ID (" + event.target.id +
               ") frobbed widget #" + event.memo.widgetNumber + ".");
         });
         function showResult() {
            someNode = $('firstDiv');
            someNode.fire("widget:frobbed", { widgetNumber: 19 });
         }
      </script>
   </head>

   <body>
      <p>Click the button to see the result.</p>

      <div id = "firstDiv">
         <p>This is first paragraph</p>
      </div>
      <br/>

      <input type = "button" value = "showResult" onclick = "showResult();"/>
   </body>
</html>

出力