Package 'shinypanel'

Title: Shiny Control Panel
Description: Add shiny inputs with one or more inline buttons that grow and shrink with inputs. Also add tool tips to input buttons and styling and messages for input validation.
Authors: Alex Pickering
Maintainer: Alex Pickering <[email protected]>
License: MIT + file LICENSE
Version: 0.1.5
Built: 2025-02-08 03:06:33 UTC
Source: https://github.com/alexvpickering/shinypanel

Help Index


selectizeInput with buttons and validation utilities

Description

selectizeInput with buttons and validation utilities

Usage

selectizeInputWithButtons(
  inputId,
  label,
  ...,
  options = NULL,
  container_id = NULL,
  help_id = NULL,
  label_title = NULL,
  btn_titletips = TRUE,
  btn_placement = NULL,
  hide_btns = FALSE
)

Arguments

inputId

The input slot that will be used to access the value.

label

Display label for the control, or NULL for no label.

...

One or more actionButton's to appear to right of input element.

options

A list of options. See the documentation of selectize.js for possible options (character option values inside base::I() will be treated as literal JavaScript code; see renderDataTable() for details).

container_id

id for outer div (optional). Can use e.g. to add 'has-error' class to style inputs with shinyjs::addClass.

help_id

id for span with class 'help-block' below input (optional). Can be used for add error message with shinyjs::html.

label_title

Optional text to appear in info icon tooltip. Used to provide information to user about input.

btn_titletips

if TRUE (default), converts title attributes of actionButtons into tooltips.

btn_placement

Where the actionButton tooltips should appear (top, bottom, left, right). Defaults to 'right' for dropdown buttons and 'bottom' for all others.

hide_btns

If TRUE styling is adjusted so that all buttons are initially hidden. Can unhide buttons using toggleSelectizeButtons.

See Also

selectizeInput, html, addClass, toggleSelectizeButtons.

Examples

library(shiny)
library(shinypanel)

ui <- fluidPage(
  div(class = 'row',
      div(class = 'col-sm-12 col-lg-6',
          div(class = 'well-form',
              textAreaInputWithButtons(
                inputId = 'text',
                label = 'Type something:',
                actionButton(
                  'btn3',
                  '',
                  icon('plus', 'fa-fw'),
                  title = 'Click to add something'
                )
              ),
              selectizeInputWithButtons(
                inputId = 'selection',
                label = 'Select something:',
                label_title = 'Information about input',
                actionButton(
                  'btn1',
                  '',
                  icon('tag', 'fa-fw'),
                  title = 'this does something'
                ),
                actionButton(
                  'btn2',
                  '',
                  icon('chevron-right', 'fa-fw'),
                  title = 'this does something else'
                ),
                options = list(create = TRUE)
              )
          )
      )
  )
)


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

  choices <- reactive({
    paste('Long Option', 1:5)
  })

  observe({
    updateSelectizeInput(session, 'selection', choices = choices())
  })
}

# shinyApp(ui, server)

selectizeInput with validation utilities

Description

selectizeInput with validation utilities

Usage

selectizeInputWithValidation(
  inputId,
  label,
  options = NULL,
  container_id = NULL,
  help_id = NULL,
  label_title = NULL
)

Arguments

inputId

The input slot that will be used to access the value.

label

Display label for the control, or NULL for no label.

options

A list of options. See the documentation of selectize.js for possible options (character option values inside base::I() will be treated as literal JavaScript code; see renderDataTable() for details).

container_id

id for outer div (optional). Can use e.g. to add 'has-error' class to style inputs with shinyjs::addClass.

help_id

id for span with class 'help-block' below input (optional). Can be used for add error message with shinyjs::html.

label_title

Optional text to appear in info icon tooltip. Used to provide information to user about input.

See Also

selectizeInputWithButtons, html, addClass, toggleSelectizeButtons.


textAreaInput with buttons and validation

Description

textAreaInput with buttons and validation

Usage

textAreaInputWithButtons(
  inputId,
  label,
  ...,
  container_id = NULL,
  help_id = NULL,
  label_title = NULL,
  btn_titletips = TRUE,
  placeholder = ""
)

Arguments

inputId

The input slot that will be used to access the value.

label

Display label for the control, or NULL for no label.

...

One or more actionButton's to appear to right of input element.

container_id

id for outer div (optional). Can use e.g. to add 'has-error' class to style inputs with shinyjs::addClass.

help_id

id for span with class 'help-block' below input (optional). Can be used for add error message with shinyjs::html.

label_title

Optional text to appear in info icon tooltip. Used to provide information to user about input.

btn_titletips

if TRUE (default), converts title attributes of actionButtons into tooltips.

placeholder

A character string giving the user a hint as to what can be entered into the control. Internet Explorer 8 and 9 do not support this option.


textInput with buttons and validation

Description

textInput with buttons and validation

Usage

textInputWithButtons(
  inputId,
  label,
  ...,
  value = "",
  container_id = NULL,
  help_id = NULL,
  label_title = NULL,
  btn_titletips = TRUE,
  placeholder = "",
  width = NULL
)

Arguments

inputId

The input slot that will be used to access the value.

label

Display label for the control, or NULL for no label.

...

One or more actionButton's to appear to right of input element.

value

Initial value.

container_id

id for outer div (optional). Can use e.g. to add 'has-error' class to style inputs with shinyjs::addClass.

help_id

id for span with class 'help-block' below input (optional). Can be used for add error message with shinyjs::html.

label_title

Optional text to appear in info icon tooltip. Used to provide information to user about input.

btn_titletips

if TRUE (default), converts title attributes of actionButtons into tooltips.

placeholder

A character string giving the user a hint as to what can be entered into the control. Internet Explorer 8 and 9 do not support this option.

width

The width of the input, e.g. '400px', or '100%'; see validateCssUnit().


textInput with validation

Description

textInput with validation

Usage

textInputWithValidation(
  inputId,
  label,
  value = "",
  container_id = NULL,
  help_id = NULL
)

Arguments

inputId

The input slot that will be used to access the value.

label

Display label for the control, or NULL for no label.

value

Initial value.

container_id

id for outer div (optional). Can use e.g. to add 'has-error' class to style inputs with shinyjs::addClass.

help_id

id for span with class 'help-block' below input (optional). Can be used for add error message with shinyjs::html.


Show/hide all buttons in selectizeInputWithButtons

Description

When hiding all buttons, some CSS changes are required to allow return of full-width and rounded corners of selectizeInput.

Usage

toggleSelectizeButtons(selectize_id, button_ids, condition)

Arguments

selectize_id

id of selectizeInputWithButtons element.

button_ids

character vector of actionButton ids associated with selectize_id.

condition

An optional argument to toggleClass, see 'Details' below.

See Also

selectizeInputWithButtons