Prototype-event-stopobserving

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

プロトタイプ-イベントstopObserving()メソッド

このメソッドは、イベントハンドラーの登録を解除します。

この関数は、observeとまったく同じ引数セマンティクスで呼び出されます。 イベントハンドラーの登録を解除するため、この要素とイベントのペアに対してハンドラーは呼び出されなくなります。

構文

Event.stopObserving(element, eventName, handler[, useCapture = false])

渡されたパラメータに関する説明は次のとおりです-

  • element -監視するDOM要素。 Prototypeの場合と同様に、これは実際のDOM参照、または要素のID文字列のいずれかです。
  • evenetName -ブラウザでサポートされているDOMレベルごとの標準化されたイベント名。 これには、クリック、マウスダウン、マウスアップ、マウスオーバー、マウスムーブ、マウスアウトが含まれます。
  • handler -これはイベントハンドラー関数です。 これは、オンザフライで作成する匿名関数にすることができます。
  • useCapture -オプションで、_bubbling_の代わりに_capturing_を要求できます。 詳細はhttps://www.w3.org/TR/DOM-Level-2-Events/eventslにあります。

戻り値

NA.

この例は、一度クリックされた後、プログラムが監視を停止した後の反応を示しています。

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

      <script>
        //Register event 'click' and associated call back.
         Event.observe(document, 'click', respondToClick);

        //Callback function to handle the event.
         function respondToClick(event) {
            alert("Left button is pressed...." );
            Event.stopObserving(document, 'click', respondToClick);
         }
      </script>
   </head>

   <body>
      <p id = "note">Click anywhere to see the result.</p>
      <p id = "para1">This is paragraph 1</p>
      <p id = "para2">This is paragraph 2</p>
      <div id = "division">This is divsion.</div>
   </body>
</html>

出力