flextable: add_body – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

add_body

Add rows in body part

Description

Add rows in the flextable's body. It can be inserted at the top or the bottom. The function is column oriented, labels are specified for each columns, there can be more than a value - resulting in more than a new row.

Usage

add_body(x, top = TRUE, ..., values = NULL)

Arguments

`x`	a `flextable` object
`top`	should the rows be inserted at the top or the bottom.
`...`	a named list (names are data colnames) of strings specifying corresponding values to add. It is important to insert data of the same type as the original data, otherwise it will be transformed (probably into strings if you add a `character' where a` double' is expected). This keeps the ability to format cell contents with the `colformat_*` functions, for example `colformat_num()`.
`values`	a list of name-value pairs of labels or values, names should be existing col_key values. This argument can be used instead of `...` for programming purpose (If `values` is supplied argument `...` is ignored).

Examples

ft <- flextable(head(iris),
  col_keys = c(
    "Species", "Sepal.Length", "Petal.Length",
    "Sepal.Width", "Petal.Width"
  )
)

ft <- add_body(
  x = ft, Sepal.Length = 1:5,
  Sepal.Width = 1:5 * 2, Petal.Length = 1:5 * 3,
  Petal.Width = 1:5 + 10, Species = "Blah", top = FALSE
)

ft <- theme_booktabs(ft)
ft

flextable

Functions for Tabular Reporting

v0.6.10

GPL-3

Authors

David Gohel [aut, cre], Clementine Jager [ctb], Quentin Fazilleau [ctb], Maxim Nazarov [ctb] (rmarkdown for docx output), Titouan Robert [ctb], Michael Barrowman [ctb] (inline footnotes), Atsushi Yasumoto [ctb] (support for bookdown cross reference), Paul Julian [ctb] (support for gam objects)

Initial release