These functions print data frames as HTML-table, showing the results in RStudio's viewer pane or in a web browser.
tab_df(x, title = NULL, footnote = NULL, col.header = NULL, show.type = FALSE, show.rownames = TRUE, show.footnote = FALSE, alternate.rows = FALSE, sort.column = NULL, encoding = "UTF-8", CSS = NULL, file = NULL, use.viewer = TRUE, ...) tab_dfs(x, titles = NULL, footnotes = NULL, col.header = NULL, show.type = FALSE, show.rownames = TRUE, show.footnote = FALSE, alternate.rows = FALSE, sort.column = NULL, encoding = "UTF-8", CSS = NULL, file = NULL, use.viewer = TRUE, ...)
x | For |
---|---|
title, titles, footnote, footnotes | Character vector with table
caption(s) resp. footnote(s). For |
col.header | Character vector with elements used as column header for
the table. If |
show.type | Logical, if |
show.rownames | Logical, if |
show.footnote | Logical, if |
alternate.rows | Logical, if |
sort.column | Numeric vector, indicating the index of the column
that should sorted. by default, the column is sorted in ascending order.
Use negative index for descending order, for instance,
|
encoding | Character vector, indicating the charset encoding used
for variable and value labels. Default is |
CSS | A |
file | Destination file, if the output should be saved as file.
If |
use.viewer | Logical, if |
... | Currently not used. |
A list with following items:
the web page style sheet (page.style
),
the HTML content of the data frame (page.content
),
the complete HTML page, including header, style sheet and body (page.complete
)
the HTML table with inline-css for use with knitr (knitr
)
the file path, if the HTML page should be saved to disk (file
)
How do I use CSS
-argument?
With the CSS
-argument, the visual appearance of the tables
can be modified. To get an overview of all style-sheet-classnames
that are used in this function, see return value page.style
for
details. Arguments for this list have following syntax:
the class-name as argument name and
each style-definition must end with a semicolon
You can add style information to the default styles by using a + (plus-sign) as initial character for the argument attributes. Examples:
table = 'border:2px solid red;'
for a solid 2-pixel table border in red.
summary = 'font-weight:bold;'
for a bold fontweight in the summary row.
lasttablerow = 'border-bottom: 1px dotted blue;'
for a blue dotted border of the last table row.
colnames = '+color:green'
to add green color formatting to column names.
arc = 'color:blue;'
for a blue text color each 2nd row.
caption = '+color:red;'
to add red font-color to the default table caption style.
See further examples in this package-vignette.
The HTML tables can either be saved as file and manually opened
(use argument file
) or they can be saved as temporary files and
will be displayed in the RStudio Viewer pane (if working with RStudio)
or opened with the default web browser. Displaying resp. opening a
temporary file is the default behaviour.
# NOT RUN { data(iris) data(mtcars) tab_df(iris[1:5, ]) tab_dfs(list(iris[1:5, ], mtcars[1:5, 1:5])) # sort 2nd column ascending tab_df(iris[1:5, ], sort.column = 2) # sort 2nd column descending tab_df(iris[1:5, ], sort.column = -2) # }