Control interactive plot point events — clickOpts

v1.7.3|Source: R/image-interact-opts.R


These functions give control over the click, dblClick and hover events generated by imageOutput() and plotOutput().

clickOpts(id, clip = TRUE)

dblclickOpts(id, clip = TRUE, delay = 400)

  delay = 300,
  delayType = c("debounce", "throttle"),
  clip = TRUE,
  nullOutside = TRUE



Input value name. For example, if the value is "plot_click", then the event data will be available as input$plot_click.


Should the click area be clipped to the plotting area? If FALSE, then the server will receive click events even when the mouse is outside the plotting area, as long as it is still inside the image.


For dblClickOpts(): the maximum delay (in ms) between a pair clicks for them to be counted as a double-click.

For hoverOpts(): how long to delay (in ms) when debouncing or throttling before sending the mouse location to the server.


The type of algorithm for limiting the number of hover events. Use "throttle" to limit the number of hover events to one every delay milliseconds. Use "debounce" to suspend events while the cursor is moving, and wait until the cursor has been at rest for delay milliseconds before sending an event.


If TRUE (the default), the value will be set to NULL when the mouse exits the plotting area. If FALSE, the value will stop changing when the cursor exits the plotting area.

See also

brushOpts() for brushing events.