Declares adjacent columns to be merged in rows matching the parent
compute_cols() condition. Merged columns appear as a single spanned cell.
Arguments
- cols
Tidyselect expression for column selection. Must resolve to at least 2 columns that are consecutive in the report column order.
- styleRef
Character vector or result of
f_combine(). Optional style to apply to the merged cell. If NULL, no special styling.
Value
Quosure structure (internal use within compute_cols())
Details
Must be called inside compute_cols(). Columns must be adjacent in the
final report column order.
See also
compute_cols() for conditional row actions, c_style(), c_addrow() for other action types
Validation:
Immediate: columns exist and are consecutive (error if not)
Deferred: overlapping merge ranges from multiple
compute_cols()calls (warning if resolvable, error if ambiguous)
Behavior:
Multiple merge actions in one row: all applied if non-overlapping
Overlapping merges from different
compute_cols()blocks: raises warning/error
Examples
if (FALSE) { # \dontrun{
spec <- create_table(mtcars) |>
add_style("group_header", s_table_style(background_color = "#D9D9D9"))
# Merge multiple columns for group header
spec <- compute_cols(spec, group == "A",
c_merge(c(col1, col2, col3), styleRef = "group_header"))
# Merge without style
spec <- compute_cols(spec, group == "B", c_merge(c(disp, hp)))
} # }