Merge cells across rows or down columns

merge_across() creates multicolumn cells within each row. merge_down() creates multirow cells within each column.

Usage

merge_across(ht, row, col)

merge_down(ht, row, col)

Arguments

ht

A huxtable.

row

A row specifier. See rowspecs for details.

col

An optional column specifier.

Value

The ht object.

Cell content

In merged cell ranges, only the top left cell's content is displayed. In addition, when you merge cells (either by setting colspan() or rowspan(), or using merge_cells() and friends) the content of the top left cell is copied to other cells. This prevents unexpected changes to content if you reorder or subset rows and columns.

See also

Other cell merging: merge_cells(), merge_repeated_rows()

Examples

ht <- as_hux(matrix(1:12, 4, 3, byrow = TRUE))
ht <- set_all_borders(ht, 1)
merge_across(ht, 2:4, 2:3)
#>                            ┌───────┬───────┬───────┐
#>                            │     1 │     2 │     3 │
#>                            ├───────┼───────┴───────┤
#>                            │     4 │          5    │
#>                            ├───────┼───────────────┤
#>                            │     7 │          8    │
#>                            ├───────┼───────────────┤
#>                            │    10 │         11    │
#>                            └───────┴───────────────┘
#> 
#> Column names: V1, V2, V3
merge_down(ht, 2:4, 2:3)
#>                            ┌───────┬───────┬───────┐
#>                            │     1 │     2 │     3 │
#>                            ├───────┼───────┼───────┤
#>                            │     4 │     5 │     6 │
#>                            ├───────┤       │       │
#>                            │     7 │       │       │
#>                            ├───────┤       │       │
#>                            │    10 │       │       │
#>                            └───────┴───────┴───────┘
#> 
#> Column names: V1, V2, V3