standby

May 30, 2023 · View on GitHub

Easily create alerts, notifications, tooltips and loading screens in Shiny

Installation

# Install release version from CRAN
install.packages("standby")

# Install development version from GitHub
# install.packages("devtools")
devtools::install_github("rsquaredacademy/standby")

Usage

Loading Screens

To use spinners/loaders from standby in your Shiny application, include the following in the UI part of the app:

Include the dependencies using the appropriate use* functions (useSpinkit() in the below example).
Wrap the target output using corresponding rendering function (spinkit() in the below example).

Example

library(shiny)
library(standby)

ui <- fluidPage(

  standby::useSpinkit(), # include dependencies
  fluidRow(
    standby::spinkit(plotOutput("plot1")), # wrap output inside loader
    actionButton("render", "Render")
  )

)

server <- function(input, output, session) {

    output$plot1 <- renderPlot({
      input$render
      Sys.sleep(3)
      hist(mtcars$mpg)
    })

}

shinyApp(ui, server)

Details

The below table displays the dependency and rendering functions along with references:

Index	Dependency	Render	Reference
1	`useThreeDots()`	`threeDots()`	Three Dots
2	`useSpinkit()`	`spinkit()`	SpinKit
3	`useVizLoad()`	`vizLoad()`	Loading Visualization
4	`useSpinners()`	`spinners()`	Spinners
5	`useLoaders()`	`loaders()`	Loaders

Alerts and Notifications

To use alerts or notifications from buzz in your Shiny application, follow the below steps:

Include the dependencies in the UI part of the app using the appropriate use* functions (useToast() in the below example).
Include the corresponding rendering function in the Server part of the app (toast() in the below example).

Example

library(shiny)
library(standby)
ui <- fluidPage(
  useBootBox(), # include dependencies
  actionButton(inputId = "notify",
               label   = "Show Notification")
)
server <- function(input, output, session) {
  observeEvent(input$pnotify, {
    bootBox(class = "rubberBand") # display the alert
  })
}
shinyApp(ui, server)

Details

The below table displays the dependency and rendering functions along with references:

Index	Dependency	Render	Reference
1	`useAlertify()`	`alertify_alert()`	Alertify
2	`useAlertify()`	`alertify_notify()`	Alertify
3	`useBootBox()`	`bootBox()`	BootBox
4	`useMicroTip()`	`microTip()`	MicroTip
5	`useNS()`	`notice()`	Notification Styles
6	`useNotify()`	`notify()`	PNotify
7	`useTingle()`	`tingle()`	Tingle
8	`useToast()`	`toast()`	iziToast

Getting Help

If you encounter a bug, please file a minimal reproducible example using reprex on github. For questions and clarifications, use StackOverflow.

Code of Conduct

Please note that the standby project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.