The cancel
event fires on a <dialog>
when the user instructs the browser that they wish to dismiss the current open dialog. For example, the browser might fire this event when the user presses the Esc key or clicks a "Close dialog" button which is part of the browser's UI.
Bubbles | No |
---|---|
Cancelable | Yes |
Interface | Event |
Event handler | oncancel |
Examples
Live example
HTML
<dialog class="example-dialog"> <button class="close" type="reset">Close</button> </dialog> <button class="open-dialog">Open dialog</button> <div class="result"></div>
CSS
button, div { margin: .5rem; }
JS
const result = document.querySelector('.result'); const dialog = document.querySelector('.example-dialog'); dialog.addEventListener('cancel', (event) => { result.textContent = 'dialog was canceled'; }); const openDialog = document.querySelector('.open-dialog'); openDialog.addEventListener('click', () => { if (typeof dialog.showModal === 'function') { dialog.showModal(); result.textContent = ''; } else { result.textContent = 'The dialog API is not supported by this browser'; } }); const closeButton = document.querySelector('.close'); closeButton.addEventListener('click', () => { dialog.close(); });
Result
Specifications
Specification | Status |
---|---|
HTML Living Standard The definition of 'cancel' in that specification. |
Living Standard |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
cancel event | Chrome Full support Yes | Edge Full support 79 | Firefox Full support 78 | IE No support No | Opera ? | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
See also
GlobalEventHandlers.oncancel
- HTML
<dialog>
element close