Documentation
Asgard
Getting started
Theming
Guides
Inputs & forms
Pickers
Data display
Layout & docking
Feedback & overlays
Navigation & chrome
Feedback & overlays
A draggable, dismissible window.
A draggable and resizable floating window that behaves like a desktop-style dialog or tool window.
Key features:
- Modal (backdrop + centered) and non-modal modes
draggabletitle bar andresizableedges/corners- Configurable
minWidth/minHeightconstraints - Close via button, escape key, or backdrop click
Loading preview…
When to use it
- Property inspectors
- Tool palettes
- Modeless and modal dialogs
- Resizable, draggable panels
Properties
| Prop | Type | Default | Description |
|---|---|---|---|
title | string | — | Text displayed in the window title bar, which also serves as the drag handle. |
isOpen | boolean | — | Controls whether the floating window is currently visible. |
onClose | () => void | — | Callback invoked when the window is closed via the close button or escape key. |
modal | boolean | — | When true, adds a backdrop overlay and centers the window, preventing interaction with underlying content. |
draggable | boolean | — | Enables dragging the window by its title bar to reposition it freely on screen. |
resizable | boolean | — | Enables resizing the window by dragging its edges or corners. |
width | number | string | — | Initial width of the window in pixels or as a CSS string value. |
height | number | string | — | Initial height of the window in pixels or as a CSS string value. |
Notes
- Modal mode adds a backdrop overlay and centers the window, blocking interaction with content behind it.
- The floating position allows the window to be freely dragged from its initial coordinates, while center always starts centered on screen.
- Use minWidth and minHeight to set lower bounds when resizable is enabled, preventing the window from becoming too small.
Presets