popup
element popup: surface
Anchored to its parent element; nests (tray menus).
It mounts its children only while shown.
Also every prop and event of surface.
| Prop | Type | |
|---|---|---|
trigger | PopupTrigger | What opens it: open (the default), its open: prop; hover, the pointer. A trigger: hover popup opens while the pointer is on the element it is anchored to (after delay), stays open while the pointer is on that element or on the popup (popups opened from it too), and 200 ms more to cross the gap, or while a drag that started in it goes on. It never takes the keyboard, and opening one closes the other trigger: hover popup open from the same surface. Its open: (never two-way) opens it from code and holds it open while true; then the pointer holds it as usual. |
delay | duration | How long the pointer rests on the element before a trigger: hover popup opens. At once by default. |
grace | duration | How long a trigger: hover popup stays open after the pointer leaves both it and its element, to cross the gap. 200 ms by default. |
anchor | Anchor | PopupAnchor | Where it opens: below the element it is anchored to (the default; a submenu beside its row, on the side left, right, top or bottom names), or pointer, where the press on its element that opened it went down: a context menu at the click, down and to the right of it, kept inside the screen. Opened with no press (a key, a timer, a hover) it opens at its element; a later press on its element that leaves it open moves it there. |
| Event | |
|---|---|
on dismiss | Escape or a click away closed it. |