From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/event/cancelable/index.html | 89 ++++++++++++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 files/ja/web/api/event/cancelable/index.html (limited to 'files/ja/web/api/event/cancelable/index.html') diff --git a/files/ja/web/api/event/cancelable/index.html b/files/ja/web/api/event/cancelable/index.html new file mode 100644 index 0000000000..6364c6a28b --- /dev/null +++ b/files/ja/web/api/event/cancelable/index.html @@ -0,0 +1,89 @@ +--- +title: Event.cancelable +slug: Web/API/Event/cancelable +tags: + - API + - DOM + - DOM Reference + - Event + - Property + - Read-only + - Reference + - イベント + - プロパティ + - 読み取り専用 +translation_of: Web/API/Event/cancelable +--- +
{{ ApiRef("DOM") }}
+ +

The cancelable は {{domxref("Event")}} インターフェイスの読み取り専用プロパティで、イベントがキャンセル可能かどうか、イベントが発生しないように抑止することができるかを示します。イベントがキャンセルできない場合、 cancelable プロパティは false となり、イベントが発生することをイベントリスナーが抑止することができないことを示します。

+ +

複数の種類のイベントを扱うイベントリスナーは、 {{domxref("event.preventDefault", "preventDefault()")}} メソッドを呼び出す前に cancelable をチェックしたほうが良いかもしれません。

+ +

ブラウザーネイティブのイベントのうち、キャンセル可能なもののほとんどは、ユーザーのページとの対話の結果から発生したものです。 {{domxref("Element/click_event", "click")}}, {{domxref("Document/scroll_event", "scroll")}}, {{domxref("Window/beforeunload_event", "beforeunload")}} の各イベントをキャンセルすると、それぞれユーザーが何かをクリックすること、ページをスクロールすること、他のページに移動することをそれぞれ抑止することができます。

+ +

その他の JavaScript によって作成されたカスタムイベントは、作成時にキャンセル可能であるかどうかを制御します。

+ +

構文

+ +
bool = event.cancelable;
+
+ +

値

+ +

結果は {{domxref("Boolean")}} で、イベントがキャンセル可能であれば true です。

+ +

例

+ +

例えば、ブラウザーベンダーは {{domxref("Document/wheel_event", "wheel")}} イベントが、最初にリスナーが呼び出されたときのみキャンセル可能にしようと提案しています。 — その後の wheel イベントはキャンセルできません。

+ +
function preventScrollWheel(event) {
+  if (typeof event.cancelable !== 'boolean' || event.cancelable) {
+    // The event can be canceled, so we do so.
+    event.preventDefault();
+  } else {
+    // The event cannot be canceled, so it is not safe
+    // to call preventDefault() on it.
+    console.warn(`The following event couldn't be canceled:`);
+    console.dir(event);
+  }
+}
+
+document.addEventListener('wheel', preventScrollWheel);
+
+ +

メモ

+ +

イベントがキャンセル可能か不可能かは、イベントが初期化されたときに決定されます。

+ +

イベントをキャンセルするには、イベントの {{domxref("event.preventDefault", "preventDefault()")}} メソッドを呼び出してください。これはイベントに関連付けられた既定の動作を実行する実装を維持します。

+ +

仕様書

+ + + + + + + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('DOM WHATWG', '#dom-event-cancelable', 'Event.cancelable')}}{{ Spec2('DOM WHATWG') }}
{{SpecName('DOM2 Events', '#Events-Event-canCancel', 'Event.cancelable')}}{{ Spec2('DOM2 Events') }}初回定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.Event.cancelable")}}

-- cgit v1.2.3-54-g00ecf