ggplot2_theme: Apply common theme to ggplot2 chart

In salim-b/salim: A Wild Mix of Functions Serving Various Purposes

Apply common theme to ggplot2 chart

Description

Applies common theming to a ggplot2 chart. It's based on ggplot2::theme_minimal().

Usage

ggplot2_theme(
  base_size = 11L,
  base_family = pal::pkg_config_val("font_family_body"),
  base_line_size = base_size/22L,
  base_rect_size = base_size/22L,
  axis.title.x = ggplot2::element_text(margin = ggplot2::margin(t = 20L, r = 0L, b = 0L,
    l = 0L), inherit.blank = TRUE),
  axis.title.y = ggplot2::element_text(margin = ggplot2::margin(t = 0L, r = 20L, b = 0L,
    l = 0L), inherit.blank = TRUE),
  axis.text = ggplot2::element_text(color = "#000", inherit.blank = TRUE),
  legend.box.margin = ggplot2::margin(),
  legend.box.spacing = ggplot2::element_blank(),
  legend.margin = ggplot2::margin(),
  legend.position = "bottom",
  legend.spacing = grid::unit(x = 0, units = "npc"),
  plot.margin = ggplot2::margin(),
  ...
)

Arguments

base_size	base font size, given in pts.
base_family	base font family
base_line_size	base size for line elements
base_rect_size	base size for rect elements
axis.title.x, axis.title.y	Labels of axes (ggplot2::element_text()). Specify all axes' labels (axis.title), labels by plane (using axis.title.x or axis.title.y), or individually for each axis (using axis.title.x.bottom, axis.title.x.top, axis.title.y.left, axis.title.y.right). ⁠axis.title.*.*⁠ inherits from ⁠axis.title.*⁠ which inherits from axis.title, which in turn inherits from text.
axis.text	Tick labels along axes (ggplot2::element_text()). Specify all axis tick labels (axis.text), tick labels by plane (using axis.text.x or axis.text.y), or individually for each axis (using axis.text.x.bottom, axis.text.x.top, axis.text.y.left, axis.text.y.right). ⁠axis.text.*.*⁠ inherits from ⁠axis.text.*⁠ which inherits from axis.text, which in turn inherits from text.
legend.box.margin	margins around the full legend area, as specified using margin()
legend.box.spacing	The spacing between the plotting area and the legend box (unit)
legend.margin	the margin around each legend (margin())
legend.position	the default position of legends ("none", "left", "right", "bottom", "top", "inside")
legend.spacing	Spacing between legends (unit). legend.spacing.x & legend.spacing.y inherit from legend.spacing or can be specified separately.
plot.margin	margin around entire plot (unit with the sizes of the top, right, bottom, and left margins)
...	Further arguments passed on to ggplot2::theme().

Value

An object of class theme.

See Also

Other plot theming functions: ggplot2_geom_defaults(), ggplot2_theme_html(), plotly_layout()

Examples

sysfonts::font_add_google(name = "Alegreya Sans")
showtext::showtext_auto()

ggplot2::ggplot(data = mtcars,
                mapping = ggplot2::aes(x = mpg,
                                       y = cyl)) +
  ggplot2::geom_point() +
  salim::ggplot2_theme(base_size = 12)

salim-b/salim documentation built on Dec. 16, 2024, 11 a.m.