Q. Do I need to import QWindow CSS myself?
The App Extension adds the stylesheet for you.
If you install the UI package directly, import the stylesheet in your boot file or app entry:
import '@quasar/quasar-ui-qwindow/dist/index.css'Quasar CLI projects can also centralize the stylesheet in quasar.config.ts:
// Note: using ~ tells Quasar the file resides in node_modules
css: [
"app.scss",
"~@quasar/quasar-ui-qwindow/dist/index.css",
],Q. Can I inspect the component API from the Quasar CLI?
Yes. After the App Extension is installed, run:
quasar describe QWindowThe same generated API is shown on the Using QWindow page.
Q. When should I use QWindow instead of QDialog?
Use QWindow when the user should be able to keep a panel open, move it around, resize it, or work with multiple panels at once. Use QDialog for focused modal decisions and short blocking flows.
Q. Does QWindow support embedded content?
Yes. QWindow can behave as an embedded panel or a floating panel. Floating mode uses Vue 3 Teleport so the rendered panel can live inside Quasar’s app root while the component stays where you declared it.
Q. Should start positions include the page scroll offset?
It depends on the positioning mode.
By default, floating QWindow instances are viewport-relative. Treat start-x and start-y like coordinates inside the visible browser viewport, and do not add window.scrollX or window.scrollY when calculating those values.
When scroll-with-window is enabled, QWindow is document-relative. Use this mode when a helper window should stay connected to page content as the user scrolls. If you calculate the start position from an element’s getBoundingClientRect(), add the current scroll offset in this mode.
If a floating window only appears after scrolling, update to a current QWindow version. Current versions initialize the scroll position before the first visible placement.
Q. Is QWindow SSR-safe?
The v3 component guards browser-only drag, resize, scroll, and Teleport setup so server rendering does not touch window or document. Floating windows target #q-app when it is available and fall back to body in non-standard hosts.