Skip to contents

Initialise a chart.

Usage

e_charts(
  data,
  x,
  width = NULL,
  height = NULL,
  elementId = NULL,
  dispose = TRUE,
  draw = TRUE,
  renderer = "canvas",
  timeline = FALSE,
  ...,
  reorder = TRUE
)

# Default S3 method
e_charts(
  data,
  x,
  width = NULL,
  height = NULL,
  elementId = NULL,
  dispose = TRUE,
  draw = TRUE,
  renderer = "canvas",
  timeline = FALSE,
  ...,
  reorder = TRUE
)

# S3 method for class 'Node'
e_charts(
  data,
  x,
  width = NULL,
  height = NULL,
  elementId = NULL,
  dispose = TRUE,
  draw = TRUE,
  renderer = "canvas",
  timeline = FALSE,
  ...,
  reorder = TRUE
)

e_charts_(
  data,
  x = NULL,
  width = NULL,
  height = NULL,
  elementId = NULL,
  dispose = TRUE,
  draw = TRUE,
  renderer = "canvas",
  timeline = FALSE,
  ...,
  reorder = TRUE
)

e_chart(
  data,
  x,
  width = NULL,
  height = NULL,
  elementId = NULL,
  dispose = TRUE,
  draw = TRUE,
  renderer = "canvas",
  timeline = FALSE,
  ...,
  reorder = TRUE
)

e_data(e, data, x)

Arguments

data

A data.frame or a crosstalk SharedData object

x

Column name containing x axis.

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.

elementId

Id of element.

dispose

Set to TRUE to force redraw of chart, set to FALSE to update.

draw

Whether to draw the chart, intended to be used with e_draw_p.

renderer

Renderer, takes canvas (default) or svg.

timeline

Set to TRUE to build a timeline, see timeline section.

...

Any other argument.

reorder

Set to FALSE to not reorder numeric x axis values.

e

An object of class echarts4r as returned by e_charts.

Details

The chart is created inside a parent '<div>' element, the dimensions of which are controlled by the 'width' and 'height' arguments. When these dimensions are small, it is possible that the chart 'grid' resizes to a size larger than the parent, which might result in unexpected size given the input arguments. To disable this automatic readjustment, define a static e_grid like the following: 'e_grid(e = current_chart, top = 0, left = 20, right = 0, bottom = 20)'.

Crosstalk

TO use crosstalk, pass selectedMode = TRUE) into the chart type argument. crosstalk functionality currently supports the following chart types (but only cartesion2d):

Examples

mtcars |>
  e_charts(qsec) |>
  e_line(mpg)
sd <- crosstalk::SharedData$new(mtcars) mtcars |> e_charts(qsec) |> e_line(mpg, selectedMode = TRUE)
points <- mtcars[1:3, ] mtcars |> e_charts_("qsec") |> e_line(mpg) |> e_data(points, qsec) |> e_scatter(mpg, color = "red", symbol_size = 20)