opt_horizontal_padding: Option to expand or contract horizontal padding

View source: R/opts.R

opt_horizontal_paddingR Documentation

Option to expand or contract horizontal padding


Increase or decrease the horizontal padding throughout all locations of a gt table by use of a scale factor, which here is defined by a real number between 0 and 3. This function serves as a shortcut for setting the following eight options in tab_options():

  • heading.padding.horizontal

  • column_labels.padding.horizontal

  • data_row.padding.horizontal

  • row_group.padding.horizontal

  • summary_row.padding.horizontal

  • grand_summary_row.padding.horizontal

  • footnotes.padding.horizontal

  • source_notes.padding.horizontal


opt_horizontal_padding(data, scale = 1)



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.


Scale factor

⁠scalar<numeric|integer>(0>=val>=3)⁠ // default: 1

A scale factor by which the horizontal padding will be adjusted. Must be a number between 0 and 3.


An object of class gt_tbl.


Use the exibble dataset to create a gt table with a number of table parts added (using functions like summary_rows(), grand_summary_rows(), and more). Following that, we'll increase the amount of horizontal padding across the entire table with opt_horizontal_padding(). Using a scale value of 3 (up from the default of 1) means the the horizontal space will be greatly increased, resulting in a more spacious table.

exibble |>
  gt(rowname_col = "row", groupname_col = "group") |>
    groups = "grp_a",
    columns = c(num, currency),
    fns = c("min", "max")
  ) |>
    columns = currency,
    fns = total ~ sum(., na.rm = TRUE)
  ) |>
  tab_source_note(source_note = "This is a source note.") |>
    footnote = "This is a footnote.",
    locations = cells_body(columns = 1, rows = 1)
  ) |>
    title = "The title of the table",
    subtitle = "The table's subtitle"
  ) |>
  opt_horizontal_padding(scale = 3)
This image of a table was generated from the first code example in the `opt_horizontal_padding()` help file.

Function ID


Function Introduced

v0.4.0 (February 15, 2022)

See Also

Other table option functions: opt_align_table_header(), opt_all_caps(), opt_css(), opt_footnote_marks(), opt_footnote_spec(), opt_interactive(), opt_row_striping(), opt_stylize(), opt_table_font(), opt_table_lines(), opt_table_outline(), opt_vertical_padding()

gt documentation built on June 22, 2024, 11:11 a.m.