Target column labels.
With loc.column_labels(), we can target the cells containing the column labels. 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.
columns : SelectExpr = NoneThe columns to target. Can either be a single column name or a series of column names provided in a list. If no columns are specified, all columns are targeted.
: LocColumnLabelsA LocColumnLabels object, which is used for a locations= argument if specifying the table’s column labels.
Let’s use a subset of the gtcars dataset in a new table. We will style all three of the column labels by using locations=loc.column_labels() within tab_style(). Note that no specification of columns= is needed here because we want to target all columns.
from great_tables import GT, style, loc
from great_tables.data import gtcars
(
GT(gtcars[["mfr", "model", "msrp"]].head(5))
.tab_style(
style=style.text(color="blue", size="large", weight="bold"),
locations=loc.column_labels()
)
)| mfr | model | msrp |
|---|---|---|
| Ford | GT | 447000.0 |
| Ferrari | 458 Speciale | 291744.0 |
| Ferrari | 458 Spider | 263553.0 |
| Ferrari | 458 Italia | 233509.0 |
| Ferrari | 488 GTB | 245400.0 |