Title:	Interactive 'ggplot2' Visualization Blocks
Version:	0.1.0
Description:	Extends 'blockr.core' with interactive blocks for data visualization using 'ggplot2'. Users can build charts through a graphical interface without writing code directly. Includes common chart types (bar charts, line charts, pie charts, scatter plots) as well as statistical plots (boxplots, histograms, density plots, violin plots) with rich customization options and intuitive user interfaces.
URL:	https://bristolmyerssquibb.github.io/blockr.ggplot/
BugReports:	https://github.com/BristolMyersSquibb/blockr.ggplot/issues
License:	GPL (≥ 3)
Depends:	R (≥ 4.1.0)
Encoding:	UTF-8
RoxygenNote:	7.3.3
Imports:	blockr.core (≥ 0.1.1), colourpicker, ggplot2, glue, patchwork, shiny, shinyjs, shinyWidgets
Suggests:	cowplot, ggpubr, ggthemes, knitr, pkgdown, rmarkdown, rlang, shinytest2, testthat (≥ 3.0.0)
VignetteBuilder:	knitr
Config/testthat/edition:	3
Config/testthat/parallel:	true
NeedsCompilation:	no
Packaged:	2025-12-12 16:24:11 UTC; christophsax
Author:	Christoph Sax [aut, cre], Nicolas Bennett [aut], David Granjon [aut], Mike Page [aut], Bristol Myers Squibb [fnd]
Maintainer:	Christoph Sax <christoph@cynkra.com>
Repository:	CRAN
Date/Publication:	2025-12-18 14:10:15 UTC

blockr.ggplot: Interactive 'ggplot2' Visualization Blocks

Description

Extends 'blockr.core' with interactive blocks for data visualization using 'ggplot2'. Users can build charts through a graphical interface without writing code directly. Includes common chart types (bar charts, line charts, pie charts, scatter plots) as well as statistical plots (boxplots, histograms, density plots, violin plots) with rich customization options and intuitive user interfaces.

Author(s)

Maintainer: Christoph Sax christoph@cynkra.com (ORCID)

Authors:

• Nicolas Bennett nicolas@cynkra.com

• David Granjon david@cynkra.com

• Mike Page mike@cynkra.com

Other contributors:

• Bristol Myers Squibb [funder]

See Also

Useful links:

• https://bristolmyerssquibb.github.io/blockr.ggplot/

• Report bugs at https://github.com/BristolMyersSquibb/blockr.ggplot/issues

Generate container query script for responsive blocks

Description

Sets up container queries if supported by the browser.

Usage

block_container_script()

Value

HTML script tag

Generate responsive CSS for blockr blocks

Description

Creates CSS for responsive grid layout using 'block-' prefix. Can be reused across different blockr packages.

Usage

block_responsive_css()

Value

HTML style tag with responsive CSS

Build theme choices list based on available packages

Description

Build theme choices list based on available packages

Usage

build_theme_choices()

Value

A named list of theme choices for selectInput

Get theme function call for a given theme name

Description

Maps theme names to their corresponding ggplot2 function calls. Returns a fallback theme if the requested theme's package is not available.

Usage

get_theme_function(theme_name)

Arguments

Value

Character string with the theme function call

Facet Block

Description

Applies faceting to a ggplot object using facet_wrap() or facet_grid(). Accepts a single ggplot input and adds faceting based on data columns.

Usage

new_facet_block(
  facet_type = "wrap",
  facets = character(),
  rows = character(),
  cols = character(),
  ncol = character(),
  nrow = character(),
  scales = "fixed",
  labeller = "label_value",
  dir = "h",
  space = "fixed",
  ...
)

Arguments

Value

A ggplot transform block object of class facet_block.

Examples

# Create a facet wrap block
new_facet_block(facet_type = "wrap", facets = "cyl")

# Create a facet grid block
new_facet_block(facet_type = "grid", rows = "cyl", cols = "gear")

if (interactive()) {
  library(blockr.core)
  # Facet block requires a ggplot input
  serve(new_facet_block())
}

Universal ggplot block with selectable visualization types

Description

A flexible block that allows users to select from various ggplot2 geoms and dynamically shows relevant aesthetics for the selected visualization.

Usage

new_ggplot_block(
  type = "point",
  x = character(),
  y = character(),
  color = character(),
  fill = character(),
  size = character(),
  shape = character(),
  linetype = character(),
  group = character(),
  alpha = character(),
  density_alpha = 0.8,
  position = "stack",
  bins = 30,
  donut = FALSE,
  ...
)

Arguments

Value

A plot block object of class ggplot_block.

Examples

# Create a scatter plot block
new_ggplot_block(type = "point", x = "mpg", y = "hp")

# Create a bar chart block
new_ggplot_block(type = "bar", x = "cyl")

if (interactive()) {
  library(blockr.core)
  serve(new_ggplot_block(), list(data = mtcars))
}

ggplot transform block constructor

Description

Creates a specialized block for ggplot2-based visualizations. This block returns ggplot objects as data, allowing ggplot blocks to be chained together (e.g., for combining plots with patchwork). Custom output methods ensure plots are displayed properly rather than as data tables.

Usage

new_ggplot_transform_block(server, ui, class, ctor = sys.parent(), ...)

Arguments

Value

A ggplot_transform_block object

Examples

# This is a low-level constructor typically used by other block creators
# See new_ggplot_block() for user-facing examples

Grid Block

Description

Combines multiple ggplot objects using patchwork::wrap_plots(). Variadic block that accepts 1 or more ggplot inputs with automatic alignment. Supports layout control (ncol, nrow) and annotations (title, subtitle, auto-tags).

Usage

new_grid_block(
  ncol = character(),
  nrow = character(),
  title = character(),
  subtitle = character(),
  caption = character(),
  tag_levels = character(),
  guides = "auto",
  ...
)

Arguments

Value

A ggplot transform block object of class grid_block.

Examples

# Create a grid block with 2 columns
new_grid_block(ncol = "2")

# Create a grid block with title
new_grid_block(title = "My Combined Plots", ncol = "2")

if (interactive()) {
  library(blockr.core)
  # Grid block requires multiple ggplot inputs
  serve(new_grid_block())
}

Theme customization block for ggplot2 plots

Description

A block that applies advanced theme customizations to ggplot2 objects. Allows fine-grained control over backgrounds, fonts, grid lines, and more. Empty/NULL values will use the base theme's defaults.

Usage

new_theme_block(
  panel_bg = "",
  plot_bg = "",
  base_size = NA_real_,
  base_family = "auto",
  show_major_grid = "auto",
  show_minor_grid = "auto",
  grid_color = "",
  show_panel_border = "auto",
  legend_position = "auto",
  base_theme = "auto",
  palette_fill = "auto",
  palette_colour = "auto",
  ...
)

Arguments

Value

A ggplot transform block object of class theme_block.

Examples

# Create a theme block with classic theme
new_theme_block(base_theme = "classic")

# Create a theme block with custom settings
new_theme_block(
  base_theme = "minimal",
  legend_position = "bottom",
  base_size = 14
)

if (interactive()) {
  library(blockr.core)
  # Theme block requires a ggplot input
  serve(new_theme_block())
}