as_word: Output a *gt* object as Word

In gt: Easily Create Presentation-Ready Display Tables

Output a gt object as Word

Description

Get the Open Office XML table tag content from a gt_tbl object as a single-element character vector.

Usage

as_word(
  data,
  align = "center",
  caption_location = c("top", "bottom", "embed"),
  caption_align = "left",
  split = FALSE,
  keep_with_next = TRUE
)

Arguments

data	The gt table data object ⁠obj:<gt_tbl>⁠ // required This is the gt table object that is commonly created through use of the gt() function.
align	Table alignment ⁠scalar<character>⁠ // default: "center" An option for table alignment. Can either be "center", "left", or "right".
caption_location	Caption location ⁠singl-kw:[top|bottom|embed]⁠ // default: "top" Determines where the caption should be positioned. This can either be "top", "bottom", or "embed".
caption_align	Caption alignment Determines the alignment of the caption. This is either "left" (the default), "center", or "right". This option is only used when caption_location is not set as "embed".
split	Allow splitting of a table row across pages ⁠scalar<logical>⁠ // default: FALSE A logical value that indicates whether to activate the Word option ⁠Allow row to break across pages⁠.
keep_with_next	Keeping rows together ⁠scalar<logical>⁠ // default: TRUE A logical value that indicates whether a table should use Word option ⁠Keep rows together⁠.

Examples

Use a subset of the gtcars dataset to create a gt table. Add a header with tab_header() and then export the table as OOXML code for Word using as_word()

tab_rtf <-
  gtcars |>
  dplyr::select(mfr, model) |>
  dplyr::slice(1:2) |>
  gt() |>
  tab_header(
    title = md("Data listing from **gtcars**"),
    subtitle = md("`gtcars` is an R dataset")
  ) |>
  as_word()

Function ID

13-5

Function Introduced

v0.7.0 (August 25, 2022)

See Also

Other table export functions: as_gtable(), as_latex(), as_raw_html(), as_rtf(), extract_body(), extract_cells(), extract_summary(), gtsave()

gt documentation built on April 12, 2025, 1:26 a.m.