Saving HTML Reports & Documents

In dtsmartr: Interactive Virtualized Data Explorer Grid Widget

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>"
)

dtsmartr supports exporting your interactive grid sessions as offline-capable standalone HTML files, as well as embedding them seamlessly inside R Markdown (.Rmd) and Quarto (.qmd) dynamic reports.

---

1. Standalone HTML Reports (save_dtsmartr)

Export any data frame as a standalone web app using the save_dtsmartr() function:

library(dtsmartr)

# Export as a self-contained portable HTML file
save_dtsmartr(
  data = mtcars, 
  file = "reports/mtcars_dashboard.html"
)

The resulting file runs offline in any browser without needing R, Shiny, or a network connection.

Self-Contained vs. Lightweight Output Modes

• selfcontained = TRUE (Default): Combines all React code, styling assets, and data base64 streams directly into a single .html file. Requires Pandoc to compile.
• selfcontained = FALSE: Recommended for large datasets or environments without Pandoc. It saves a lightweight .html file alongside a <file>_files/ companion directory containing the shared javascript and style sheets.

---

2. R Markdown (.Rmd) Document Integration

You can render dtsmartr interactive grids inline in any R Markdown HTML document.

Simply place the function inside standard code chunks. Set R Markdown chunk options (like echo = FALSE or message = FALSE) to suppress code display and warnings:

---
title: "Clinical Analysis Report"
output: html_document
---

Below is the interactive labs analysis grid:

```r
library(dtsmartr)
dtsmartr(mtcars)
```

When you knit the document, R Markdown compiles the widget as an interactive grid directly inline with your text.

---

3. Quarto (.qmd) Document Integration

Quarto supports dtsmartr natively out of the box. Add the code chunk using Quarto's standard syntax and comments:

---
title: "Study Cohort Review"
format: html
---

## Laboratory Panel Exploration

Explore the interactive subject database:

```r
#| echo: false
#| message: false
#| warning: false

library(dtsmartr)
dtsmartr(mtcars)
```

When Quarto renders to HTML (quarto render report.qmd), the widget embeds inside the page container.

---

4. Downloadable Sample HTML Reports

To see what standalone HTML reports generated by save_dtsmartr() look and behave like offline, you can download these pre-compiled samples:

1. 🚗 Download mtcars Sample HTML Report (mtcars_report.html) (Lightweight, self-contained single file)
2. 🔬 Download Double-Sized ADLB Performance Report (adlb_large_report.zip) (Heavy clinical dataset: 167,304 rows × 115 columns, packaged as a ZIP containing the HTML and its assets folder for optimal load performance)

Simply download, unzip (for the large report), open the .html file locally in any modern web browser, and test all scrolling, column anchoring, and reordering features offline!

---

5. Live Embedded Integration Preview

Here is an actual live rendering of dtsmartr embedded inside the R Markdown page container of this article, showing how it looks inside your generated reports:

library(dtsmartr)
dtsmartr(mtcars)

dtsmartr documentation built on July 16, 2026, 5:08 p.m.