--- 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 ---
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")}}