Package {ViewR}

ViewR: Advanced Interactive Data Tables and Data Explorer

Description

An advanced, interactive data table and data explorer for R, delivered as a modern, self-contained 'htmlwidget' with a high-performance virtualized grid. ViewR renders 'Kaggle'-style micro-dashboard column headers complete with data-type badges, mini distribution spark-histograms, and data-completeness (missingness) bars. It provides hover metadata cards, a sliding Data Insights drawer with interactive histograms and 'Pareto' category charts, a multi-condition visual query builder (AND/OR), a column visibility picker, and a reproducible code generator that emits 'dplyr', base R, and 'SQL' that matches the active filter and column state. The interface is implemented entirely in dependency-free vanilla 'JavaScript' (no 'React' or build toolchain) and works in the 'RStudio'/'Positron' Viewer, inside 'Shiny' apps, in 'R Markdown'/'Quarto', or as a portable standalone 'HTML' file. A single call to viewr() opens the explorer; the legacy 'Shiny'-gadget ViewR() editor remains available.

Author(s)

Maintainer: Mahesh Divakaran imaheshdivakaran@gmail.com

Authors:

• Mahesh Divakaran imaheshdivakaran@gmail.com

See Also

Useful links:

• https://github.com/itsmdivakaran/viewR

• https://itsmdivakaran.github.io/viewR/

• Report bugs at https://github.com/itsmdivakaran/viewR/issues

ViewR: Interactive Data Viewer, Filter, and Editor

Description

Opens a feature-rich, popup-based Shiny interface for viewing, exploring, filtering, sorting, editing, and analysing R data frames. All operations are reflected in real-time as copy-pasteable dplyr code.

Usage

ViewR(
  data,
  edit = FALSE,
  popup = TRUE,
  labels = NULL,
  title = NULL,
  viewer = c("dialog", "browser", "pane"),
  generate_code = TRUE,
  theme = c("flatly", "cerulean", "cosmo", "darkly", "lumen", "paper", "readable",
    "sandstone", "simplex", "spacelab", "united", "yeti"),
  max_display = 50000L,
  return_data = TRUE,
  ...
)

Arguments

Value

If return_data = TRUE and the user clicked Done, returns the modified data frame invisibly. Otherwise returns the original data frame invisibly.

Features

• Data View - searchable, paginated DT table with optional variable-label tooltips and column-level search filters.

• Sidebar Filters - add unlimited filter conditions with operators ==, !=, >, >=, <, <=, contains, starts with, ends with, is NA, is not NA; combine with AND / OR logic.

• Multi-column Sort - add multiple sort levels; choose ascending or descending per column.

• Column Visibility - show/hide any columns via checkboxes.

• Excel-like Editor (edit = TRUE) - powered by rhandsontable; supports in-cell editing, adding rows, and unlimited undo/redo.

• Find & Replace - find literal text or regex across one or all columns with case-sensitivity and exact-match options; preview changes before applying.

• Variable Info - data type, N, missing min, max, and sample values for every column.

• R Code Generation - the R Code tab always shows the complete, runnable dplyr pipeline for the current state. One click copies it to the clipboard.

Examples

## Not run: 
## -- Basic view ------------------------------------------------------------
ViewR(mtcars)

## -- Edit mode: returns modified data -------------------------------------
new_iris <- ViewR(iris, edit = TRUE)

## -- Custom labels + dark theme --------------------------------------------
ViewR(mtcars,
      labels = c(mpg = "Miles per Gallon",
                 cyl = "Number of Cylinders",
                 hp  = "Gross Horsepower"),
      theme  = "darkly")

## -- Open in the system browser --------------------------------------------
ViewR(iris, viewer = "browser", generate_code = TRUE)

## -- View a haven-imported dataset (labels read automatically) -------------
# df <- haven::read_sav("my_survey.sav")
# ViewR(df)

## End(Not run)

Install All ViewR Dependencies

Description

Checks which required packages are missing from the user's library and installs them via install.packages.

Usage

install_viewr_deps(ask = TRUE)

Arguments

Value

Invisibly returns a character vector of packages that were (or needed to be) installed.

Examples

## Not run: 
install_viewr_deps()

## End(Not run)

Save a ViewR explorer to a standalone HTML file

Description

Exports any data frame as a fully interactive, offline ViewR explorer that runs in any browser without R or an internet connection.

Usage

save_viewdt(
  data,
  file,
  options = viewdt_options(),
  selfcontained = TRUE,
  title = "ViewR",
  dataset_name = NULL,
  open = FALSE
)

Arguments

Value

The output file path, invisibly.

Examples

## Not run: 
save_viewdt(mtcars, "mtcars.html", open = TRUE)
save_viewdt(iris, "iris.html", selfcontained = FALSE)

## End(Not run)

Modern interactive data explorer widget

Description

Opens a high-performance, self-contained data explorer for a data frame. 'viewdt()' profiles every column in R and renders a virtualized grid with “Kaggle”-style micro-dashboard headers (data-type badges, mini spark-histograms, and data-completeness bars), hover metadata cards, a sliding Data Insights drawer, a multi-condition visual query builder, a column-visibility picker, and a reproducible code generator (dplyr, base R, and SQL).

Usage

viewdt(
  data,
  options = viewdt_options(),
  dataset_name = NULL,
  width = NULL,
  height = NULL,
  elementId = NULL
)

Arguments

Details

The interface is implemented entirely in dependency-free vanilla JavaScript (no React or build toolchain) and works in the RStudio / Positron Viewer, inside Shiny, in R Markdown / Quarto, or as a portable standalone HTML file via [save_viewdt()].

Value

An 'htmlwidget' object.

Examples

## Not run: 
viewdt(mtcars)
viewdt(iris, options = viewdt_options(theme = "dark", hidden_columns = "Species"))

## End(Not run)

Shiny bindings for viewdt

Description

Output and render functions for using [viewdt()] within Shiny applications and interactive R Markdown documents.

Usage

viewdtOutput(outputId, width = "100%", height = "600px")

renderViewdt(expr, env = parent.frame(), quoted = FALSE)

Arguments

Value

'viewdtOutput()' returns a Shiny output UI element; 'renderViewdt()' returns a Shiny render function.

Configure the ViewR data explorer

Description

Builds the option list consumed by [viewdt()] and [save_viewdt()]. Every argument has a sensible default, so 'viewdt_options()' with no arguments returns a fully usable configuration.

Usage

viewdt_options(
  theme = c("auto", "light", "dark"),
  show_labels = TRUE,
  histograms = TRUE,
  missing_bars = TRUE,
  type_badges = TRUE,
  insights = TRUE,
  query_builder = TRUE,
  column_picker = TRUE,
  code_export = TRUE,
  global_search = TRUE,
  na_string = "NA",
  hidden_columns = NULL,
  page_size = 200L,
  hist_bins = 20L,
  top_n = 10L,
  max_cells = 5e+06
)

Arguments

Value

A named list of class '"viewdt_options"'.

Examples

viewdt_options(theme = "dark", hidden_columns = c("cyl", "hp"))