gtUtils theme for gt tables — gt_theme

The package's house theme. A warm cream background, an Almarai body, Signika Negative titles, column labels and row groups, hairline separators between rows, and gray row-group bands carrying cream labels. All columns are centered.

Usage

gt_theme_gtutils(
  gt_object,
  density = c("comfortable", "compact", "social"),
  ...
)

Arguments

gt_object: A gt table object to modify.
density: Character. The type and padding scale. One of "comfortable", "compact", or "social". See Density. Defaults to "comfortable".
...: Additional arguments passed to gt::tab_options, applied last so they override anything the theme sets.

Value

Returns a modified gt table with the theme applied.

Details

The row separators are a single bottom border in gray (#8A817C) applied to every body row except the last, so the table closes on the background rather than a rule. The background is a warm cream (#FFFDF5), and horizontal rules are otherwise set transparent. A table id is resolved (or generated) up front so the gt::opt_css() block can pin the closing row border and heading padding to this table alone. density rescales the finished table, since this theme sets its sizes directly rather than deriving them from a scale.

Density

density scales the theme's type and row padding together. "comfortable" leaves every size as the theme sets it, "compact" scales both down, and "social" scales both up, to the scale gt_save_crop() and gt_social_crop() export at.

Figures

Examples

library(gt)
gt(head(mtcars)) %>% gt_theme_gtutils()


  mpg
      cyl
      disp
      hp
      drat
      wt
      qsec
      vs
      am
      gear
      carb
    
21.0
6
160
110
3.90
2.620
16.46
0
1
4
4
21.0
6
160
110
3.90
2.875
17.02
0
1
4
4
22.8
4
108
93
3.85
2.320
18.61
1
1
4
1
21.4
6
258
110
3.08
3.215
19.44
1
0
3
1
18.7
8
360
175
3.15
3.440
17.02
0
0
3
2
18.1
6
225
105
2.76
3.460
20.22
1
0
3
1
gt(head(mtcars)) %>% gt_theme_gtutils(density = "compact")


  mpg
      cyl
      disp
      hp
      drat
      wt
      qsec
      vs
      am
      gear
      carb
    
21.0
6
160
110
3.90
2.620
16.46
0
1
4
4
21.0
6
160
110
3.90
2.875
17.02
0
1
4
4
22.8
4
108
93
3.85
2.320
18.61
1
1
4
1
21.4
6
258
110
3.08
3.215
19.44
1
0
3
1
18.7
8
360
175
3.15
3.440
17.02
0
0
3
2
18.1
6
225
105
2.76
3.460
20.22
1
0
3
1

mpg	cyl	disp	hp	drat	wt	qsec	vs	am	gear	carb
21.0	6	160	110	3.90	2.620	16.46	0	1	4	4
21.0	6	160	110	3.90	2.875	17.02	0	1	4	4
22.8	4	108	93	3.85	2.320	18.61	1	1	4	1
21.4	6	258	110	3.08	3.215	19.44	1	0	3	1
18.7	8	360	175	3.15	3.440	17.02	0	0	3	2
18.1	6	225	105	2.76	3.460	20.22	1	0	3	1