Component 28 · Overlays
Dialog
Request a focused decision without leaving context.
Overview
Request a focused decision without leaving context. It raises contextual work above the current page and returns focus to the invoking control.
When to use
Use HE/Dialog when you need to request a focused decision without leaving context. Keep its role distinct from transport freshness, animal-health severity and model confidence.
Example
Start live session?
High-frequency telemetry will run for 15 minutes.
<div class="he-dialog" role="dialog" aria-labelledby="demo-dialog"><header><h3 id="demo-dialog">Start live session?</h3></header><p>High-frequency telemetry will run for 15 minutes.</p></div>Anatomy
1Invoker
2Labeled surface
3Content/actions
4Focus return
Anatomy stays identical in Pasture and Atlantic. A responsive layout may wrap or stack parts, but reading order and focus order remain equivalent.
Variants and states
Variants
States
Accessibility
Trap focus, label the dialog, support Escape unless unsafe, and return focus to the trigger.
- Maintain a visible keyboard focus indicator and a logical focus sequence.
- Never rely on colour alone for operational, freshness or severity state.
- Keep touch targets at least 44 × 44 px unless the target is an inline text link.
Cross-platform contract
| Surface | Canonical name | Status |
|---|---|---|
| Figma | HE/Dialog | stable |
| Web | .he-dialog | implemented |
| Flutter | HeDialog | implemented |
| Token root | component.dialog | generated |