cells_column_spanners()
is used to target the cells that
contain the table column spanners. This is useful when applying a footnote
with tab_footnote()
or adding custom style with tab_style()
. The function
is expressly used in each of those functions' locations
argument. The
'column_spanners' location is generated by one or more uses of the
tab_spanner()
function or the tab_spanner_delim()
function.
Usage
cells_column_spanners(spanners = everything())
Arguments
- spanners
Specification of spanner IDs
<spanner-targeting expression>
// default:everything()
The spanners to which targeting operations are constrained. Can either be a series of spanner ID values provided in
c()
or a select helper function. Examples of select helper functions includestarts_with()
,ends_with()
,contains()
,matches()
,one_of()
,num_range()
, andeverything()
.
Examples
Use the exibble
dataset to create a gt table. We'll add a spanner
column label over three columns (date
, time
, and datetime
) with
tab_spanner()
. The spanner column label can be styled with tab_style()
by
using the cells_column_spanners()
function in locations
. In this example,
we are making the text of the column spanner label appear as bold.
exibble |>
dplyr::select(-fctr, -currency, -group) |>
gt(rowname_col = "row") |>
tab_spanner(
label = "dates and times",
columns = c(date, time, datetime),
id = "dt"
) |>
tab_style(
style = cell_text(weight = "bold"),
locations = cells_column_spanners(spanners = "dt")
)
See also
Other location helper functions:
cells_body()
,
cells_column_labels()
,
cells_footnotes()
,
cells_grand_summary()
,
cells_row_groups()
,
cells_source_notes()
,
cells_stub()
,
cells_stub_grand_summary()
,
cells_stub_summary()
,
cells_stubhead()
,
cells_summary()
,
cells_title()
,
location-helper