Repository files navigation

Fomantic (Semantic) UI wrapper for Shiny.

With this library it is easy to wrap Shiny withFomanticUI (previouslySemantic). Add a fewsimple lines of code to give your UI afresh, modern and highlyinteractive look.

• shiny

library(shiny)ui<- fluidPage(  div(    div(      a("Link"),      p("Lorem ipsum, lorem ipsum, lorem ipsum"),      actionButton("button","Click")    )  ))

• shiny.semantic

library(shiny.semantic)ui<- semanticPage(  div(class="ui raised segment",    div(      a(class="ui green ribbon label","Link"),      p("Lorem ipsum, lorem ipsum, lorem ipsum"),      actionButton("button","Click")    )  ))

🔗 Churn analytics	🔗 Fraud detection

We show howshiny.semantic can be used to style an app and change it’slook.

🔗 BEFORE Utah Division of Water Quality (DWQ)	🔗 AFTER Utah Division of Water Quality (DWQ)

See more examples with code in theexamples folder:

• Static Semantic componentsdemo
• Calendar date and month demo withupdate
• Counter buttondemo
• Custom CSSdemo
• Dropdown updatedemo
• Form inputsdemo
• Modaldemos
• Multiple checkboxdemo
• Rating with updatedemo
• Search selectiondemos
• Shiny numericInputdemo
• Shiny selectInputdemo
• Shiny fileInputdemo
• Slider and range with updatedemo
• Multiple tabdemo
• Notificationdemo

You can install a stableshiny.semantic release from CRAN repository:

install.packages("shiny.semantic")

and the latest version withremotes:

remotes::install_github("Appsilon/shiny.semantic@develop")

(master branch contains the stable version. Usedevelop branch forlatest features)

To installprevious versions you can run:

remotes::install_github("Appsilon/shiny.semantic",ref="0.1.0")

Firstly, you will have to invokeshinyUI() withsemanticPage()instead of standard Shiny UI definitions like e.g. bootstrapPage().From now on, all components can be annotated withFomanticUI specific CSS classes and also you will beable to useshiny.semanticcomponents.

Basic example for rendering a simple button. will look like this:

library(shiny)library(shiny.semantic)ui<- semanticPage(title="My page",      div(class="ui button", icon("user"),"Icon button")    )server<-function(input,output) {}shinyApp(ui,server)

For better understanding it’s good to checkFomantic UIdocumentation.

Note #1

At the moment you have to pass page title insemanticPage()

semanticPage(title="Your page title",...)

Note #2

Theshiny package works withBootstrap library under the hood.shiny.semantic usesFomantic UI. Sometimesusing both of these libraries may cause troubles with rendering specificUI elements. That is why by default we turn off Bootstrap dependencies.

However, you can switch off suppressing bootstrap by callingsemanticPage(suppress_bootstrap = FALSE, ...)

We welcome contributions of all types!

We encourage typo corrections, bug reports, bug fixes and featurerequests. Feedback on the clarity of the documentation and examples isespecially valuable.

If you want to contribute to this project please submit a regular PR,once you’re done with new feature or bug fix.

Changes in vignettes

If you modified or added a new vignette, please rebuild them withdevtools::build_vignettes().

Important:

1. Please follow the code style from outstyleguide.

2. We have a ContributorCode of Conduct. Make sure to check it andto follow it.

We used the latest versions of dependencies for this library, so pleaseupdate your R environment before installation.

However, if you encounter any problems, try the following:

1. Up-to-date R language environment
2. Installing specific dependent libraries versions

• shiny

install.packages("shiny",version='1.4')

3. Some bugs may be related directly to Semantic UI. In that caseplease try to check issues on itsrepository.
4. Some bugs may be related toBootstrap. Please make sure you haveit suppressed. Instructions are above inHow to use it? section.

• create all update functions for input components to mimic shiny asclose as possible
• add some glue code indsl.R to make using this package smoother
• adding more semantic components
• new version release on CRAN

Appsilon is aPosit (formerly RStudio) Full Service Certified Partner.
Learn more atappsilon.com.

Get in touchopensource@appsilon.com

Explore theRhinoverse - a family of R packages built aroundRhino!