From f8730b451b37940432ea4203fa78a0454e3efee6 Mon Sep 17 00:00:00 2001 From: Chris Mills Date: Tue, 23 Jan 2024 15:49:46 +0000 Subject: [PATCH] Fix incorrect statement about dialog top-layer placement (#31866) --- files/en-us/web/api/popover_api/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/api/popover_api/index.md b/files/en-us/web/api/popover_api/index.md index 628106bad8843a1..caa3d354d415964 100644 --- a/files/en-us/web/api/popover_api/index.md +++ b/files/en-us/web/api/popover_api/index.md @@ -16,7 +16,7 @@ A very common pattern on the web is to show content over the top of other conten - **modal**, meaning that while a popover is being shown, the rest of the page is rendered non-interactive until the popover is actioned in some way (for example an important choice is made). - **non-modal**, meaning that the rest of the page can be interacted with while the popover is being shown. -Popovers which are created using the popover API are always non-modal. If you want to create a modal popover, a {{htmlelement("dialog")}} element is the right way to go, although bear in mind that `` elements are not put in the {{glossary("top layer")}} by default — popovers are. There is significant overlap between the two — you might for example want to create a popover that persists, but control it using declarative HTML. You can even turn a `` element into a popover if you want to combine popover control and top level placement with dialog semantics. +Popovers created using the Popover API are always non-modal. If you want to create a modal popover, a {{htmlelement("dialog")}} element is the right way to go. There is significant overlap between the two — you might for example want to create a popover that persists, but control it using declarative HTML. You can turn a `` element into a popover (`` is perfectly valid) if you want to combine popover control with dialog semantics. Typical use cases for the popover API include user-interactive elements like action menus, custom "toast" notifications, form element suggestions, content pickers, or teaching UI.