Chang W, Cheng J, Allaire J, Sievert C, Schloerke B, Xie Y, Allen J, McPherson J, Dipert A, Borges B (2022). shiny: Web Application Framework for R. -R package version 1.7.2, https://shiny.rstudio.com/. +R package version 1.7.1.9003, https://shiny.rstudio.com/.
@Manual{,
title = {shiny: Web Application Framework for R},
author = {Winston Chang and Joe Cheng and JJ Allaire and Carson Sievert and Barret Schloerke and Yihui Xie and Jeff Allen and Jonathan McPherson and Alan Dipert and Barbara Borges},
year = {2022},
- note = {R package version 1.7.2},
+ note = {R package version 1.7.1.9003},
url = {https://shiny.rstudio.com/},
}
diff --git a/favicon-16x16.png b/favicon-16x16.png
index e58931db2..85e589de7 100644
Binary files a/favicon-16x16.png and b/favicon-16x16.png differ
diff --git a/favicon-32x32.png b/favicon-32x32.png
index 351ed86c9..e48594ac2 100644
Binary files a/favicon-32x32.png and b/favicon-32x32.png differ
diff --git a/index.html b/index.html
index 8d39cc06d..7580d0d11 100644
--- a/index.html
+++ b/index.html
@@ -43,7 +43,7 @@
@@ -89,7 +89,7 @@
To install the stable version from CRAN:
-install.packages("shiny")install.packages("shiny")
Once installed, load the library and run an example:
-library(shiny)
-# Launches an app, with the app's source code included
-runExample("06_tabsets")
-# Lists more prepackaged examples
-runExample()library(shiny)
+# Launches an app, with the app's source code included
+runExample("06_tabsets")
+# Lists more prepackaged examples
+runExample()For more examples and inspiration, check out the Shiny User Gallery.
For help with learning fundamental Shiny programming concepts, check out the Mastering Shiny book and the Shiny Tutorial. The former is currently more up-to-date with modern Shiny features, whereas the latter takes a deeper, more visual, dive into fundamental concepts.
diff --git a/news/index.html b/news/index.html index 137add8f9..43d5e04d1 100644 --- a/news/index.html +++ b/news/index.html @@ -17,7 +17,7 @@ @@ -47,39 +47,6 @@ Source:NEWS.md
- renderPlot() (and plotPNG()) now uses ragg::agg_png() by default when the {ragg} package is installed. To restore the previous behavior, set options(shiny.useragg = FALSE). (#3654)Closed #1545: insertUI() now executes <script> tags. (#3630)
fileInput() can set the capture attribute to facilitates user access to a device’s media capture mechanism, such as a camera, or microphone, from within a file upload control (W3C HTML Media Capture). (Thanks to khaled-alshamaa, #3481)
Closed tidyverse/dplyr#5552: Compatibility of dplyr 1.0 (and rlang chained errors in general) with req(), validate(), and friends.
Closed tidyverse/dplyr#6154: Values from an actionButton() had S3 classes in the incorrect order.
Closed #3346: Default for ref input in runGithub() changed from "master" to "HEAD". (#3564)
Closed #3619: In R 4.2, splitLayout() no longer raises warnings about incorrect length in an if statement. (Thanks to @dmenne, #3625)
The auto-reload feature (options(shiny.autoreload=TRUE)) was not being activated by devmode(TRUE), despite a console message asserting that it was. (#3620)
Closed #2297: If an error occurred in parsing a value in a bookmark query string, an error would be thrown and nothing would be restored. Now a message is displayed and that value is ignored. (Thanks to @daattali, #3385)
Restored the previous behavior of automatically guessing the Content-Type header for downloadHandler functions when no explicit contentType argument is supplied. (#3393)
Previously, updating an input value without a corresponding Input binding element did not trigger a JavaScript shiny:inputchanged event. Now, if no Input binding element is found, the shiny:inputchanged event is triggered on window.document. (#3584)
Closed #2955: Input and output bindings previously attempted to use el['data-input-id'], but that never worked. They now use el.getAttribute('data-input-id') instead. (#3538)
When taking a test snapshot, the sort order of the json keys of the input, output, and export fields is currently sorted using the locale of the machine. This can lead to inconsistent test snapshot results. To opt-in to a consistent ordering of snapshot fields with shinytest, please set the global option options(shiny.snapshotsortc = TRUE). shinytest2 users do not need to set this value. (#3515)
Closed rstudio/shinytest2#222: When restoring a context (i.e., bookmarking) from a URL, Shiny now better handles a trailing = after _inputs_ and _values_. (#3648)
Shiny’s internal HTML dependencies are now mounted dynamically instead of statically. (#3537)
HTML dependencies that are sent to dynamic UI now have better type checking, and no longer require a dep.src.href field. (#3537)
The internal URLdecode() function previously was a copy of httpuv::decodeURIComponent(), assigned at build time; now it invokes the httpuv function at run time.
Fixed #1840: with the release of Shiny 1.0.5, we accidently changed the relative positioning of the icon and the title text in navbarMenus and tabPanels. This fix reverts this behavior back (i.e. the icon should be to the left of the text and/or the downward arrow in case of navbarMenus). (#1848)
Fixed #1600: URL-encoded bookmarking did not work with sliders that had dates or date-times. (#1961)
Fixed #1962: File dragging and dropping broke in the presence of jQuery version 3.0 as introduced by the rhandsontable htmlwidget. (#2005)
Fixed #1962: File dragging and dropping broke in the presence of jQuery version 3.0 as introduced by the rhandsontable htmlwidget. (#2005)
Improved the error handling inside the addResourcePath() function, to give end users more informative error messages when the directoryPath argument cannot be normalized. This is especially useful for runtime: shiny_prerendered Rmd documents, like learnr tutorials. (#1968)
Changed script tags in reactlog (inst/www/reactive-graph.html) from HTTP to HTTPS in order to avoid mixed content blocking by most browsers. (Thanks, @jekriske-lilly! #1844)
Addressed #1784: runApp() will avoid port 6697, which is considered unsafe by Chrome.
If you want to install a specific version of Shiny other than the latest CRAN release, you can use the install_version() function from devtools:
-
-# Install devtools if you don't already have it:
-install.package("devtools")
-
-# Install the last version of Shiny prior to 0.11
-devtools::install_version("shiny", "0.10.2.2")
+# Install devtools if you don't already have it:
+install.package("devtools")
+
+# Install the last version of Shiny prior to 0.11
+devtools::install_version("shiny", "0.10.2.2")NULL for a MockShinySesion.
new()Create a new MockShinySession.
@@ -213,7 +213,7 @@ user. AlwaysNULL for a MockShinySesion.
onFlush()Define a callback to be invoked before a reactive flush
NULL for a MockShinySesion.
onFlushed()Define a callback to be invoked after a reactive flush
NULL for a MockShinySesion.
onEnded()Define a callback to be invoked when the session ends
MockShinySession$onEnded(sessionEndedCallback)MockShinySession$onEnded(sessionEndedCallback)NULL for a MockShinySesion.
isEnded()Returns FALSE if the session has not yet been closed
NULL for a MockShinySesion.
isClosed()Returns FALSE if the session has not yet been closed
NULL for a MockShinySesion.
close()Closes the session
@@ -293,7 +293,7 @@ user. AlwaysNULL for a MockShinySesion.
cycleStartAction()Unsophisticated mock implementation that merely invokes
NULL for a MockShinySesion.
fileUrl()Base64-encode the given file. Needed for image rendering.
MockShinySession$fileUrl(name, file, contentType = "application/octet-stream")MockShinySession$fileUrl(name, file, contentType = "application/octet-stream")NULL for a MockShinySesion.
Sets reactive values associated with the session$inputs
object and flushes the reactives.
callback for execution after some number of millis
milliseconds.MockShinySession$.scheduleTask(millis, callback)MockShinySession$.scheduleTask(millis, callback)elapse()Simulate the passing of time by the given number of milliseconds.
.now()An internal method which shouldn't be used by others.
MockShinySession$defineOutput(name, func, label)MockShinySession$defineOutput(name, func, label)An internal method which shouldn't be used by others. Forces evaluation of any reactive dependencies of the output function.
ns()Returns the given id prefixed by this namespace's id.
flushReact()Trigger a reactive flush right now.
@@ -486,7 +486,7 @@ output.makeScope()Create and return a namespace-specific session proxy.
getReturned()Get the value returned by the module call.
Generate a distinct character identifier for use as a proxy namespace.
Provides a way to access the root MockShinySession from
any descendant proxy.
unhandledError()Called by observers when a reactive expression errors.
freezeValue()Freeze a value until the flush cycle completes.
MockShinySession$onSessionEnded(sessionEndedCallback)MockShinySession$onSessionEnded(sessionEndedCallback)registerDownload()Associated a downloadable file with the session.
MockShinySession$registerDownload(name, filename, contentType, content)MockShinySession$registerDownload(name, filename, contentType, content)Get information about the output that is currently being executed.
NULL if no output is currently executing.
clone()The objects of this class are cloneable with this method.
NULL if no output is currently executing.
-## ------------------------------------------------
-## Method `MockShinySession$setInputs`
-## ------------------------------------------------
-
-if (FALSE) {
-session$setInputs(x=1, y=2)
-}
+
+## ------------------------------------------------
+## Method `MockShinySession$setInputs`
+## ------------------------------------------------
+
+if (FALSE) {
+session$setInputs(x=1, y=2)
+}
NS(namespace, id = NULL)
-
-ns.sepNS(namespace, id = NULL)
+
+ns.sepnew()Creates a new progress panel (but does not display it).
Progress$new(
- session = getDefaultReactiveDomain(),
- min = 0,
- max = 1,
- style = getShinyOption("progress.style", default = "notification")
-)Progress$new(
+ session = getDefaultReactiveDomain(),
+ min = 0,
+ max = 1,
+ style = getShinyOption("progress.style", default = "notification")
+)Updates the progress panel. When called the first time, the progress panel is displayed.
Progress$set(value = NULL, message = NULL, detail = NULL)Progress$set(value = NULL, message = NULL, detail = NULL)message.
is that inc increases the progress bar by amount, instead of
setting it to a specific value.Progress$inc(amount = 0.1, message = NULL, detail = NULL)Progress$inc(amount = 0.1, message = NULL, detail = NULL)message.
getMin()Returns the minimum value.
@@ -205,7 +205,7 @@ relative tomessage.
getMax()Returns the maximum value.
@@ -213,7 +213,7 @@ relative tomessage.
getValue()Returns the current value.
@@ -222,7 +222,7 @@ relative tomessage.
Removes the progress panel. Future calls to set and
close will be ignored.
message.
clone()The objects of this class are cloneable with this method.
message.
## Only run examples in interactive R sessions
-if (interactive()) {
-
-ui <- fluidPage(
- plotOutput("plot")
-)
-
-server <- function(input, output, session) {
- output$plot <- renderPlot({
- progress <- Progress$new(session, min=1, max=15)
- on.exit(progress$close())
-
- progress$set(message = 'Calculation in progress',
- detail = 'This may take a while...')
-
- for (i in 1:15) {
- progress$set(value = i)
- Sys.sleep(0.5)
- }
- plot(cars)
- })
-}
-
-shinyApp(ui, server)
-}
+ ## Only run examples in interactive R sessions
+if (interactive()) {
+
+ui <- fluidPage(
+ plotOutput("plot")
+)
+
+server <- function(input, output, session) {
+ output$plot <- renderPlot({
+ progress <- Progress$new(session, min=1, max=15)
+ on.exit(progress$close())
+
+ progress$set(message = 'Calculation in progress',
+ detail = 'This may take a while...')
+
+ for (i in 1:15) {
+ progress$set(value = i)
+ Sys.sleep(0.5)
+ }
+ plot(cars)
+ })
+}
+
+shinyApp(ui, server)
+}
absolutePanel(
- ...,
- top = NULL,
- left = NULL,
- right = NULL,
- bottom = NULL,
- width = NULL,
- height = NULL,
- draggable = FALSE,
- fixed = FALSE,
- cursor = c("auto", "move", "default", "inherit")
-)
-
-fixedPanel(
- ...,
- top = NULL,
- left = NULL,
- right = NULL,
- bottom = NULL,
- width = NULL,
- height = NULL,
- draggable = FALSE,
- cursor = c("auto", "move", "default", "inherit")
-)absolutePanel(
+ ...,
+ top = NULL,
+ left = NULL,
+ right = NULL,
+ bottom = NULL,
+ width = NULL,
+ height = NULL,
+ draggable = FALSE,
+ fixed = FALSE,
+ cursor = c("auto", "move", "default", "inherit")
+)
+
+fixedPanel(
+ ...,
+ top = NULL,
+ left = NULL,
+ right = NULL,
+ bottom = NULL,
+ width = NULL,
+ height = NULL,
+ draggable = FALSE,
+ cursor = c("auto", "move", "default", "inherit")
+)