Color a numeric gt column and add a matching continuous legend — gtscale_data_color

This is the primary interface for continuous scales in gtscales.

Usage

gtscale_data_color_continuous(
  data,
  column,
  palette = NULL,
  domain = NULL,
  breaks = NULL,
  labels = NULL,
  title = NULL,
  transform = NULL,
  oob = NULL,
  direction = "to right",
  width = "160px",
  height = "14px",
  apply_to = c("fill", "text"),
  na_color = NULL,
  alpha = NULL,
  reverse = FALSE,
  autocolor_text = TRUE,
  contrast_algo = c("apca", "wcag"),
  autocolor_light = "#FFFFFF",
  autocolor_dark = "#000000",
  fn = NULL
)

Arguments

data: A gt_tbl created by gt::gt().
column: A numeric column to color and legendize.
palette: A vector of colors used in the table and legend gradient. A single named palette or palette function can also be supplied.
domain: A numeric vector of length 2 giving the scale limits. When omitted, the limits are inferred from column.
breaks: Optional break values or a break function to display below the gradient.
labels: An optional labeling function or a character vector for the breaks.
title: Optional legend title.
transform: A transformation specification understood by scales::as.transform(). When omitted, an appropriate transform is inferred from the data.
oob: Out-of-bounds handling function or shortcut. Use a function like scales::oob_squish() or a shortcut such as "censor", "squish", "keep", or "discard".
direction: CSS gradient direction. Defaults to "to right".
width: Width of the legend bar.
height: Height of the legend bar.
apply_to: Whether colors should be applied to cell fill or text.
na_color: Color used for missing values.
alpha: Alpha applied by gt::data_color().
reverse: Whether to reverse the color mapping.
autocolor_text: Whether to automatically adjust text color.
contrast_algo: Contrast algorithm passed to gt::data_color().
autocolor_light: Light text color used by gt::data_color().
autocolor_dark: Dark text color used by gt::data_color().
fn: Optional scales function passed to gt::data_color(). For the legend, palette is preferred because it is more reliable than inspecting closure internals.

Value

A modified gt::gt table.

Examples

library(gt)

exibble |>
  gt() |>
  gtscale_data_color_continuous(
    column = num,
    palette = c('#A0442C', 'white', '#0063B1'),
    title = 'Value'
  )


  num
      char
      fctr
      date
      time
      datetime
      currency
      row
      group
    
1.111e-01
apricot
one
2015-01-15
13:35
2018-01-01 02:22
49.950
row_1
grp_a
2.222e+00
banana
two
2015-02-15
14:40
2018-02-02 14:33
17.950
row_2
grp_a
3.333e+01
coconut
three
2015-03-15
15:45
2018-03-03 03:44
1.390
row_3
grp_a
4.444e+02
durian
four
2015-04-15
16:50
2018-04-04 15:55
65100.000
row_4
grp_a
5.550e+03
NA
five
2015-05-15
17:55
2018-05-05 04:00
1325.810
row_5
grp_b
NA
fig
six
2015-06-15
NA
2018-06-06 16:11
13.255
row_6
grp_b
7.770e+05
grapefruit
seven
NA
19:10
2018-07-07 05:22
NA
row_7
grp_b
8.880e+06
honeydew
eight
2015-08-15
20:20
NA
0.440
row_8
grp_b
Value
2,000,0004,000,0006,000,0008,000,000

num	char	fctr	date	time	datetime	currency	row	group
1.111e-01	apricot	one	2015-01-15	13:35	2018-01-01 02:22	49.950	row_1	grp_a
2.222e+00	banana	two	2015-02-15	14:40	2018-02-02 14:33	17.950	row_2	grp_a
3.333e+01	coconut	three	2015-03-15	15:45	2018-03-03 03:44	1.390	row_3	grp_a
4.444e+02	durian	four	2015-04-15	16:50	2018-04-04 15:55	65100.000	row_4	grp_a
5.550e+03	NA	five	2015-05-15	17:55	2018-05-05 04:00	1325.810	row_5	grp_b
NA	fig	six	2015-06-15	NA	2018-06-06 16:11	13.255	row_6	grp_b
7.770e+05	grapefruit	seven	NA	19:10	2018-07-07 05:22	NA	row_7	grp_b
8.880e+06	honeydew	eight	2015-08-15	20:20	NA	0.440	row_8	grp_b
Value 2,000,0004,000,0006,000,0008,000,000