Having groups of rows in row groups is a great way to present information. A rearrangement of rows is carried out to ensure each of the rows is collected within the appropriate row groups. Across the top of each row group is the row group label contained in a separate row (these cut across the field and they contain nothing but the row group label).

Three row groups have been made since there are three unique categories under groupname. Here we will create three row groups (with row group labels continent, country, and subregion) to have a grouping of rows. We can use any of the strategies to reference rows as we did we footnotes (e.g., vectors of names/indices, select helpers, etc.). The inputs are row group names in the label argument, and row references in the rows argument. We can make a new row group with each call of the tab_row_group() function. This can be easily done with a table containing row labels. This divides rows into groups, creating row groups, and results in a display of a row group labels right above the each group. Let’s incorporate row groups into the display table. Let’s add a footnote that references the North America and South America cells in the name column: Here is a simple example on how a footnotes can be added to a table cell. For rows specifically, we can use a conditional statement with column names as variables (e.g., size > 15000). For each of these, we can supply (1) a vector of colnames or rownames, (2) a vector of column/row indices, (3) bare column names wrapped in c() or row labels within c(), or (4) a select helper function ( starts_with(), ends_with(), contains(), matches(), one_of(), and everything()). The cells_body() helper has the two arguments columns and rows. The helper function cells_body() can be used with the location argument to specify which data cells should be the target of the footnote. Footnotes are added with the tab_footnote() function. Wiley.įootnotes live inside the Footer part and their footnote marks are attached to cell data. Source: The World Almanac and Book of Facts, 1975, page 406. We can add this part using the tab_header() function: A Table Header is easy to add so let’s see how the previous table looks with a title and a subtitle.

The way that we add parts like the Table Header and footnotes in the Table Footer is to use the tab_*() family of functions.

the Table Footer (optional possibly with footnotes and source notes).the Table Body (contains columns and rows of cells).the Column Labels (contains column labels, optionally under spanner column labels).the Stub and the Stub Head (optional contains row labels, optionally within row groups having row group labels and possibly summary labels when a summary is present).the Table Header (optional with a title and possibly a subtitle).The parts (roughly from top to bottom) are: This is the way the main parts of a table (and their subparts) fit together: The next few examples will show all of the other table parts that are available.

The previous gt Table demonstrated had only two parts, the Column Labels and the Table Body. These table parts work well together and there the possible variations in arrangement can handle most tabular presentation needs. The gt package makes it relatively easy to add parts so that the resulting gt Table better conveys the information you want to present.

Rstudio icon