Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Yang-Tang/shinyjqui

jQuery UI Interactions and Effects for Shiny
https://github.com/Yang-Tang/shinyjqui

jquery-ui r shiny

Last synced: 28 days ago
JSON representation

jQuery UI Interactions and Effects for Shiny

Awesome Lists containing this project

README

        

---
output: github_document
---

```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```

# shinyjqui

[![R-CMD-check](https://github.com/Yang-Tang/shinyjqui/workflows/R-CMD-check/badge.svg)](https://github.com/Yang-Tang/shinyjqui/actions)
[![Travis-CI Build Status](https://travis-ci.org/Yang-Tang/shinyjqui.svg?branch=master)](https://travis-ci.org/Yang-Tang/shinyjqui)
[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/Yang-Tang/shinyjqui?branch=master&svg=true)](https://ci.appveyor.com/project/Yang-Tang/shinyjqui) [![CRAN\_Status\_Badge](https://www.r-pkg.org/badges/version/shinyjqui)](https://cran.r-project.org/package=shinyjqui)

shinyjqui package is an R wrapper of [jQuery UI](https://jqueryui.com/) javascript library. It can be used to easily add interactions and animation effects to a shiny app.

## Installation

You can install the stable version from CRAN, or the development version from github with:

```{r, eval = FALSE}
# install from CRAN
install.packages('shinyjqui')

# for the development version
devtools::install_github("yang-tang/shinyjqui")
```

## Usage

```{r, eval=FALSE}
# load packages
library(shiny)
library(shinyjqui)
library(ggplot2)
library(highcharter)
```

* __Draggable:__ Allow elements to be moved using the mouse

```{r, eval = FALSE}
server <- function(input, output) {}

ui <- fluidPage(
jqui_draggable(fileInput('file', 'File'))
)

shinyApp(ui, server)
```

![](man/figures/README-draggable.gif)

* __Resizable:__ Change the size of an element using the mouse.

```{r, eval = FALSE}
server <- function(input, output) {
output$gg <- renderPlot({
ggplot(mtcars, aes(x = cyl, y = mpg)) + geom_point()
})
}

ui <- fluidPage(
jqui_resizable(plotOutput('gg', width = '200px', height = '200px'))
)

shinyApp(ui, server)
```

![](man/figures/README-resizable.gif)

* __Sortable:__ Reorder elements in a list or grid using the mouse.

```{r, eval = FALSE}
server <- function(input, output) {
output$hc <- renderHighchart({
hchart(mtcars, "scatter", hcaes(x = cyl, y = mpg, group = factor(vs))) %>%
hc_legend(enabled = FALSE)
})
output$gg <- renderPlot({
ggplot(mtcars, aes(x = cyl, y = mpg, color = factor(vs))) +
geom_point() +
theme(legend.position= "none")
})
}

ui <- fluidPage(
jqui_sortable(div(id = 'plots',
highchartOutput('hc', width = '200px', height = '200px'),
plotOutput('gg', width = '200px', height = '200px')))
)

shinyApp(ui, server)
```

![](man/figures/README-sortable.gif)

* __Animation Effects:__ Apply an animation effect to an element. Effects can also be used in hide or show.

```{r, eval = FALSE}
server <- function(input, output) {
observeEvent(input$show, {
jqui_show('#gg', effect = input$effect)
})

observeEvent(input$hide, {
jqui_hide('#gg', effect = input$effect)
})

output$gg <- renderPlot({
ggplot(mtcars, aes(x = cyl, y = mpg, color = factor(gear))) +
geom_point() +
theme(plot.background = element_rect(fill = "transparent",colour = NA))
}, bg = "transparent")
}

ui <- fluidPage(
div(style = 'width: 400px; height: 400px',
plotOutput('gg', width = '100%', height = '100%')),
selectInput('effect', NULL, choices = get_jqui_effects()),
actionButton('show', 'Show'),
actionButton('hide', 'Hide')
)

shinyApp(ui, server)
```

![](man/figures/README-effects.gif)

* __Classes transformation:__ Add and remove class(es) to elements while animating all style changes.

```{r, eval = FALSE}
server <- function(input, output) {

current_class <- c()

observe({
input$class
class_to_remove <- setdiff(current_class, input$class)
class_to_add <- setdiff(input$class, current_class)
current_class <<- input$class
if(length(class_to_remove) > 0) {
jqui_remove_class('#foo', paste(class_to_remove, collapse = ' '), duration = 1000)}
if(length(class_to_add) > 0) {
jqui_add_class('#foo', paste(class_to_add, collapse = ' '), duration = 1000)}
})

}

ui <- fluidPage(

tags$head(
tags$style(
HTML('.class1 { width: 410px; height: 100px; }
.class2 { text-indent: 40px; letter-spacing: .2em; }
.class3 { padding: 30px; margin: 10px; }
.class4 { font-size: 1.1em; }')
)
),

div(id = 'foo', 'Etiam libero neque, luctus a, eleifend nec, semper at, lorem. Sed pede.'),
hr(),
checkboxGroupInput('class', 'Class',
choices = list(`width: 410px; height: 100px;` = 'class1',
`text-indent: 40px; letter-spacing: .2em;` = 'class2',
`padding: 30px; margin: 10px;` = 'class3',
`font-size: 1.1em;` = 'class4'))

)

shinyApp(ui, server)
```

![](man/figures/README-classes.gif)

* __orderInput():__ Display a list of items. Their order can be changed by drag and drop.

```{r, eval = FALSE}
server <- function(input, output) {
output$order <- renderPrint({ print(input$dest) })
}

ui <- fluidPage(
orderInput('source', 'Source', items = month.abb,
as_source = TRUE, connect = 'dest'),
orderInput('dest', 'Dest', items = NULL, placeholder = 'Drag items here...'),
verbatimTextOutput('order')
)

shinyApp(ui, server)
```

![](man/figures/README-orderInput.gif)

* __sortableTableOutput():__ Render a HTML table with sortable rows.

```{r, eval = FALSE}
ui <- fluidPage(
verbatimTextOutput("index"),
sortableTableOutput("tbl")
)

server <- function(input, output) {
output$index <- renderPrint({
cat("Row index:\n")
input$tbl_row_index
})
output$tbl <- renderTable(head(mtcars), rownames = TRUE)
}

shinyApp(ui, server)
```

![](man/figures/README-sortableTableOutput.gif)

* __selectableTableOutput():__ Render a HTML table with selectable rows or cells.

```{r, eval = FALSE}
ui <- fluidPage(
selectableTableOutput("tbl", selection_mode = "cell"),
verbatimTextOutput("selected")
)

server <- function(input, output) {
output$selected <- renderPrint({
cat("Selected:\n")
input$tbl_selected
})
output$tbl <- renderTable(head(mtcars), rownames = TRUE)
}

shinyApp(ui, server)
```

![](man/figures/README-selectableTableOutput_cell.gif)

For more information, please visit the [package website](https://yang-tang.github.io/shinyjqui/).