shiny v0.14.1

0

Monthly downloads

0th

Percentile

by Winston Chang

Web Application Framework for R

Makes it incredibly easy to build interactive web applications with R. Automatic "reactive" binding between inputs and outputs and extensive pre-built widgets make it possible to build beautiful, responsive, and powerful applications with minimal effort.

Readme

Shiny

Travis: Travis Build Status

AppVeyor: AppVeyor Build Status

Shiny is a new package from RStudio that makes it incredibly easy to build interactive web applications with R.

For an introduction and examples, visit the Shiny Dev Center.

Features

  • Build useful web applications with only a few lines of code—no JavaScript required.
  • Shiny applications are automatically "live" in the same way that spreadsheets are live. Outputs change instantly as users modify inputs, without requiring a reload of the browser.
  • Shiny user interfaces can be built entirely using R, or can be written directly in HTML, CSS, and JavaScript for more flexibility.
  • Works in any R environment (Console R, Rgui for Windows or Mac, ESS, StatET, RStudio, etc.).
  • Attractive default UI theme based on Bootstrap.
  • A highly customizable slider widget with built-in support for animation.
  • Pre-built output widgets for displaying plots, tables, and printed output of R objects.
  • Fast bidirectional communication between the web browser and R using the httpuv package.
  • Uses a reactive programming model that eliminates messy event handling code, so you can focus on the code that really matters.
  • Develop and redistribute your own Shiny widgets that other developers can easily drop into their own applications (coming soon!).

Installation

To install the stable version from CRAN, simply run the following from an R console:

install.packages("shiny")

To install the latest development builds directly from GitHub, run this instead:

if (!require("devtools"))
  install.packages("devtools")
devtools::install_github("rstudio/shiny")

Getting Started

To learn more we highly recommend you check out the Shiny Tutorial. The tutorial explains the framework in-depth, walks you through building a simple application, and includes extensive annotated examples.

We hope you enjoy using Shiny. If you have general questions about using Shiny, please use the Shiny mailing list. For bug reports, please use the issue tracker.

Bootstrap 3 migration

Shiny versions 0.10.2.2 and below used the Bootstrap 2 web framework. After 0.10.2.2, Shiny switched to Bootstrap 3. For most users, the upgrade should be seamless. However, if you have have customized your HTML-generating code to use features specific to Bootstrap 2, you may need to update your code to work with Bootstrap 3.

If you do not wish to update your code at this time, you can use the shinybootstrap2 package for backward compatibility.

If you prefer to install an older version of Shiny, you can do it using the devtools package:

devtools::install_version("shiny", version = "0.10.2.2")

Development notes

The Javascript code in Shiny is minified using tools that run on Node.js. See the tools/ directory for more information.

License

The shiny package is licensed under the GPLv3. See these files in the inst directory for additional details:

  • COPYING - shiny package license (GPLv3)
  • NOTICE - Copyright notices for additional included software

Functions in shiny

Name Description
builder HTML Builder Functions
bootstrapLib Bootstrap libraries
brushedPoints Find rows of data that are selected by a brush
absolutePanel Panel with absolute positioning
bootstrapPage Create a Bootstrap page
brushOpts Create an object representing brushing options
actionButton Action button/link
addResourcePath Resource Publishing
checkboxInput Checkbox Input Control
conditionalPanel Conditional Panel
clickOpts Create an object representing click options
domains Reactive domains
dateInput Create date input
dateRangeInput Create date range input
checkboxGroupInput Checkbox Group Input Control
column Create a column within a UI definition
createWebDependency Create a web dependency
dblclickOpts Create an object representing double-click options
fillRow Flex Box-based row/column layouts
downloadButton Create a download button or link
flowLayout Flow layout
downloadHandler File Downloads
exprToFunction Convert an expression to a function
fileInput File Upload Control
fluidPage Create a page with fluid layout
fillPage Create a page that fills the window
enableBookmarking Enable bookmarking for a Shiny application
fixedPage Create a page with a fixed layout
htmlTemplate Process an HTML template
icon Create an icon
include Include Content From a File
hoverOpts Create an object representing hover options
freezeReactiveValue Freeze a reactive value
htmlOutput Create an HTML output element
headerPanel Create a header panel
HTML Mark Characters as HTML
inputPanel Input panel
helpText Create a help text element
knitr_methods Knitr S3 methods
mainPanel Create a main panel
markRenderFunction Mark a function as a render function
makeReactiveBinding Make a reactive variable
isolate Create a non-reactive scope for an expression
installExprFunction Install an expression as a function
knit_print.html Knitr S3 methods
insertUI Insert UI objects
is.reactivevalues Checks whether an object is a reactivevalues object
invalidateLater Scheduled Invalidation
navbarPage Create a page with a top level navigation bar
modalDialog Create a modal dialog UI
observe Create a reactive observer
modalButton Create a button for a modal dialog
maskReactiveContext Evaluate an expression without a reactive context
observeEvent Event handler
NS Namespaced IDs for inputs/outputs
numericInput Create a numeric input control
nearPoints Find rows of data that are near a click/hover/double-click
navlistPanel Create a navigation list panel
reactive Create a reactive expression
reactiveFileReader Reactive file reader
outputOptions Set options for an output object.
pageWithSidebar Create a page with a sidebar
reactivePrint Print output (deprecated)
reactiveTable Table output (deprecated)
removeInputHandler Deregister an Input Handler
removeUI Remove UI objects
restoreInput Restore an input value
req Check for required values
callModule Invoke a Shiny module
Progress Reporting progress (object-oriented API)
radioButtons Create radio buttons
reactivePlot Plot output (deprecated)
renderTable Table Output
renderText Text Output
reactivePoll Reactive polling
serverInfo Collect information about the Shiny Server environment
bookmarkButton Create a button for bookmarking/sharing
setBookmarkExclude Exclude inputs from bookmarking
showReactLog Reactive Log Visualizer
shinyUI Create a Shiny UI handler
showModal Show or remove a modal dialog
showBookmarkUrlModal Display a modal dialog for bookmarking
textAreaInput Create a textarea input control
showNotification Show or remove a notification
updateActionButton Change the label or icon of an action button on the client
textInput Create a text input control
updateCheckboxGroupInput Change the value of a checkbox group input on the client
plotOutput Create an plot or image output element
validate Validate input values and other conditions
plotPNG Run a plotting function and save the output as a PNG
renderImage Image file output
renderDataTable Table output with the JavaScript library DataTables
renderUI UI Output
sliderInput Slider Input Widget
shinyApp Create a Shiny app object
repeatable Make a random number generator repeatable
shinyDeprecated Print message for deprecated functions in Shiny
splitLayout Split layout
reactiveValuesToList Convert a reactivevalues object to a list
registerInputHandler Register an Input Handler
safeError Declare an error safe for the user to see
selectInput Create a select list input control
stacktrace Stack trace manipulation functions
tabsetPanel Create a tabset panel
tag HTML Tag Object
updateTextAreaInput Change the value of a textarea input on the client
stopApp Stop the currently running Shiny app
updateTabsetPanel Change the selected tab on the client
passwordInput Create a password input control
parseQueryString Parse a GET query string from a URL
reactiveText Text output (deprecated)
reactiveTimer Timer
runApp Run Shiny Application
getShinyOption Get or set Shiny options
runExample Run Shiny Example Applications
tableOutput Create a table output element
validateCssUnit Validate proper CSS formatting of a unit
shinyServer Define Server Functionality
withTags Evaluate an expression using tags
sidebarLayout Layout a sidebar and main area
updateCheckboxInput Change the value of a checkbox input on the client
updateDateInput Change the value of a date input on the client
wellPanel Create a well panel
viewer Viewer options
updateDateRangeInput Change the start and end values of a date range input on the client
suppressDependencies Suppress web dependencies
submitButton Create a submit button
onBookmark Add callbacks for Shiny session bookmarking events
updateNumericInput Change the value of a number input on the client
onFlush Add callbacks for Shiny session events
reactiveUI UI output (deprecated)
runGadget Run a gadget
reactiveValues Create an object for storing reactive values
renderPrint Printable Output
shiny-options Global options for Shiny
runUrl Run a Shiny application from a URL
renderPlot Plot Output
shiny-package Web Application Framework for R
tabPanel Create a tab panel
updateSelectInput Change the value of a select input on the client
updateTextInput Change the value of a text input on the client
updateSliderInput Change the value of a slider input on the client
sidebarPanel Create a sidebar panel
textOutput Create a text output element
singleton Include content only once
urlModal Generate a modal dialog that displays a URL
updateQueryString Update URL in browser's location bar
titlePanel Create a panel containing an application title.
verbatimTextOutput Create a verbatim text output element
updateRadioButtons Change the value of a radio input on the client
withMathJax Load the MathJax library and typeset math expressions
verticalLayout Lay out UI elements vertically
withProgress Reporting progress (functional API)
No Results!

Last month downloads

Details

Type Package
License GPL-3 | file LICENSE
URL http://shiny.rstudio.com
BugReports https://github.com/rstudio/shiny/issues
Collate 'app.R' 'bookmark-state-local.R' 'stack.R' 'bookmark-state.R' 'bootstrap-layout.R' 'conditions.R' 'map.R' 'globals.R' 'utils.R' 'bootstrap.R' 'cache.R' 'diagnose.R' 'fileupload.R' 'graph.R' 'hooks.R' 'html-deps.R' 'htmltools.R' 'image-interact-opts.R' 'image-interact.R' 'imageutils.R' 'input-action.R' 'input-checkbox.R' 'input-checkboxgroup.R' 'input-date.R' 'input-daterange.R' 'input-file.R' 'input-numeric.R' 'input-password.R' 'input-radiobuttons.R' 'input-select.R' 'input-slider.R' 'input-submit.R' 'input-text.R' 'input-textarea.R' 'input-utils.R' 'insert-ui.R' 'jqueryui.R' 'middleware-shiny.R' 'middleware.R' 'modal.R' 'modules.R' 'notifications.R' 'priorityqueue.R' 'progress.R' 'react.R' 'reactive-domains.R' 'reactives.R' 'render-plot.R' 'render-table.R' 'run-url.R' 'serializers.R' 'server-input-handlers.R' 'server.R' 'shiny-options.R' 'shiny.R' 'shinyui.R' 'shinywrappers.R' 'showcase.R' 'tar.R' 'timer.R' 'update-input.R'
RoxygenNote 5.0.1
NeedsCompilation no
Packaged 2016-10-03 19:05:54 UTC; winston
Repository CRAN
Date/Publication 2016-10-05 11:02:59

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/shiny)](http://www.rdocumentation.org/packages/shiny)