loc.subtitle

Target the table subtitle.

Usage

Source

loc.subtitle()

With loc.subtitle(), we can target the part of table containing the subtitle (within the table header). This is useful for applying custom styling with the tab_style() method. That method has a locations= argument and this class should be used there to perform the targeting.

Returns

LocSubTitle

A LocSubTitle object, which is used for a locations= argument if specifying the subtitle of the table.

Examples

Let’s use a subset of the gtcars dataset in a new table. We will style only the ‘subtitle’ part of the table header (leaving the ‘title’ part unaffected). This can be done by using locations=loc.subtitle() within tab_style().

from great_tables import GT, style, loc
from great_tables.data import gtcars

(
    GT(gtcars[["mfr", "model", "msrp"]].head(5))
    .tab_header(
        title="Select Cars from the gtcars Dataset",
        subtitle="Only the first five cars are displayed"
    )
    .tab_style(
        style=style.fill(color="lightblue"),
        locations=loc.subtitle()
    )
    .fmt_currency(columns="msrp", decimals=0)
)

Select Cars from the gtcars Dataset
Only the first five cars are displayed
mfr	model	msrp
Ford	GT	$447,000
Ferrari	458 Speciale	$291,744
Ferrari	458 Spider	$263,553
Ferrari	458 Italia	$233,509
Ferrari	488 GTB	$245,400