dataEdit: Shiny module for data editing

In DillonHammill/DataEditR: An Interactive Editor for Viewing, Entering, Filtering & Editing Data

Shiny module for data editing

Description

Shiny module for data editing

Usage

dataEditUI(id)

dataEditServer(
  id,
  data = reactive(NULL),
  col_bind = NULL,
  col_edit = TRUE,
  col_options = NULL,
  col_stretch = FALSE,
  col_names = TRUE,
  col_readonly = NULL,
  col_factor = FALSE,
  row_bind = NULL,
  row_edit = TRUE,
  row_index = reactive(NULL),
  quiet = FALSE,
  read_fun = "read.csv",
  read_args = NULL,
  ...
)

Arguments

id	unique identifier for the module to prevent namespace clashes when making multiple calls to this shiny module.
data	a reactive expression containing an array (e.g. data.frame, matrix or data.table) or a vector indicating the dimensions of the array (e.g. c(10,10)) or column names to construct a new template for editing. If no data is supplied a template with 10 rows and columns will be generated for editing.
col_bind	additional columns to add to the data prior to loading into editor, can be either an array containing the new data, a vector containing the new column names for empty columns or a named list containing a vector for each new column.
col_edit	logical indicating whether columns can be added or removed, set to TRUE by default.
col_options	a list named with valid columns names and either c(TRUE, FALSE) for checkboxes, a vector of options for dropdowns, "date" for date input or "password" for password input.
col_stretch	logical indicating whether columns should be stretched to fill the full width of the display, set to FALSE by default.
col_names	logical indicating whether column names can be edited or a vector of column names that cannot be edited, set to TRUE by default to allow editing of column names.
col_readonly	names of columns that cannot be edited. Users will be able to edit values but these will be reverted to the original values. Column names for these column cannot be edited either.
col_factor	logical indicating whether character columns should be converted to factors prior to returning the edited data, set to FALSE by default.
row_bind	additional rows to add to the data prior to loading into editor, can be either an array containing the new data, a vector containing the new row names for empty rows or a named list containing a vector for each new column.
row_edit	logical indicating whether rows can be added or removed, set to TRUE by default.
row_index	indicates the starting index for new rows when the data supplied to DataEdit() is a subset of a larger dataset, i.e. row_index indicates the number of rows present in the parental dataset.
quiet	logical to suppress warnings when using col_options.
read_fun	name of the function to use to read in the data when a file is selected, set to read.csv by default.
read_args	a named list of additional arguments to pass to read_fun when reading in files.
...	additional arguments passed to rhandsontable.

Value

reactive expression containing the edited data.

Author(s)

Dillon Hammill, [e-mail]

Examples

if (interactive()) {
  ui <- fluidPage(
    dataInputUI("input-1"),
    dataOutputUI("output-1"),
    dataEditUI("edit-1")
  )

  server <- function(input, output, session) {
    data_to_edit <- dataInputServer("input-1")
    data_edit <- dataEditServer("edit-1",
      data = data_to_edit
    )
    dataOutputServer("output-1",
      data = data_edit
    )
  }

  shinyApp(ui, server)
}

DillonHammill/DataEditR documentation built on Oct. 4, 2022, 10:41 a.m.