In this tutorial we will walk you through the basics of shiny.semantic.

Quick Q&A

First of all, let’s answer a few questions:

  • Why do I need shiny.semantic?

You can build your Shiny apps with standard shiny UI that relies on Bootstrap. This means that Shiny attaches CSS and JS code that is responsible for its neat look. However, after a while you might notice that all apps made this way tend to look quite similar. shiny.semantic helps you to add a fresh look to your web application by providing an alternative UI framework that works under the hood.

  • What shiny.semantic has to do with Fomantic UI?

Similarly to Shiny attaching Bootstrap CSS and JS libraries, shiny.semantic relies on Fomantic UI. Historically, we built this package around Semantic UI library, but it got deprecated and now (since December 2019) we rely on the well-supported and maintained community fork called Fomantic UI.

  • Do I need to learn a new syntax to be able to use it?

Not at all! For your convenience, we created wrappers of the most popular functions that you know from Shiny. For example, you can create an action button using a snake case (which is a shiny.semantic standard): action_button, or you can use, more familiar from Shiny, camel case with consistent parameters: actionButton.

Note, however, that the philosophy behind the Bootstrap and Fomantic is quite different, so some behaviour might also differ. Usually shiny.semantic warns you or you can learn more about it from documentation of a specific function.

  • Can I use standard Shiny components with shiny.semantic?

It depends. In general, to be able to render shiny.semantic components correctly, your app UI code must be surrounded by semanticPage (equivalent of fluidPage) function that switches off standard Bootstrap dependencies. Thus some components from Shiny might look just bad, but don’t worry - most of them have shiny.semantic alternatives. Having said that, all of standard HTML elements from Shiny should work just fine (like shiny::div or shiny::h2).

How to use shiny.semantic?

You can use shiny.semantic in two ways:

(a) Using Fomantic CSS classes

If you know this and that about web development, you can create a number of components by extending standard Shiny objects with class definitions from Fomantic UI documentation. For example:

div(class = "ui raised segment",
  div(
    a(class="ui green ribbon label", "Link"),
    p("Lorem ipsum, lorem ipsum, lorem ipsum"),
    actionButton("button", "Click")
  )
)

(b) Using predefined objects

If you are not that comfortable with web development, you can take advantage of the number of elements that we implemented for you. See some examples below:

range_input("range", 10, 15, 0, 20)
text_input("txt", type = "text", placeholder = "Enter Text")
date_input("date")

For more components visit our Components live demo website or the examples/ folder on our repository.

Little sneak-peak of what you can get is listed on the graphics below. Most of the components you may insert with just single line of code!

compoents

If you want to learn how to use a particular UI component, check its documentation. For example, you can call in RStudio (to see the docs for a counter button):

?counter_button

or use our documentation website.

All examples come with easy to use code snippets that will help you get started. We hope that this short overview was useful. Good luck with building your first amazing app with shiny.semantic :)