hd_set_theme: Set Package-Wide Style Defaults

In highdir: Unified Data Visualization Framework for Dynamic and Static Graphics

Set Package-Wide Style Defaults

Description

Configures the default theme, colour palette, font, and optional JavaScript plugins for all figures produced with hd_make() in the current R session. Call once at the top of a script or in .Rprofile.

Usage

hd_set_theme(
  hc_theme = NULL,
  gg_theme = NULL,
  colors = NULL,
  font = NULL,
  js_plugins = NULL
)

Arguments

hc_theme	Character or NULL. Built-in highcharter theme name: one of "default", "smpl", "economist", "darkunica", "gridlight", "bloom", "flat", "flatdark", "ggplot2".
gg_theme	Character, ggplot2 theme object, or NULL. Controls the ggplot2 backend appearance. Built-in name strings: "minimal" (default), "classic", "bw", "light", "dark", "void", "grey". Alternatively pass any ⁠ggplot2::theme_*()⁠ object directly for full control, e.g. ggplot2::theme_bw(base_size = 14).
colors	Character vector, palette name, or NULL. Applied to all figures in the session. See register_palette().
font	Character or NULL. Font family name, e.g. "Source Sans Pro".
js_plugins	Character vector or NULL. Names of bundled JS plugins (files in ⁠inst/js/⁠) injected into every highcharter figure. Use character(0) to clear all plugins.

Details

Per-figure overrides are provided via hd_opts(), which always take precedence over these session defaults.

Value

The previous option values invisibly; pass to options() to restore.

See Also

hd_opts() for per-figure overrides

Examples

hd_set_theme(hc_theme = "economist", gg_theme = "classic",
             colors   = c("#025169", "#7C145C", "#C68803"))
# Reset
hd_set_theme(hc_theme = "default", gg_theme = "minimal", colors = "hdir")
hd_reset_theme()

highdir documentation built on July 31, 2026, 5:06 p.m.