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 StandardThe 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.
Update compatibility data on GitHub
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
HTMLDialogElement: cancel event by Mozilla Contributors is licensed under CC-BY-SA 2.5.