The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]metanet.ch.
{bs4Dash}
relies on the same basis as
{shinydashboard}
, that is the AdminLTE HTML template, except the version
is higher (3.1.0 vs 2.4). The biggest difference is the dependence on
Bootstrap 4, which is not natively supported by {Shiny}
.
That’s why elements like tabsetPanel()
,
actionButton()
, … have been rewritten to provide full
Bootstrap4 support. In addition, {bs4Dash}
comes with extra
elements that will help you to develop Shiny apps with a more
professional look and feel. Below is a summary of the main features:
Features (sample) | shinydashboard | shinydashboardPlus | bs4Dash |
---|---|---|---|
Popover, tooltips enhanced support | ❌ | ❌ | ✅ |
Fullscreen toggle | ❌ | ❌ | ✅ |
dark/light skin switch | ❌ | ❌ | ✅ |
right sidebar (controlbar) | ❌ | ✅ | ✅ |
semi collapsible sidebar (sidebar mini) | ❌ | ✅ | ✅ |
expand on hover sidebar | ❌ | ✅ | ✅ |
closable boxes | ❌ | ✅ | ✅ |
box sidebar | ❌ | ✅ | ✅ |
get box state on the server (open, closed, …) | ❌ | ✅ | ✅ |
control sidebars on the server | ❌ | ✅ | ✅ |
dashboard user dropdown | ❌ | ✅ | ✅ |
theme selector | ❌ | ✅ | ✅ |
social box | ❌ | ✅ | ✅ |
user box | ❌ | ✅ | ✅ |
control AdminLTE options | ❌ | ✅ | |
seamlessly customize appearance | ❌ | ✅ | ✅ |
beautiful preloaders | ❌ | ✅ | ✅ |
scroll to top button! | ❌ | ✅ | ✅ |
Since the 2.0.0 release, {bs4Dash}
overwrites most of
the {shinydashboard}
functions such as
dashboardPage()
and box()
to facilitate the
transition from one package to another.
v2.0.0 is clearly a major breaking change for
{bs4Dash}
. It means that coming from v0.5.0 (latest CRAN
version to date), you will have to rewrite part of the code. It was not
an easy decision to take but necessary to improve the package quality
(naming consistency, …). Now the transition from
{shinydashboard}
to {bs4Dash}
will be easier
since function parameters have been harmonized. The reverse is not
always guaranteed because of the number of extra parameters in
{bs4Dash}
.
Under the hood, functions are safer and more controls are done on the user inputs to reduce the risk of accidentally providing wrong values.
The most exiting features of 2.0.0 are probably the ability to
leverage the awesome {fresh}
package (see here
for more details) through the dashboardPage()
freshTheme parameter. Additionally, the
skinSelector()
allows to dynamically change the dashboard
skin on the client side. There are also more update_
functions to programmatically control elements from the server. Now the
dashboardSidebar()
may be collapsed, so is the
dashboardControlbar()
. The dashboardPage()
options parameter is an easy way to fine tune the AdminLTE
behavior (see here
for the list of available options). The box()
component has
been reworked to reduce the number of parameters and include new
sub-components like the boxSidebar()
that may be
programmatically collapsed, or the boxLabel()
.
box()
has an input binding indicating its current state on
the server side, to perform specific tasks. Finally, colors are better
documented thanks to Victor Perrier from dreamRs. For instance, the
primary color is shown as ,
danger is ,
which eventually helps users to choose between all available
options.
Below is a simple app you may build with {bs4Dash}
.
Interestingly, you’ll be able to notice the scroll to top button feature
if you scroll to the bottom (bottom-right corner), as well as the live
theme switcher in the navigation bar that goes from light to dark. This
new feature is exclusive to {bs4Dash}
.
library(shiny)
library(bs4Dash)
shinyApp(
ui = dashboardPage(
header = dashboardHeader(
title = dashboardBrand(
title = "My dashboard",
color = "primary",
href = "https://adminlte.io/themes/v3",
image = "https://adminlte.io/themes/v3/dist/img/AdminLTELogo.png"
)
),
sidebar = dashboardSidebar(),
body = dashboardBody(
lapply(getAdminLTEColors(), function(color) {
box(status = color)
})
),
controlbar = dashboardControlbar(),
title = "DashboardPage"
),
server = function(input, output) { }
)
These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.