Plot an item response distribution — sframe_plot_item

Draws how one item was answered, as the dashboard and SurveyStudio panels show it. It returns NULL where it has nothing to draw, so a caller can fall back to its own chart.

Usage

sframe_plot_item_chart(
  item,
  col_data,
  choice_set = NULL,
  palette = c("web", "print")
)

Arguments

item: A list with at least type and label (an sframe item).
col_data: The response column for this item.
choice_set: A list with values and labels (an sframe choice set), or NULL if the item has none.
palette: One of "web" or "print". See sframe_brand().

Value

A ggplot2 object, or NULL if this item type/data is unsupported.

Details

Shared by launch_dashboard() (inst/shiny/dashboard/app.R) and the SurveyStudio dashboard tab (inst/shiny/app.R), which otherwise duplicated this base-graphics chart. Callers fall back to their own base graphics when this returns NULL (ggplot2 not installed, unsupported item type, or no data), so the dashboard keeps working without ggplot2.

Examples

# \donttest{
if (requireNamespace("ggplot2", quietly = TRUE)) {
  demo <- sframe_demo_data()
  item <- Filter(function(i) i$id == "sat_1", demo$instrument$items)[[1]]
  cs   <- Filter(function(c) c$id == item$choice_set, demo$instrument$choices)[[1]]
  sframe_plot_item_chart(item, demo$responses$sat_1, cs)
}

# }