add DTOutput() and renderDT() to avoid collisions with shiny (really …

…should have done this from Day 1)

might be relevant to #379

NAMESPACE

@@ -1,6 +1,7 @@
 # Generated by roxygen2: do not edit by hand
 
 export("%>%")
+export(DTOutput)
 export(JS)
 export(addRow)
 export(clearSearch)
@@ -16,6 +17,7 @@ export(formatSignif)
 export(formatString)
 export(formatStyle)
 export(reloadData)
+export(renderDT)
 export(renderDataTable)
 export(replaceData)
 export(saveWidget)

NEWS.md

@@ -2,6 +2,8 @@
 
 ## NEW FEATURES
 
+- Added functions `DTOutput()` and `renderDT()` as aliases of `dataTableOutput()` and `renderDataTable()`, respectively. This is because the latter often collide with functions of the same names in **shiny**. You are recommended to use `DTOutput()` and `renderDT()` in Shiny apps (unless you always use the `DT::` qualifier).
+
 - Added an argument `params` to the `formatDate()` function so you can pass a list of parameters to the specific date conversion method (http://stackoverflow.com/q/38875173/559676).
 
 - The arguments `interval`, `mark`, and `dec.mark` also work for functions `formatPercentage()`, `formatRound()`, and `formatSignif()` now (thanks, @paulofelipe, #128).

R/shiny.R

@@ -12,10 +12,11 @@
 #' @examples # !formatR
 #' if (interactive()) {
 #'   library(shiny)
+#'   library(DT)
 #'   shinyApp(
-#'     ui = fluidPage(fluidRow(column(12, DT::dataTableOutput('tbl')))),
+#'     ui = fluidPage(fluidRow(column(12, DTOutput('tbl')))),
 #'     server = function(input, output) {
-#'       output$tbl = DT::renderDataTable(
+#'       output$tbl = renderDT(
 #'         iris, options = list(lengthChange = FALSE)
 #'       )
 #'     }
@@ -31,6 +32,10 @@ dataTableOutput = function(outputId, width = '100%', height = 'auto') {
   )
 }
 
+#' @export
+#' @rdname dataTableOutput
+DTOutput = dataTableOutput
+
 #' @export
 #' @rdname dataTableOutput
 #' @inheritParams shiny::renderDataTable
@@ -119,6 +124,10 @@ renderDataTable = function(expr, server = TRUE, env = parent.frame(), quoted = F
   func
 }
 
+#' @export
+#' @rdname dataTableOutput
+renderDT = renderDataTable
+
 #' Manipulate an existing DataTables instance in a Shiny app
 #'
 #' The function \code{datatableProxy()} creates a proxy object that can be used