waiter (version 0.1.3)

waitressClass: Waitress R6 Class

Description

Create a waitress (progress bar) and programmatically set or increase its percentage, then hide it when done.

Methods

Public methods

• Waitress$new()

• Waitress$start()

• Waitress$notify()

• Waitress$set()

• Waitress$auto()

• Waitress$increase()

• Waitress$inc()

• Waitress$hide()

• Waitress$close()

• Waitress$print()

• Waitress$clone()

Method new()

Usage

Waitress$new(
  selector = NULL,
  theme = c("line", "overlay", "overlay-radius", "overlay-opacity", "overlay-percent"),
  min = 0,
  max = 100,
  infinite = FALSE,
  hide_on_render = FALSE
)

Arguments

selector

Element selector to apply the waitress to, if NULL then the waitress is applied to the whole screen.

theme

A valid theme, see function usage.

min, max

Minimum and maximum representing the starting and ending points of the progress bar.

infinite

Set to TRUE to create a never ending loading bar, ideal when you cannot compute increments or assess the time it might take before the loading bar should be removed.

hide_on_render

Set to TRUE to automatically hide the waitress when the element in id is rendered. Note the latter will work with shiny plots, tables, htmlwidgets, etc. but will not work with arbitrary elements.

color, percent_color

Color of waitress and color of percent text shown when theme is set to overlay-percent.

Details

Create a waitress.

Examples

\dontrun{Waitress$new("#plot")}

Method start()

Usage

Waitress$start(
  html = NULL,
  background_color = "transparent",
  text_color = "black"
)

Arguments

html

HTML content to show over the waitress, accepts htmltools and shiny tags.

background_color

The background color of the html.

text_color

The color of the html content.

Details

Start the waitress.

Examples

\dontrun{Waitress$new("#plot")$start()}

Method notify()

Usage

Waitress$notify(
  html = NULL,
  background_color = "white",
  text_color = "black",
  position = c("br", "tr", "bl", "tl")
)

Arguments

html

HTML content to show over the waitress, accepts htmltools and shiny tags.

background_color

The background color of the html.

text_color

The color of the html content.

position

Position of the notification on the screen. Where br is the bottom-right, tr is the top-right, bl is bottom-left, and tl is the top-left.

Details

Show the waitress as a notification.

Examples

\dontrun{Waitress$new()$notify()}

Method set()

Usage

Waitress$set(value)

Arguments

value

Value to set waitress to.

Details

Set the waitress to a specific percentage.

Examples

\dontrun{Waitress$new("#plot")$set(20)}

Method auto()

Usage

Waitress$auto(value, ms)

Arguments

value

Value to set waitress to.

ms

Number of Milliseconds

Details

Automatically start and end the waitress.

Examples

\dontrun{Waitress$new("#plot")$auto(20, 2000)}

Method increase()

Usage

Waitress$increase(percent)

Arguments

percent

Percentage to increase waitress to.

Details

Deprecated in favour of inc method. Increase the waitress by a percentage.

Method inc()

Usage

Waitress$inc(value)

Arguments

value

Value to increase waitress to.

Details

Increase the waitress by a percentage.

Examples

\dontrun{Waitress$new("#plot")$inc(30)}

Method hide()

Usage

Waitress$hide()

Details

Deprecated in favour of close method. Hide the waitress.

Method close()

Usage

Waitress$close()

Details

Close the waitress.

Examples

\dontrun{Waitress$new("#plot")$close()}

Method print()

Usage

Waitress$print()

Details

Print the waitress.

Examples

\dontrun{Waitress$new("#plot")$hide()}

Method clone()

The objects of this class are cloneable with this method.

Usage

Waitress$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.

Examples

# NOT RUN {
## ------------------------------------------------
## Method `Waitress$new`
## ------------------------------------------------

# }
# NOT RUN {
Waitress$new("#plot")
# }
# NOT RUN {
## ------------------------------------------------
## Method `Waitress$start`
## ------------------------------------------------

# }
# NOT RUN {
Waitress$new("#plot")$start()
# }
# NOT RUN {
## ------------------------------------------------
## Method `Waitress$notify`
## ------------------------------------------------

# }
# NOT RUN {
Waitress$new()$notify()
# }
# NOT RUN {
## ------------------------------------------------
## Method `Waitress$set`
## ------------------------------------------------

# }
# NOT RUN {
Waitress$new("#plot")$set(20)
# }
# NOT RUN {
## ------------------------------------------------
## Method `Waitress$auto`
## ------------------------------------------------

# }
# NOT RUN {
Waitress$new("#plot")$auto(20, 2000)
# }
# NOT RUN {
## ------------------------------------------------
## Method `Waitress$inc`
## ------------------------------------------------

# }
# NOT RUN {
Waitress$new("#plot")$inc(30)
# }
# NOT RUN {
## ------------------------------------------------
## Method `Waitress$close`
## ------------------------------------------------

# }
# NOT RUN {
Waitress$new("#plot")$close()
# }
# NOT RUN {
## ------------------------------------------------
## Method `Waitress$print`
## ------------------------------------------------

# }
# NOT RUN {
Waitress$new("#plot")$hide()
# }