Mark character strings as literal JavaScript code

Description

Copied verbatim from the htmlwidgets package to avoid adding a dependency just for this single function.

Usage

JS(...)

Arguments

Value

The input character vector marked with a special class.

React context

Description

Render children with React.

Usage

ReactContext(...)

Arguments

Examples

if (interactive()) shinyApp(
  ui = shiny.react:::ReactContext(
    "This text is rendered by React"
  ),
  server = function(input, output) {}
)

Parse arguments as props

Description

Converts arguments to a list which can be passed as the props argument to reactElement(). Unnamed arguments become children and named arguments become attributes for the element.

Usage

asProps(...)

Arguments

Value

A list of the arguments structured suitably for reactElement().

See Also

reactElement

Enable 'React' debug mode

Description

Sets the shiny.react_DEBUG option to TRUE. In debug mode, 'shiny.react' will load a dev version of 'React', which is useful for debugging. It will also set the logging level to DEBUG. Call this function before running the app to enable the debugging mode.

Usage

enableReactDebugMode()

Value

Nothing. This function is called for its side effects.

'React' library dependency

Description

'React' library dependency

Usage

reactDependency(useCdn = FALSE)

Arguments

Value

An htmlDependency object which can be used to attach the 'React' library.

Create a 'React' element

Description

Creates a shiny.tag which can be rendered just like other 'Shiny' tags as well as passed in props to other 'React' elements. Typically returned from a wrapper ("component") function, which parses its arguments with asProps() and fills in the other arguments.

Usage

reactElement(module, name, props, deps = NULL)

Arguments

Value

A shiny.tag object representing the 'React' element.

See Also

asProps

Examples

Component <- function(...) reactElement(
  module = "@/module", name = "Component", props = asProps(...)
)

'React' output

Description

Creates a 'Shiny' output which can be used analogously to shiny::uiOutput() but preserves 'React' state on re-renders.

Usage

reactOutput(outputId)

Arguments

Value

A shiny.tag object which can be placed in the UI.

See Also

renderReact

Examples

# This example uses some unexported test components. The components are not exported,
# as shiny.react is designed to only provide the machinery for building React-based packages.
# See shiny.fluent for a large number of examples.

if (interactive()) {
  colors <- list("Gold", "Lavender", "Salmon")

  shinyApp(
    ui = bootstrapPage(
      reactOutput("ui"),
      selectInput("color", label = "Background color", choices = colors)
    ),
    server = function(input, output) {
      output$ui <- renderReact(
        shiny.react:::Box(
          style = list(backgroundColor = input$color),
          shiny.react:::Pinger()
        )
      )
    }
  )
}

Render 'React'

Description

Renders HTML and/or 'React' in outputs created with reactOutput() (analogously to shiny::renderUI()).

Usage

renderReact(expr, env = parent.frame(), quoted = FALSE)

Arguments

Value

A function which can be assigned to an output in a Shiny server function.

See Also

reactOutput

Set input

Description

Creates a handler which can be used for onChange and similar props of 'React' components to set the value of a 'Shiny' input to one of the arguments passed to the handler.

Usage

setInput(inputId, jsAccessor)

## S4 method for signature 'character,missing'
setInput(inputId)

## S4 method for signature 'character,numeric'
setInput(inputId, jsAccessor)

## S4 method for signature 'character,character'
setInput(inputId, jsAccessor)

Arguments

Details

The argument jsAccessor can be empty (assumes jsAccessor = 0) or take one of the following types:

• A valid JavaScript accessor string to be applied to the object (example: jsAccessor = "[0].target.checked").

• A valid JavaScript 0-based index.

As an example, calling setInput("some_index", 1) is equivalent to setInput("some_index", "[1]")

Value

A ReactData object which can be passed as a prop to 'React' components.

Methods (by class)

• setInput(inputId = character, jsAccessor = missing): Uses as index jsAccessor = 0

• setInput(inputId = character, jsAccessor = numeric): Gets the value via index (see examples).

• setInput(inputId = character, jsAccessor = character): Gets value via accessor (see examples).

Examples

# Same as `setInput("some_id", 0)`.
setInput("some_id")

# Equivalent to `(...args) => Shiny.setInputValue('some_id', args[1])` in JS.
setInput("some_id", 1)

# Same as `setInput("some_id", 1)`.
setInput("some_id", "[1]")

# Equivalent to `(...args) => Shiny.setInputValue('some_id', args[0].target.value)` in JS.
setInput("some_id", "[0].target.value")

'shiny.react' JavaScript dependency

Description

'shiny.react' JavaScript dependency

Usage

shinyReactDependency()

Value

An htmlDependency object which can be used attach the JavaScript code required by 'shiny.react'.

Trigger event

Description

Creates a handler which can be used for onClick and similar props of 'React' components to trigger an event in 'Shiny'.

Usage

triggerEvent(inputId)

Arguments

Value

A ReactData object which can be passed as a prop to 'React' components.

Update 'React' input

Description

Updates inputs created with the help of InputAdapter function (part of the JavaScript interface). Analogous to shiny::updateX() family of functions, but generic.

Usage

updateReactInput(session = shiny::getDefaultReactiveDomain(), inputId, ...)

Arguments

Details

If you're creating a wrapper package for a 'React' library, you'll probably want to provide a dedicated update function for each input to imitate 'Shiny' interface.

Value

Nothing. This function is called for its side effects.