color: Set font color

In flextable: Functions for Tabular Reporting

Set font color

Description

Change the text color of selected rows and columns of a flextable. A function can be used instead of fixed colors.

When color is a function, it is possible to color cells based on values located in other columns; using hidden columns (those not used by argument colkeys) is a common use case. The argument source must be used to define the columns to be used for the color definition, and the argument j must be used to define where to apply the colors and only accepts values from colkeys.

Usage

color(x, i = NULL, j = NULL, color, part = "body", source = j)

Arguments

x	a 'flextable' object, see flextable-package to learn how to create 'flextable' object.
i	row selector, see section Row selection with the i parameter in <Selectors in flextable>.
j	column selector, see section Column selection with the j parameter in <Selectors in flextable>.
color	color to use as font color. If a function, the function must return a character vector of colors.
part	part selector, see section Part selection with the part parameter in <Selectors in flextable>. Value 'all' can be used.
source	if color is a function, source specifies the dataset column to be used as an argument to color. This is only useful when j is colored with values contained in other columns.

See Also

Other formatting shortcuts: align(), bg(), bold(), empty_blanks(), font(), fontsize(), highlight(), italic(), keep_with_next(), line_spacing(), padding(), rotate(), style(), tab_settings(), valign()

Examples

ft <- flextable(head(mtcars))
ft <- color(ft, color = "orange", part = "header")
ft <- color(ft,
  color = "red",
  i = ~ qsec < 18 & vs < 1
)
ft

if (require("scales")) {
  scale <- scales::col_numeric(domain = c(-1, 1), palette = "RdBu")
  x <- as.data.frame(cor(iris[-5]))
  x <- cbind(
    data.frame(
      colname = colnames(x),
      stringsAsFactors = FALSE
    ),
    x
  )
}

flextable documentation built on June 2, 2026, 9:08 a.m.