dt2_theme: Create a reusable DT2 theme

In DT2: 'DataTables' 2.x for R

Create a reusable DT2 theme

Description

Creates a theme object that can be passed to dt2() via the theme parameter. Useful when you want the same look across many tables.

For quick one-off styling, you can also pass arguments directly to dt2() (e.g., dt2(iris, striped = FALSE)).

Usage

dt2_theme(
  preset = "default",
  striped = NULL,
  hover = NULL,
  compact = NULL,
  font_scale = NULL,
  style = NULL,
  button_class = NULL
)

Arguments

preset	A named preset to start from: "default", "clean", "minimal", or "compact". Remaining arguments override the preset.
striped	Logical; alternate row colours.
hover	Logical; highlight rows on hover.
compact	Logical; reduce cell padding.
font_scale	Numeric; font-size multiplier (e.g., 0.85 = 85%).
style	Styling framework: "bootstrap5" (default) or "core" (plain DataTables).
button_class	CSS class string for Buttons extension buttons. Default: "btn btn-sm btn-outline-secondary". See Bootstrap 5 button classes for options (e.g., "btn btn-sm btn-primary").

Value

A dt2_theme object (a named list).

Examples

# Create and reuse
my_theme <- dt2_theme("clean", compact = TRUE)

dt2(iris, theme = my_theme)
dt2(mtcars, theme = my_theme)


# Custom button style
dt2_theme("default", button_class = "btn btn-sm btn-primary")

# Presets
dt2_theme("minimal")
dt2_theme("compact")

DT2 documentation built on June 14, 2026, 9:06 a.m.