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>