Shiny UI Widgets for Small Screens

Provides UI widget and layout functions for writing Shiny apps that work well on small screens.


Provides UI widget and layout functions for writing Shiny apps that work well on small screens. Designed to work especially well for creating Shiny Gadgets.

Inspired by the lovely Ratchet CSS framework, though currently miniUI doesn't use any of Ratchet's CSS code.

Installing

devtools::install_github("rstudio/miniUI")

Getting started

Check out the Designing Gadget UI article on shiny.rstudio.com.

Example

Screenshot

ui <- miniPage(
  gadgetTitleBar("Shiny gadget example"),
  miniTabstripPanel(
    miniTabPanel("Parameters", icon = icon("sliders"),
      miniContentPanel(
        sliderInput("year", "Year", 1978, 2010, c(2000, 2010), sep = "")
      )
    ),
    miniTabPanel("Visualize", icon = icon("area-chart"),
      miniContentPanel(
        plotOutput("cars", height = "100%")
      )
    ),
    miniTabPanel("Map", icon = icon("map-o"),
      miniContentPanel(padding = 0,
        leafletOutput("map", height = "100%")
      ),
      miniButtonBlock(
        actionButton("resetMap", "Reset")
      )
    ),
    miniTabPanel("Data", icon = icon("table"),
      miniContentPanel(
        DT::dataTableOutput("table")
      )
    )
  )
)

Full source at: https://github.com/rstudio/miniUI/blob/master/examples/tabs.R

License

The miniUI package is licensed under the GPLv3.


Compiling Less source to CSS

You generally don't need to do this. This build step is only needed if you want to contribute to the development of the package by modifying the built-in CSS styles.

One-time setup

Prerequisite: You must have Node.js installed.

# Install the grunt command if necessary 
which grunt || sudo npm install -g grunt-cli
 
# Install dependencies 
cd tools
npm install

Building

cd tools
grunt

News

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.