sprinkle_bg {pixiedust} | R Documentation |
Sprinkle the Background Color of a Cell
Description
Background colors may be used to highlight the contents
of cells, rows, or columns. Most commonly, backgrounds are used to
provide row discrimination; the sprinkle_bg_pattern
function
is better suited to that purpose.
Usage
sprinkle_bg(
x,
rows = NULL,
cols = NULL,
bg = "",
part = c("body", "head", "foot", "interfoot", "table"),
fixed = FALSE,
recycle = c("none", "rows", "cols", "columns"),
...
)
## Default S3 method:
sprinkle_bg(
x,
rows = NULL,
cols = NULL,
bg = "",
part = c("body", "head", "foot", "interfoot", "table"),
fixed = FALSE,
recycle = c("none", "rows", "cols", "columns"),
...
)
## S3 method for class 'dust_list'
sprinkle_bg(
x,
rows = NULL,
cols = NULL,
bg = "",
part = c("body", "head", "foot", "interfoot", "table"),
fixed = FALSE,
recycle = c("none", "rows", "cols", "columns"),
...
)
sprinkle_background(
x,
rows = NULL,
cols = NULL,
bg = "",
part = c("body", "head", "foot", "interfoot", "table"),
fixed = FALSE,
recycle = c("none", "rows", "cols", "columns"),
...
)
Arguments
x |
An object of class |
rows |
Either a numeric vector of rows in the tabular object to be
modified or an object of class |
cols |
Either a numeric vector of columns in the tabular object to be modified, or a character vector of column names. A mixture of character and numeric indices is permissible. |
bg |
|
part |
A character string denoting which part of the table to modify. |
fixed |
|
recycle |
A |
... |
Additional arguments to pass to other methods. Currently ignored. |
Details
Colors may be a dvips color name, or in the rgb(R, G, B), rgba(R, G, B, A), #RRGGBB, or #RRGGBBAA formats.
This sprinkle is ignored in console and markdown outputs. HTML output will accept any of the color formats and recognize transparency. LaTeX output will accept any of the color formats but ignore transparency.
As long as bg
is required to be a character(1)
, the
recycle
argument is kind of useless. It is included to maintain
consistency with the index_to_sprinkle
function. Future development
may permit a character vector of colors.
Functional Requirements
Correctly reassigns the appropriate elements
bg
column in the table part.Casts an error if
x
is not adust
object.Casts an error if
bg
is not acharacter(1)
Casts an error if
bg
is not a valid color format.Casts an error if
part
is not one of"body"
,"head"
,"foot"
, or"interfoot"
Casts an error if
fixed
is not alogical(1)
Casts an error if
recycle
is not one of"none"
,"rows"
, or"cols"
Casts an error if
recycle = "none"
andbg
does not have length 1.
The functional behavior of the fixed
and recycle
arguments
is not tested for this function. It is tested and validated in the
tests for index_to_sprinkle
.
Author(s)
Benjamin Nutter
See Also
sprinkle
, sprinkle_bg_pattern
,
index_to_sprinkle