helper: Augment a shiny.tag with a question mark helper button

In cwthom/shinyhelper: Easily Add Markdown Help Files to 'shiny' App Elements

Augment a shiny.tag with a question mark helper button

Description

Add an action button to your shiny UI with a question mark help icon (by default). In combination with observe_helpers this icon will produce a modal dialog box in the app, with content and title as specified. You may pass inline content for the modal, or else specify the name of a markdown file to include.

Usage

helper(shiny_tag, icon = "question-circle", colour = NULL,
  type = "markdown", title = "", content = "", size = "m",
  buttonLabel = "Okay", easyClose = TRUE, fade = FALSE, ...)

Arguments

shiny_tag	A shiny element, such as an input or output (but any shiny tag will do).
icon	A character string of the name of the icon to display (font awesome).
colour	Any valid CSS colour for the icon.
type	Either 'markdown' to include a helpfile, or 'inline' to specify text.
title	The title to use for your modal. Leave as "" to have no title (for example, if your markdown document has a header you wish to use instead).
content	If type = "markdown", the name of your markdown file; if type = "inline", a character vector of text/HTML to include. This will be pasted together with line breaks. You need not add '.md' to the markdown filename.
size	Either 's', 'm' or 'l' - the size of the modal dialog to display.
buttonLabel	The text for the modal button - "Ok" by default.
easyClose	Whether the modal can be dismissed by pressing Escape, or clicking outside the modal. Defaults to TRUE.
fade	Whether the modal has a fade in animation. Defaults to FALSE.
...	Other arguments to pass to the div containing the icon.

Examples

helper(shiny::actionButton("go", "click me!"),
       icon = "exclamation",
       colour = "red",
       type = "markdown",
       content = "ClickHelp")  # looks for 'helpfiles/ClickHelp.md'
       

cwthom/shinyhelper documentation built on Aug. 16, 2022, 1:33 p.m.