---
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
---
<div>{{ApiRef("HTML DOM")}}</div>

<p><code><strong>oncancel</strong></code>プロパティは{{domxref("GlobalEventHandlers")}}のミックスイン(mixin)で、{{event("cancel")}}イベントを{{HTMLElement("dialog")}}要素に送るための{{domxref("EventHandler")}}です</p>

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

<h2 id="構文">構文</h2>

<pre class="syntaxbox notranslate"><em>target</em>.oncancel = <em>functionRef</em>;
</pre>

<h3 id="引数">引数</h3>

<p><code>functionRef</code>は関数名もしくは<a href="https://wiki.developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Operators/function">関数式</a>です。この関数は{{domxref("Event")}}オブジェクトを唯一の引数として受け取ります。</p>

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

<h2 id="仕様書">仕様書</h2>

<table class="spectable standard-table">
 <tbody>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">状態</th>
   <th scope="col">備考</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG','webappapis.html#handler-oncancel','oncancel')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="ブラウザーの互換性">ブラウザーの互換性</h2>



<p>{{Compat("api.GlobalEventHandlers.oncancel")}}</p>

<h2 id="関連情報">関連情報</h2>

<ul>
 <li>{{event("cancel")}} イベント</li>
 <li>HTML {{HTMLElement("dialog")}} 要素</li>
 <li>関連するイベントハンドラー: {{domxref("GlobalEventHandlers.onclose")}}</li>
</ul>