---
title: GlobalEventHandlers.onclose
slug: Web/API/GlobalEventHandlers/onclose
tags:
  - API
  - Dialog
  - Event Handler
  - GlobalEventHandlers
  - HTML DOM
  - 参考
  - 实验性的
  - 属性
  - 需要示例
translation_of: Web/API/GlobalEventHandlers/onclose
---
<div>{{ApiRef("HTML DOM")}} {{SeeCompatTable}}</div>

<p>{{domxref("GlobalEventHandlers")}} mixin 的 <code><strong>onclose</strong></code> 属性是一个 {{event("Event_handlers", "event handler")}}, 用来处理发送给 {{HTMLElement("dialog")}} 元素的 {{event("close")}} 事件。</p>

<p>当用户关闭一个 <code>&lt;dialog&gt;</code> 时，<code>close</code> 事件将被触发。</p>

<div class="blockIndicator note">
<p><strong>注意：</strong>如果要处理 window 的关闭，使用 {{domxref("WindowEventHandlers.onbeforeunload", "onbeforeunload")}} 或 {{domxref("WindowEventHandlers.onunload", "onunload")}}.</p>
</div>

<h2 id="语法">语法</h2>

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

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

<p><code>functionRef</code> 是一个函数名称或 <a href="/en-US/docs/Web/JavaScript/Reference/Operators/function">函数表达式</a>。 该函数接受一个 {{domxref("Event")}} 对象作为它唯一的参数。</p>

<p>每次只能给一个对象添加 <code>onclose</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-onclose','onclose')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

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

<h2 id="参见">参见</h2>

<ul>
 <li>{{event("close")}} 事件</li>
 <li>HTML {{HTMLElement("dialog")}} 元素</li>
 <li>相关事件回调： {{domxref("GlobalEventHandlers.oncancel")}}</li>
</ul>