row_group_order: Modify the ordering of any row groups

In gt: Easily Create Presentation-Ready Display Tables

Modify the ordering of any row groups

Description

We can modify the display order of any row groups in a gt object with the row_group_order() function. The groups argument takes a vector of row group ID values. After this function is invoked, the row groups will adhere to this revised ordering. It isn't necessary to provide all row ID values in groups, rather, what is provided will assume the specified ordering at the top of the table and the remaining row groups will follow in their original ordering.

Usage

row_group_order(data, groups)

Arguments

data	A table object that is created using the gt() function.
groups	A character vector of row group ID values corresponding to the revised ordering. While this vector must contain valid group ID values, it is not required to have all of the row group IDs within it; any omitted values will be added to the end while preserving the original ordering.

Value

An object of class gt_tbl.

Examples

Use exibble to create a gt table with a stub and with row groups. Modify the order of the row groups with row_group_order(), specifying the new ordering in groups.

exibble %>%
  dplyr::select(char, currency, row, group) %>%
  gt(
    rowname_col = "row",
    groupname_col = "group"
  ) %>%
  row_group_order(groups = c("grp_b", "grp_a"))

Function ID

5-3

See Also

Other row addition/modification functions: grand_summary_rows(), summary_rows()

gt documentation built on Nov. 17, 2022, 1:07 a.m.