Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free
tab_spanner
Add a spanner column label
Description
Set a spanner column label by mapping it to columns already in the table. This label is placed above one or more column labels, spanning the width of those columns and column labels.
Usage
tab_spanner(data, label, columns, gather = TRUE)
Arguments
data |
A table object that is created using the |
label |
The text to use for the spanner column label. |
columns |
The columns to be components of the spanner heading. |
gather |
An option to move the specified |
Value
An object of class gt_tbl.
Figures
Function ID
2-2
See Also
Other Create or Modify Parts:
tab_footnote(),
tab_header(),
tab_options(),
tab_row_group(),
tab_source_note(),
tab_spanner_delim(),
tab_stubhead(),
tab_style()
Examples
# Use `gtcars` to create a gt table;
# Group several columns related to car
# performance under a spanner column
# with the label `performance`
tab_1 <-
gtcars %>%
dplyr::select(
-mfr, -trim, bdy_style, drivetrain,
-drivetrain, -trsmn, -ctry_origin
) %>%
dplyr::slice(1:8) %>%
gt(rowname_col = "model") %>%
tab_spanner(
label = "performance",
columns = vars(
hp, hp_rpm, trq, trq_rpm,
mpg_c, mpg_h)
)