Learn R Programming

⚠️There's a newer version (0.9.5) of this package.Take me there.

flextable R package

The user documentation is available here: https://ardata-fr.github.io/flextable-book/

set_flextable_defaults(
  font.family = "Arial", font.size = 10, 
  border.color = "gray")

flextable(head(cars)) %>% 
  bold(part = "header") %>% 
  add_footer_lines("The 'cars' dataset")

Tables can be embedded within HTML, PDF, Word and PowerPoint documents from R Markdown documents and within Microsoft Word or PowerPoint documents with package officer. Tables can also be rendered as R plots or graphic files (png, pdf and jpeg).

flextable(mtcars) %>% 
  theme_vanilla() %>% 
  save_as_docx(path = "mytable.docx")

A flextable object is a data.frame representation. An API is available to let R users create tables for reporting and control their formatting properties and their layout. The package provides functions that give control over:

  • header, body and footer content
  • text, paragraphs, cells and border formatting of any element
  • displayed values

Installation

install.packages("flextable")

You can get the development version from GitHub:

devtools::install_github("davidgohel/flextable")

Resources

Documentation

The help pages are in a bookdown located at: https://ardata-fr.github.io/flextable-book/

Manuals are available at: https://davidgohel.github.io/flextable/reference/index.html

A gallery of examples is available here: https://ardata.fr/en/flextable-gallery/

Getting help / questions

If you have questions about how to use the package, visit Stackoverflow and use tags flextable and r Stackoverflow link! You can also use https://github.com/davidgohel/flextable/discussions to start a discussion.

Contributing to the package

Code of Conduct

Anyone getting involved in this package agrees to our Code of Conduct.

Bug reports

When you file a bug report, please spend some time making it easy for me to follow and reproduce. The more time you spend on making the bug report coherent, the more time I can dedicate to investigate the bug as opposed to the bug report.

Contributing to the package development

A great way to start is to contribute an example or improve the documentation.

If you want to submit a Pull Request to integrate functions of yours, please provide:

  • the new function(s) with code and roxygen tags (with examples)
  • a new section in the appropriate vignette that describes how to use the new function
  • corresponding tests in directory tests/testthat.

By using rhub (run rhub::check_for_cran()), you will see if everything is ok. When submitted, the PR will be evaluated automatically on travis and appveyor and you will be able to see if something broke.

Copy Link

Version

Install

install.packages('flextable')

Monthly Downloads

77,938

Version

0.8.3

License

GPL-3

Maintainer

David Gohel

Last Published

November 6th, 2022

Functions in flextable (0.8.3)

as_flextable.gam

tabular summary for gam object
as_sup

superscript chunk
as_word_field

'Word' computed field
add_footer_row

Add footer labels
add_header

Add column values as new lines in header
as_bracket

chunk with values in brackets
bold

Set bold font
add_footer

Add column values as new lines in footer
border

cell borders update
as_chunk

chunk of text wrapper
add_footer_lines

Add labels as new rows in the footer
add_header_lines

Add labels as new rows in the header
append_chunks

append chunks to flextable content
colformat_image

format cells as images
add_body_row

Add body labels
add_body

Add column values as new lines in body
colformat_int

format integer cells
dim.flextableGrob

Get optimal width and height of a flextable grob
dim.flextable

Get widths and heights of flextable
as_equation

equation chunk
add_header_row

Add header labels
add_latex_dep

add latex dependencies
as_b

bold chunk
as_flextable

method to convert object to flextable
as_flextable.grouped_data

tabular summary for grouped_data object
as_flextable.merMod

tabular summary for mixed model
footnote

add footnotes to flextable
as_flextable.htest

tabular summary for htest object
as_flextable.summarizor

summarizor to flextable
as_raster

get a flextable as a raster
as_flextable.kmeans

tabular summary for kmeans
as_flextable.lm

tabular summary for lm object
as_sub

subscript chunk
as_flextable.tabulator

tabulator to flextable
bg

Set background color
as_flextable.pam

tabular summary for pam
chunk_dataframe

create a chunk representation suitable for flextable
border_remove

remove borders
as_highlight

highlight chunk
as_image

image chunk wrapper
body_add_flextable

add flextable into a Word document
colformat_char

format character cells
colformat_date

format date cells
align

Set text alignment
as_paragraph

concatenate chunks in a flextable
as_i

italic chunk
color

Set font color
colorize

colorize chunk
fp_border_default

Border formatting properties
fit_to_width

fit a flextable to a maximum width
as_flextable.xtable

get a flextable from a xtable object
as_grouped_data

grouped data transformation
fix_border_issues

fix border issues when cell are merged
fmt_avg_dev

format content for mean and sd
italic

Set italic font
dim_pretty

Calculate pretty dimensions
colformat_datetime

format datetime cells
fmt_header_n

format count data for headers
knit_print.flextable

Render flextable in rmarkdown
autofit

Adjusts cell widths and heights
colformat_double

format numeric cells
border_inner

set vertical & horizontal inner borders
merge_v

Merge flextable cells vertically
minibar

mini barplots chunk wrapper
regulartable

flextable old functions
get_flextable_defaults

Get flextable defaults formatting properties
before

is an element before a match with entries
gg_chunk

ggplots chunk wrapper
rotate

rotate cell text
htmltools_value

flextable as an HTML object
set_table_properties

Global table properties
merge_h_range

rowwise merge of a range of columns
hyperlink_text

Chunk of text with hyperlink
border_inner_v

set vertical inner borders
border_outer

set outer borders
compose

Define displayed values and mixed content
border_inner_h

set inner borders
continuous_summary

continuous columns summary
colformat_lgl

format logical cells
theme_box

Apply box theme
shift_table

Create a shift table
delete_part

delete flextable part
flextable_to_rmd

flextable raw code
fmt_2stats

format content for data generated with summarizor()
merge_none

Delete flextable merging informations
colformat_num

format numeric cells
set_header_footer_df

Set flextable's header or footer rows
labelizor

change displayed labels
headers_flextable_at_bkm

add flextable at a bookmark location in document's header
grid_chunk

'Grid Graphics' chunk wrapper
line_spacing

Set text alignment
flextable-package

flextable: Functions for Tabular Reporting
set_header_labels

Change headers labels
empty_blanks

make blank columns as transparent
flextable_dim

width and height of a flextable object
df_printer

data.frame automatic printing as a flextable
theme_tron

Apply tron theme
plot_chunk

mini plots chunk wrapper
valign

Set vertical alignment
vline

set vertical borders
fmt_n_percent

format content for count data
flextable_html_dependency

htmlDependency for flextable objects
height

Set flextable rows height
font

Set font
highlight

Text highlight color
hline

set horizontal borders
prepend_chunks

prepend chunks to flextable content
hline_bottom

set bottom horizontal border
void

Delete flextable content
save_as_image

save a flextable as an image
linerange

mini linerange chunk wrapper
fontsize

Set font size
flextable

flextable creation
lollipop

mini lollipop chart chunk wrapper
save_as_pptx

save flextable objects in an PowerPoint file
style

Set flextable style
merge_at

Merge flextable cells into a single one
width

Set columns width
summarizor

data summary preparation
footers_flextable_at_bkm

add flextable at a bookmark location in document's footer
print.flextable

flextable printing
proc_freq

frequency table as flextable
merge_h

Merge flextable cells horizontally
set_flextable_defaults

Modify flextable defaults formatting properties
padding

Set paragraph paddings
ph_with.flextable

add a flextable into a PowerPoint slide
fp_text_default

Text formatting properties
set_formatter

set column formatter functions
tabulator_colnames

column keys of tabulator objects
save_as_docx

save flextable objects in an Word file
theme_alafoli

Apply alafoli theme
save_as_html

Save a Flextable in an HTML File
hline_top

set top horizontal border
gen_grob

Convert a flextable to a grid grob object
theme_tron_legacy

Apply tron legacy theme
surround

Set borders for a selection of cells
hrule

Set flextable rule for rows heights
tabulator

Tabulation of aggregations
use_df_printer

set data.frame automatic printing as a flextable
ncol_keys

Number of columns
theme_vader

Apply Sith Lord Darth Vader theme
nrow_part

Number of rows of a part
use_model_printer

set model automatic printing as a flextable
plot.flextable

plot a flextable
vline_left

set flextable left vertical borders
vline_right

set flextable right vertical borders
plot.flextableGrob

plot a flextable grob
separate_header

Separate collapsed colnames into multiple rows
set_caption

Set Caption
theme_apa

Apply APA theme
theme_booktabs

Apply booktabs theme
theme_vanilla

Apply vanilla theme
theme_zebra

Apply zebra theme
as_flextable.glm

tabular summary for glm object