Skip to contents

HTML-specific styles and options

Source: R/theme_html.R
theme_html.Rd

HTML-specific styles and options

Usage

theme_html(
  x,
  engine = get_option("tinytable_html_engine", default = NULL),
  i = NULL,
  j = NULL,
  class = get_option("tinytable_html_class", default = NULL),
  css = get_option("tinytable_html_css", default = NULL),
  css_rule = get_option("tinytable_html_css_rule", default = NULL),
  script = get_option("tinytable_html_script", default = NULL),
  portable = get_option("tinytable_html_portable"),
  tabulator_columns = get_option("tinytable_html_tabulator_columns"),
  tabulator_css_rule = get_option("tinytable_html_tabulator_css_rule"),
  tabulator_layout = get_option("tinytable_html_tabulator_layout", default =
    "fitDataTable"),
  tabulator_options = get_option("tinytable_html_tabulator_options"),
  tabulator_pagination = get_option("tinytable_html_tabulator_pagination"),
  tabulator_search = get_option("tinytable_html_tabulator_search"),
  tabulator_stylesheet = get_option("tinytable_html_tabulator_stylesheet"),
  ...
)

Arguments

x

A tinytable object.

engine

Character string specifying the HTML engine: "tinytable", "bootstrap", or "tabulator".

i

Row indices.

j

Column indices.

class

String. HTML table class.

css

Character vector. CSS style declarations.

css_rule

String. CSS rules to customize table styling. Can be one of:

  • Shortcut strings: "tinytable" (default) or "dark" for dark theme

  • A file path to a local CSS file (e.g., "custom.css" or "path/to/styles.css")

  • A URL to an external stylesheet (must start with http/https and end with .css)

  • Inline CSS content as a string

script

String. Custom JavaScript code or script tags to inject into the HTML output. Useful for loading external JavaScript libraries like Plotly, D3, etc.

portable

Logical. Sets whether to create portable HTML output with embedded Javascript, CSS, and base64-encoded images.

tabulator_columns

Custom column definitions.

tabulator_css_rule

Complete CSS rules.

tabulator_layout

Character string. Table layout algorithm for column sizing. Default is "fitDataTable". Available options: "fitDataTable", "fitData", "fitDataFill", "fitDataStretch", "fitColumns".

tabulator_options

Custom Tabulator.js configuration options.

tabulator_pagination

Logical or numeric vector. Pagination settings for large tables.

  • NULL (default): Preserves existing pagination settings, does not change previous configuration

  • FALSE: Explicitly disable pagination

  • TRUE: Enable pagination with automatic page sizes (10, 25, 50, 100, 250) filtered by row count

  • Numeric vector: First element is default page size, full vector provides page size options

Character or NULL. Search functionality position.

  • NULL (default): Preserves existing search settings, does not change previous configuration

  • "top": Adds search box above the table

  • "bottom": Adds search box below the table

  • "column": Adds header filters to each column for per-column searching

tabulator_stylesheet

Character string. CSS stylesheet theme for Tabulator.js tables. Default is "bootstrap5". Available options: "default", "simple", "midnight", "modern", "site", "site_dark", "bootstrap3", "bootstrap4", "bootstrap5", "semanticui", "bulma", "materialize", or a custom HTTP URL starting with "http".

...

Additional arguments are ignored.

Examples

if (FALSE) { # \dontrun{
# Load an external JavaScript library
library(tinytable)
x <- tt(mtcars[1:5, 1:5])
x <- theme_html(x, script = '<script src="https://cdn.plot.ly/plotly-2.27.0.min.js"></script>')

# Add custom inline JavaScript
x <- tt(mtcars[1:5, 1:5])
x <- theme_html(x, script = '<script>console.log("Table loaded");</script>')
} # }