Popup control
The Popup control pins where a clicked feature's popup docks on the map.
What it does
The map's feature popup normally floats next to the clicked feature. Placing the
Popup control instead docks the popup in the chosen map corner, so every
popup opens in the same, predictable spot. It maps the placement's corner to the
ArcGIS popup dockOptions.position,
with the dock button and responsive breakpoint disabled so the position is
deterministic.
Unlike the other controls it does not render a widget on the map — it only configures the popup's docking behavior.
Configuration
| Field | Type | Default | Purpose |
|---|---|---|---|
controls.popup | ControlPlacement | null | null | Corner the popup docks in, or null. |
A null placement leaves the popup floating next to the feature (the default).
Only the placement's corner is used; the dock position ignores inExpand.
Relationship to "Show feature popup"
The Show feature popup toggle (popupEnabled) controls whether a popup
appears at all when a feature is clicked. The Popup control only controls where
it docks once it appears:
- Show feature popup off — no popup opens, so the dock placement has no effect. The config panel shows a hint to turn the toggle on.
- Show feature popup on, Popup unplaced — the popup floats next to the feature (default behavior).
- Show feature popup on, Popup placed — the popup docks in the chosen corner.
In the config panel
Open Appearance → UI controls and drag the Popup chip onto a corner. A note appears confirming the dock corner (and reminds you to enable Show feature popup if it is off). Drag the chip back to the tray to restore the default floating popup.
Behavior
- The dock position is applied to the live view, so changing it updates without reloading the map.
- The four corners map directly to the popup dock positions
top-left,top-right,bottom-left, andbottom-right.