A general purpose container for grouping related UI elements together with a
border and optional padding. To learn more about card()
s, see the Cards article or the
other articles listed in the References section below.
card(
...,
full_screen = FALSE,
height = NULL,
max_height = NULL,
min_height = NULL,
fill = TRUE,
class = NULL,
wrapper = card_body,
id = NULL
)
A htmltools::div()
tag.
Unnamed arguments can be any valid child of an htmltools tag (which includes card items such as card_body()
.
Named arguments become HTML attributes on returned UI element.
If TRUE
, an icon will appear when hovering over the card
body. Clicking the icon expands the card to fit viewport size.
Any valid CSS unit (e.g.,
height="200px"
). Doesn't apply when a card is made full_screen
(in this case, consider setting a height
in card_body()
).
Any valid CSS unit (e.g.,
max_height="200px"
). Doesn't apply when a card is made full_screen
(in this case, consider setting a max_height
in card_body()
).
Whether or not to allow the card to grow/shrink to fit a
fillable container with an opinionated height (e.g., page_fillable()
).
Additional CSS classes for the returned UI element.
A function (which returns a UI element) to call on unnamed
arguments in ...
which are not already card item(s) (like
card_header()
, card_body()
, etc.). Note that non-card items are grouped
together into one wrapper
call (e.g. given card("a", "b", card_body("c"), "d")
, wrapper
would be called twice, once with "a"
and
"b"
and once with "d"
).
Provide a unique identifier for the card()
or value_box()
to
report its full screen state to Shiny. For example, using id = "my_card"
,
you can observe the card's full screen state with
input$my_card_full_screen
.
Several articles on the bslib website feature the card component:
Card item functions create the various parts of a card.
navset_card_tab()
, navset_card_pill()
and
navset_card_underline()
create cards with tabbed navigation.
layout_columns()
and layout_column_wrap()
help position multiple
cards into columns and rows and can also be used inside a card.
layout_sidebar()
adds a sidebar to a card when nested in card()
or card_body()
.
value_box()
uses card()
to highlight a showcase a key piece of
information.
Other Components:
accordion()
,
popover()
,
tooltip()
,
value_box()
if (FALSE) { # rlang::is_interactive()
library(htmltools)
card(
full_screen = TRUE,
card_header(
"This is the header"
),
card_body(
p("This is the body."),
p("This is still the body.")
),
card_footer(
"This is the footer"
)
)
}
Run the code above in your browser using DataLab