cells_stub {gt} | R Documentation |
Location helper for targeting cells in the table stub
Description
The cells_stub()
function is used to target the table's stub cells and it
is useful when applying a footnote with tab_footnote()
or adding a custom
style with tab_style()
. The function is expressly used in each of those
functions' locations
argument. Here are several ways that a stub location
might be available in a gt table: (1) through specification of a
rowname_col
in gt()
, (2) by introducing a data frame with row names to
gt()
with rownames_to_stub = TRUE
, or (3) by using summary_rows()
or
grand_summary_rows()
with neither of the previous two conditions being
true.
Usage
cells_stub(rows = everything())
Arguments
rows |
Rows to target
The rows to which targeting operations are constrained. The default
|
Value
A list object with the classes cells_stub
and location_cells
.
Overview of location helper functions
Location helper functions can be used to target cells with virtually any
function that has a locations
argument. Here is a listing of all of the
location helper functions, with locations corresponding roughly from top to
bottom of a table:
-
cells_title()
: targets the table title or the table subtitle depending on the value given to thegroups
argument ("title"
or"subtitle"
). -
cells_stubhead()
: targets the stubhead location, a cell of which is only available when there is a stub; a label in that location can be created by using thetab_stubhead()
function. -
cells_column_spanners()
: targets the spanner column labels with thespanners
argument; spanner column labels appear above the column labels. -
cells_column_labels()
: targets the column labels with itscolumns
argument. -
cells_row_groups()
: targets the row group labels in any available row groups using thegroups
argument. -
cells_stub()
: targets row labels in the table stub using therows
argument. -
cells_body()
: targets data cells in the table body using intersections ofcolumns
androws
. -
cells_summary()
: targets summary cells in the table body using thegroups
argument and intersections ofcolumns
androws
. -
cells_grand_summary()
: targets cells of the table's grand summary using intersections ofcolumns
androws
-
cells_stub_summary()
: targets summary row labels in the table stub using thegroups
androws
arguments. -
cells_stub_grand_summary()
: targets grand summary row labels in the table stub using therows
argument. -
cells_footnotes()
: targets all footnotes in the table footer (cannot be used withtab_footnote()
). -
cells_source_notes()
: targets all source notes in the table footer (cannot be used withtab_footnote()
).
When using any of the location helper functions with an appropriate function
that has a locations
argument (e.g., tab_style()
), multiple locations
can be targeted by enclosing several cells_*()
helper functions in a
list()
(e.g., list(cells_body(), cells_grand_summary())
).
Examples
Using a transformed version of the sza
dataset, let's create a gt
table. Color all of the month
values in the table stub with tab_style()
,
using cells_stub()
in locations
.
sza |> dplyr::filter(latitude == 20 & tst <= "1000") |> dplyr::select(-latitude) |> dplyr::filter(!is.na(sza)) |> tidyr::spread(key = "tst", value = sza) |> gt(rowname_col = "month") |> sub_missing(missing_text = "") |> tab_style( style = list( cell_fill(color = "darkblue"), cell_text(color = "white") ), locations = cells_stub() )
Function ID
8-16
Function Introduced
v0.2.0.5
(March 31, 2020)
See Also
Other helper functions:
adjust_luminance()
,
cell_borders()
,
cell_fill()
,
cell_text()
,
cells_body()
,
cells_column_labels()
,
cells_column_spanners()
,
cells_footnotes()
,
cells_grand_summary()
,
cells_row_groups()
,
cells_source_notes()
,
cells_stub_grand_summary()
,
cells_stub_summary()
,
cells_stubhead()
,
cells_summary()
,
cells_title()
,
currency()
,
default_fonts()
,
define_units()
,
escape_latex()
,
from_column()
,
google_font()
,
gt_latex_dependencies()
,
html()
,
md()
,
nanoplot_options()
,
pct()
,
px()
,
random_id()
,
stub()
,
system_fonts()