addHtmlTableStyle | R Documentation |
This function is a preprocessing step before applying the htmlTable()
function.
You use this to style your tables with HTML cascading style sheet features.
addHtmlTableStyle(
x,
align = NULL,
align.header = NULL,
align.cgroup = NULL,
css.rgroup = NULL,
css.rgroup.sep = NULL,
css.tspanner = NULL,
css.tspanner.sep = NULL,
css.total = NULL,
css.cell = NULL,
css.cgroup = NULL,
css.header = NULL,
css.header.border_bottom = NULL,
css.class = NULL,
css.table = NULL,
pos.rowlabel = NULL,
pos.caption = NULL,
col.rgroup = NULL,
col.columns = NULL,
padding.rgroup = NULL,
padding.tspanner = NULL,
spacer.celltype = NULL,
spacer.css.cgroup.bottom.border = NULL,
spacer.css = NULL,
spacer.content = NULL
)
appendHtmlTableStyle(
x,
align = NULL,
align.header = NULL,
align.cgroup = NULL,
css.rgroup = NULL,
css.rgroup.sep = NULL,
css.tspanner = NULL,
css.tspanner.sep = NULL,
css.total = NULL,
css.cell = NULL,
css.cgroup = NULL,
css.header = NULL,
css.header.border_bottom = NULL,
css.class = NULL,
css.table = NULL,
pos.rowlabel = NULL,
pos.caption = NULL,
col.rgroup = NULL,
col.columns = NULL,
padding.rgroup = NULL,
padding.tspanner = NULL,
spacer.celltype = NULL,
spacer.css.cgroup.bottom.border = NULL,
spacer.css = NULL,
spacer.content = NULL
)
x |
The object that you later want to pass into |
align |
A character strings specifying column alignments, defaulting to |
align.header |
A character strings specifying alignment for column header,
defaulting to centered, i.e. |
align.cgroup |
The justification of the |
css.rgroup |
CSS style for the rgroup, if different styles are wanted for each of the rgroups you can just specify a vector with the number of elements. |
css.rgroup.sep |
The line between different rgroups. The line is set to the TR element of the lower rgroup, i.e. you have to set the border-top/padding-top etc to a line with the expected function. This is only used for rgroups that are printed. You can specify different separators if you give a vector of rgroup - 1 length (this is since the first rgroup doesn't have a separator). |
css.tspanner |
The CSS style for the table spanner. |
css.tspanner.sep |
The line between different spanners. |
css.total |
The css of the total row if such is activated. |
css.cell |
The css.cell element allows you to add any possible CSS style to your table cells. See section below for details. |
css.cgroup |
The same as |
css.header |
The header style, not including the cgroup style |
css.header.border_bottom |
The header bottom-border style, e.g. |
css.class |
The html CSS class for the table. This allows directing html formatting through CSS directly at all instances of that class. Note: unfortunately the CSS is frequently ignored by word processors. This option is mostly inteded for web-presentations. |
css.table |
You can specify the the style of the table-element using this parameter |
pos.rowlabel |
Where the rowlabel should be positioned. This value can be |
pos.caption |
Set to |
col.rgroup |
Alternating colors (zebra striping/banded rows) for each |
col.columns |
Alternating colors for each column. |
padding.rgroup |
Generally two non-breakings spaces, i.e. |
padding.tspanner |
The table spanner is usually without padding but you may specify padding
similar to |
spacer.celltype |
When using cgroup the table headers are separated through a empty
HTML cell that is by default filled with |
spacer.css.cgroup.bottom.border |
Defaults to |
spacer.css |
If you want the spacer cells to share settings you can set it here |
spacer.content |
Defaults to |
The function stores the current theme (see setHtmlTableTheme()
) + custom styles
to the provided object as an base::attributes()
. It is stored under the element
htmlTable.style
in the form of a list object.
x
with the style added as an attribute that the htmlTable then can use for formatting.
css.cell
argumentThe css.cell
parameter allows you to add any possible CSS style
to your table cells. css.cell
can be either a vector or a matrix.
If css.cell
is a vector, it's assumed that the styles should be repeated
throughout the rows (that is, each element in css.cell specifies the style
for a whole column of 'x').
In the case of css.cell
being a matrix of the same size of the x
argument,
each element of x
gets the style from the corresponding element in css.cell. Additionally,
the number of rows of css.cell
can be nrow(x) + 1
so the first row of of css.cell
specifies the style for the header of x
; also the number of columns of css.cell
can be ncol(x) + 1
to include the specification of style for row names of x
.
Note that the text-align
CSS field in the css.cell
argument will be overriden
by the align
argument.
Excel has a specific css-style, mso-number-format
that can be used for improving the
copy-paste functionality. E.g. the style could be written as: css_matrix <- matrix( data = "mso-number-format:\"\\@\"", nrow = nrow(df), ncol = ncol(df))
Other htmlTableStyle:
hasHtmlTableStyle()
library(magrittr)
matrix(1:4, ncol = 2) %>%
addHtmlTableStyle(align = "c", css.cell = "background-color: orange;") %>%
htmlTable(caption = "A simple style example")
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.