Add a Named Data Keyframe

Registers a named data state for sequential chart storytelling. A chart with one serialized layer accepts a data frame directly. Multi-layer charts use a named list of data frames keyed by existing layer labels; omitted layers retain their data from the previous keyframe.

Usage

addKeyframe(myIO, data, label)

Arguments

myIO

A widget created by myIO() with at least one layer.

data

A data frame for a single-layer chart, or a named list of data frames keyed by layer label for a multi-layer chart.

label

A unique, non-empty keyframe label.

Value

A modified myIO widget with the keyframe appended.

Examples

start <- data.frame(x = 1:3, y = c(2, 4, 3))
finish <- data.frame(x = 1:3, y = c(5, 3, 7))
myIO(start) |>
  addIoLayer("line", label = "series",
    mapping = list(x_var = "x", y_var = "y")) |>
  addKeyframe(start, "Start") |>
  addKeyframe(finish, "Finish")