HTMLDialogElement: closedBy property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{ APIRef("HTML DOM") }}
The **closedBy** property of the {{domxref("HTMLDialogElement")}} interface indicates the types of user actions that can be used to close the associated {{htmlelement("dialog")}} element. It sets or returns the dialog's [closedby](/en-US/docs/Web/HTML/Reference/Elements/dialog#closedby) attribute value.
Value
A string; possible values are:
any- : The dialog can be dismissed with a light dismiss user action, a platform-specific user action, or a developer-specified mechanism.
closerequest- : The dialog can be dismissed with a platform-specific user action or a developer-specified mechanism.
none- : The dialog can only be dismissed with a developer-specified mechanism.
Default behavior
If the closedby attribute is absent or invalid, it falls back to the Auto state. In the Auto state:
- when the
<dialog>is opened withshowModal(), it behaves as if:closedby="closerequest" - when the
<dialog>is opened by any other means, it behaves as if:closedby="none"
Examples
Basic closedBy usage
html
<dialog closedby="any">
<p>
Closable using the <kbd>Esc</kbd> key, or by clicking outside the dialog
("light dismiss").
</p>
</dialog>html hidden
js hidden
js
const dialog = document.querySelector("dialog");
log(`closedBy: ${dialog.closedBy}`);Result
{{ EmbedLiveSample('Basic closedBy usage', '100%', '250px') }}
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- HTML {{htmlelement("dialog")}} element