Package 'gradientPickerD3'

Title: Interactive Color Gradient Picker Using 'htmlwidgets' and the Modified JS Script 'jquery-gradient-picker'
Description: Widget for an interactive selection and modification of a color gradient. 'gradientPickerD3' allows addition, removement and replacement of color ticks. List of numeric values will automatically translate in their corresponding tick position within the numeric range. App returns a data.frame containing tick values, colors and the positions in percent (0.0 to 1.0) for each color tick in the gradient. The original JS 'jquery-gradient-picker' was implemented by Matt Crinklaw-Vogt (nick: tantaman) <https://github.com/tantaman/>. Widget and JS modifications were done by CD. Peikert.
Authors: Christian D. Peikert [aut, cre]
Maintainer: Christian D. Peikert <[email protected]>
License: GPL-3
Version: 0.1.0.0
Built: 2025-03-24 18:22:45 UTC
Source: https://github.com/cranhaven/cranhaven.r-universe.dev

Help Index


gradientPickerD3

Description

Creates a widget for an interactive selection and modification of a color gradient. gradientPickerD3 allows the addition, removement and replacement of color ticks. List of numeric values will automatically translate in its corresponding tick position within the numeric range. App returns a R data.frame containing tick values, colors and the positions in percent (0.0 to 1.0) for each color tick in the gradient. The original JS 'jquery-gradient-picker' was implemented by Matt Crinklaw-Vogt. Widget and JS modifications were done by CD. Peikert.

Usage

gradientPickerD3(payload, width = NULL, height = NULL, elementId = NULL,
  border_extensions = 0.001, decimal_places = 8)

Arguments

payload

list containing 'ticks' and 'colors' to initialize the gradient. Ticks have to been numerical and in a logical order. Colors can be provided as R colors or HEX format.

width, height

must be a valid CSS unit (like '100%')

elementId

string id as a valid CSS element id

border_extensions

add to the min and max data range to cover the whole color spectrum

decimal_places

number of decimal places

Source

The interface was designed based on jquery-gradient-picker https://github.com/tantaman/jquery-gradient-picker, htmlwidgets and shiny

See Also

gradientPickerD3_example

Examples

ticks <- c(-1.8740103,  -0.0040747,  1.4022244,  2.2177949,  3.2116766)
payload <- list(
  colors=c("purple","blue", "green", "yellow", "red"),
  ticks=ticks
)
gradientPickerD3(payload)

gradientPickerD3_example

Description

Creates an example shiny app which include the gradientPickerD3 and a rendered table for gradientPickerD3 return value. By clicking the reload button new random ticks will be generated.

Usage

gradientPickerD3_example()

Shiny bindings for gradientPickerD3

Description

Output and render functions for using gradientPickerD3 within Shiny applications and interactive Rmd documents.

Usage

gradientPickerD3Output(outputId, width = "100%", height = "100%")

renderGradientPickerD3(expr, env = parent.frame(), quoted = FALSE)

Arguments

outputId

output variable to read from

width, height

Must be a valid CSS unit (like '100%', '400px', 'auto') or a number, which will be coerced to a string and have 'px' appended.

expr

An expression that generates a gradientPickerD3

env

The environment in which to evaluate expr.

quoted

Is expr a quoted expression (with quote())? This is useful if you want to save an expression in a variable.