--- title: GlobalEventHandlers.oncancel slug: Web/API/GlobalEventHandlers/oncancel tags: - API - Dialog - Event Handler - GrobalEventHandlers - HTML DOM - NeedsExample - Property - Reference translation_of: Web/API/GlobalEventHandlers/oncancel ---
{{ApiRef("HTML DOM")}}

oncancelプロパティは{{domxref("GlobalEventHandlers")}}のミックスイン(mixin)で、{{event("cancel")}}イベントを{{HTMLElement("dialog")}}要素に送るための{{event("Event_handlers", "event handler")}}です

cancelイベントはユーザーが<dialog>を閉じる意向を示した際に発火します。このイベントハンドラーはイベントをバブリングから防ぎます。つまり、いかなる親ハンドラーであってもイベントは通知されません。

構文

target.oncancel = functionRef;

引数

functionRefは関数名もしくは関数式です。この関数は{{domxref("Event")}}オブジェクトを唯一の引数として受け取ります。

oncancelハンドラーは一つのオブジェクトに対して一つのみ割り当てることが可能です。より柔軟であることから{{domxref("EventTarget.addEventListener()")}}メソッドを代わりに使用するのも良いかもしれません。

仕様書

仕様書 状態 備考
{{SpecName('HTML WHATWG','webappapis.html#handler-oncancel','oncancel')}} {{Spec2('HTML WHATWG')}}

ブラウザーの互換性

{{Compat("api.GlobalEventHandlers.oncancel")}}

関連情報