Skip to contents

Entry verbs

Wrap a pre-summarised wide data frame into a tabular_spec.

tabular()
Start a tabular display
pivot_across()
Convert a cards ARD to a wide display data.frame

Spec building

Configure per-column display, header bands, sort order, and subgrouping. Each verb attaches one slot onto the spec and returns the updated spec for chaining.

cols()
Attach per-column specifications
cols_apply()
Apply one column spec to many columns
col_spec()
Per-column display specification
headers()
Attach multi-level column headers
sort_rows()
Sort the display rows
subgroup()
Partition the report by a variable

Styling

A single style() verb, paired with one of the cells_*() location helpers, drives every visual rule — body cells, headers, footnotes, page chrome, table edges. Build a reusable house style with style_template() and attach it to preset() so every downstream table inherits the look.

style()
Attach a style layer to a tabular_spec or style_template
cells_body() cells_headers() cells_group_headers() cells_title() cells_subgroup_labels() cells_footnotes() cells_pagehead() cells_pagefoot() cells_table() is_tabular_location()
Cell-location constructors for style()
style_template() is_style_template()
Reusable style template (for house-style presets)
brdr() is_brdr()
Border-line specification

Presets and theming

Page geometry and cosmetic defaults. preset() overrides per spec in the pipe; set_preset() sets a session default; preset_minimal() applies a stripped-down look.

preset()
Override the render preset on a spec
set_preset()
Set or clear the session default preset
get_preset()
Get the active session-default preset
preset_minimal()
Minimal theme: one header rule, normal weight throughout

Inline markup

Mark label and cell text as Markdown or HTML.

md()
Mark a string as Markdown for inline formatting
html()
Mark a string as HTML for inline formatting

Footnotes

Attach an auto-numbered footnote to any cells_*() location. The engine assigns the marker once, in reading order, deduped by id, and byte-identical across every backend and page.

footnote()
Attach an auto-numbered footnote to a table location

Pagination

Configure page splits, group-run protection, and horizontal panel layout for wide tables. Row budget per page is computed by the engine from the active preset and the spec’s chrome.

paginate()
Configure pagination

Rendering and inspection

Terminal verbs. emit() writes a file; as_grid() resolves the spec without I/O; check_fonts() and check_latex() audit font and LaTeX-package availability; the print and as.tags() methods drive the live HTML preview.

emit()
Render a tabular_spec to a file
as_grid()
Resolve a tabular_spec into a tabular_grid
check_fonts()
Check font availability across backends
check_latex()
Check LaTeX-package availability for PDF output
print.tabular_spec
Print a tabular_spec
as.tags(<tabular_spec>)
Convert a tabular_spec to an htmltools tagList

Predicates

Class predicates for tabular’s S7 objects.

Demo datasets

Pre-summarised wide-format tables and their upstream cards-format counterparts. Power every @examples block, every vignette, and every smoke test.

cdisc_eff_estimates
Treatment-effect estimates by model
cdisc_eff_n
Efficacy-population BigN per arm
cdisc_eff_resp
Best Overall Response and Response Rates
cdisc_saf_ae
Overall adverse-event summary, Safety Population
cdisc_saf_aesocpt
Adverse events by System Organ Class and Preferred Term
cdisc_saf_aesocpt_ard
Cards hierarchical ARD for AEs by SOC and PT
cdisc_saf_demo
Demographics summary, Safety Population
cdisc_saf_demo_ard
Cards ARD for demographics (flat ARD companion)
cdisc_saf_n
Safety-population BigN per arm
cdisc_saf_subgroup
Vital-signs subgroup summary by Sex, by Visit
cdisc_saf_vital
Vital-signs summary