Let’s take one interactive feature apart so the markup and behavior make sense separately.
What You Need to Know
Choose details for information expanded in place, popover for temporary nonmodal content, and dialog when a task needs a separate focused window. They are not interchangeable simply because each can reveal hidden content.
In this example: compare a tooltip-like popup, FAQ, and modal.
Try the Example
Take a look at the example. We’ll explain the important lines right below it.
<details>
<summary>Read this answer</summary>
<p>Use details for an ordinary expandable answer.</p>
</details>
<button type="button" popovertarget="quick-tip">Quick tip</button>
<div id="quick-tip" popover>Use popover for a small nonmodal overlay.</div>
<dialog id="important-dialog"><p>Use dialog for a separate task or conversation.</p></dialog>Let’s Read the Code
- popover: Popover lets supported browsers manage showing and hiding a small overlay.
- <details>: Details makes a section expandable without requiring a custom script.
- <summary>: Summary is the label people activate to expand or collapse details.
- type: Type changes what sort of control or resource the browser uses.
What the example shows: Details expands inline, popover overlays content without creating a modal task, and dialog is for more involved interactions.
What Happens in the Browser?
When this example includes JavaScript, it supplies behavior that ordinary HTML does not automatically provide. Always think about a fallback.
Start with native behavior. Details, dialog, and popover each solve a different interface problem. Choose the simplest control that actually matches what a visitor wants to do, then test focus and dismissal as well as appearance.
Your Turn
Decide which of the three is appropriate for an FAQ answer, a small tip, and confirmation of deletion.
Common Beginner Mistakes
- Assuming new HTML syntax works in every browser without testing.
- Do not pick dialog just because an element is hidden at first.
Key Takeaways
- Choose details for information expanded in place, popover for temporary nonmodal content, and dialog when a task needs a separate focused window.
- popover: Popover lets supported browsers manage showing and hiding a small overlay.
- Test the behavior you expect rather than trusting how the snippet looks in your editor.