R/guide_colourbar_interactive.R

Defines functions guide_colourbar_interactive

Documented in guide_colourbar_interactive

#' @title Create interactive continuous colour bar guide
#' @description
#' The guide is based on [guide_colourbar()].
#' See the documentation for that function for more details.
#'
#' @param ... arguments passed to base function.
#' @return An interactive guide object.
#' @inheritSection interactive_parameters Details for interactive scale and interactive guide functions
#' @examples
#' # add interactive colourbar guide to a ggplot -------
#' @example examples/scale_gradient_guide_colourbar_interactive.R
#' @seealso [interactive_parameters], [girafe()]
#' @export
guide_colourbar_interactive <- function(...) {
  guide_interactive(guide_colourbar, ...)
}

#' @export
#' @rdname guide_colourbar_interactive
guide_colorbar_interactive <- guide_colourbar_interactive

#' @rdname ggiraph-ggproto
#' @format NULL
#' @usage NULL
#' @export
GuideInteractiveColourbar <- ggproto(
  "GuideInteractiveColourbar", GuideColourbar,
  train = function(self, params = self$params, scale, aesthetic = NULL, ...) {
    parent <- ggproto_parent(GuideColourbar, self)
    params <- parent$train(params = params, scale = scale, aesthetic = aesthetic, ...)
    if (!is.null(params) && is.data.frame(params$key) && nrow(params$key)) {
      breaks <- Filter(is.finite, scale$get_breaks())
      label_breaks <- breaks
      if (isTRUE(params$raster)) {
        breaks <- 1
      } else {
        breaks <- params$decor$value
      }
      params <- interactive_guide_train(params, scale, breaks, label_breaks = label_breaks)
    }
    params
  },
  override_elements = function(params, elements, theme) {
    elements <- GuideColourbar$override_elements(params, elements, theme)
    interactive_guide_override_elements(elements)
  },
  build_decor = function(decor, grobs, elements, params) {
    result <- GuideColourbar$build_decor(decor, grobs, elements, params)
    ipar <- get_ipar(params)
    idata <- get_interactive_data(params)
    if (length(idata)) {
      result$bar <- add_interactive_attrs(result$bar,
        idata,
        data_attr = "key-id",
        ipar = ipar
      )
    }
    result
  }
)
davidgohel/ggiraph documentation built on April 13, 2024, 7:19 a.m.