Specify a font from the Google Fonts service.
The google_font() helper function can be used wherever a font name might be specified. There are two instances where this helper can be used:
opt_table_font(font=...) (for setting a table font)style.text(font=...) (itself used in tab_style())name : strThe name of the Google Font to use.
: GoogleFontA GoogleFont object, which contains the name of the font and methods for incorporating the font in HTML output tables.
Let’s use the exibble dataset to create a table of two columns and eight rows. We’ll replace missing values with em dashes using sub_missing(). For text in the time column, we will use the font called "IBM Plex Mono" which is available from Google Fonts. This is defined inside the google_font() call, itself within the style.text() method that’s applied to the style= parameter of tab_style().
from great_tables import GT, exibble, style, loc, google_font
(
GT(exibble[["char", "time"]])
.sub_missing()
.tab_style(
style=style.text(font=google_font(name="IBM Plex Mono")),
locations=loc.body(columns="time")
)
)| char | time |
|---|---|
| apricot | 13:35 |
| banana | 14:40 |
| coconut | 15:45 |
| durian | 16:50 |
| — | 17:55 |
| fig | — |
| grapefruit | 19:10 |
| honeydew | 20:20 |
We can use a subset of the sp500 dataset to create a small table. With fmt_currency(), we can display values as monetary values. Then, we’ll set a larger font size for the table and opt to use the "Merriweather" font by calling google_font() within opt_table_font(). In cases where that font may not materialize, we include two font fallbacks: "Cochin" and the catchall "Serif" group.
from great_tables import GT, google_font
from great_tables.data import sp500
(
GT(sp500.drop(columns=["volume", "adj_close"]).head(10))
.fmt_currency(columns=["open", "high", "low", "close"])
.tab_options(table_font_size="20px")
.opt_table_font(font=[google_font(name="Merriweather"), "Cochin", "Serif"])
)| date | open | high | low | close |
|---|---|---|---|---|
| 2015-12-31 | $2,060.59 | $2,062.54 | $2,043.62 | $2,043.94 |
| 2015-12-30 | $2,077.34 | $2,077.34 | $2,061.97 | $2,063.36 |
| 2015-12-29 | $2,060.54 | $2,081.56 | $2,060.54 | $2,078.36 |
| 2015-12-28 | $2,057.77 | $2,057.77 | $2,044.20 | $2,056.50 |
| 2015-12-24 | $2,063.52 | $2,067.36 | $2,058.73 | $2,060.99 |
| 2015-12-23 | $2,042.20 | $2,064.73 | $2,042.20 | $2,064.29 |
| 2015-12-22 | $2,023.15 | $2,042.74 | $2,020.49 | $2,038.97 |
| 2015-12-21 | $2,010.27 | $2,022.90 | $2,005.93 | $2,021.15 |
| 2015-12-18 | $2,040.81 | $2,040.81 | $2,005.33 | $2,005.55 |
| 2015-12-17 | $2,073.76 | $2,076.37 | $2,041.66 | $2,041.89 |