Skip to content

Interface: HoverQuery ​

Experimental

A hover query in one subplot. x/y modes ask for the points at the pointer's x (or y) — the runtime builds unified labels (x unified, y unified) from those results.

Domain traces (M2 wave 1) have no subplot: for them the viewport is the overlay, so px/py are figure px from the bottom-left corner, xl/yl equal px/py (identity transform), and mode is always closest (Plotly shows one pie label whatever hovermode says).

Properties ​

PropertyModifierTypeDescription
cx?readonlynumberExperimental Pointer in container CSS px, top-left origin (M2 wave 1): the same space as DomainInfo.rect. Always set by the runtime; optional for hand-built queries.
cy?readonlynumberExperimental
distancereadonlynumberExperimental Max distance in px (layout.hoverdistance); Infinity for no limit.
modereadonly"x" | "y" | "closest"Experimental
pxreadonlynumberExperimental Pointer in viewport px (bottom-left origin, same space as the transform's output).
pyreadonlynumberExperimental
xlreadonlynumberExperimental Pointer in the trace's linear coordinates.
ylreadonlynumberExperimental

Released under the MIT License.