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.

cascadess

A style pronoun and utilities for {htmltools} tags, {bslib}, and {shiny}.

What can I use cascadess for?

• Change background colors
• Vertically stack action buttons
• Optimize layouts for smaller screens
• Affix an element to the top of the webpage
• Increase or decrease space between html elements
• Force text to upper, lower, or title case

Importantly, cascadess’s styles can be used with any shiny related package. The styles applied by cascadess are based upon the Bootstrap CSS framework. So, rather than conflict, the applied styles are designed to blend with those applied by bslib.

Why a pronoun?

Cascadess defines a style pronoun, .style, usable inside htmltools::tags HTML builder functions. With .style you can specify styling directly within a function call to help a reader understand how the HTML tag element will be styled. Without the .style pronoun, styling is applied after a function call.

input_button(
  .style |>
    margin_all(2) |>
    background_color("primary"),
  id = "go",
  label = "Go!"
)

# vs

input_button(
  id = "go",
  label = "Go!"
) |>
  margin_all(2) |>
  background_color("primary")

Usage

To see the CSS styles, either include a call to cascadess_dependencies() somewhere in the UI of the application or use the bslib package.

div(
  cascadess_dependencies(),
  div(
    .style |>
      margin_all(3) |>
      shadow("lg"),
    "For a standalone report or simple shiny app"
  )
)

page(
  card(
    .style |>
      margin_all(3) |>
      border_color(theme_info()) |>
      font_color(theme_info()),
    "When using bslib, the necessary CSS styles are already included"
  )
)

Installation

Install the package from CRAN with,

install.packages("cascadess")

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.