% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/crowd_tables_as_tabset.R
\name{crowd_tables_as_tabset}
\alias{crowd_tables_as_tabset}
\title{Convert List of Tables to Quarto Tabset}
\usage{
crowd_tables_as_tabset(
  tbl_list,
  table_fn = knitr::kable,
  pagebreak = c("never", "auto", "always")
)
}
\arguments{
\item{tbl_list}{A named list of data frames. Names become tab labels.}

\item{table_fn}{A function that converts a data frame to a printable
table object. Defaults to \code{\link[knitr:kable]{knitr::kable()}}. Other options include
\code{\link[gt:gt]{gt::gt()}}, \code{tinytable::tt}, etc. Can be set globally via
\code{global_settings_set(new = list(table_fn = gt::gt), fn_name = "crowd_tables_as_tabset")}.}

\item{pagebreak}{Character. Controls page break insertion between tables:
\itemize{
\item \code{"never"} (default): Never insert page breaks
\item \code{"auto"}: Insert page breaks for non-HTML/non-Typst formats only
\item \code{"always"}: Always insert page breaks between tables
}}
}
\value{
Called for its side effects (printing tabset markdown and tables).
Returns \code{NULL} invisibly.
}
\description{
Creates a Quarto tabset from a named list of data frames, rendering each
as a table in its own tab. Designed to be called within a
Quarto document code chunk with \code{results='asis'}.
}
\details{
This function outputs raw Quarto markdown (level-5 headings) interleaved
with printed tables. The enclosing chunk should use the Quarto
\code{tabset} panel layout and \code{results: asis}.
}
\examples{
\dontrun{
tbl_list <- list(
  "Group A" = head(mtcars),
  "Group B" = tail(mtcars)
)
crowd_tables_as_tabset(tbl_list)

# Use gt::gt instead
crowd_tables_as_tabset(tbl_list, table_fn = gt::gt)
}
}
\seealso{
\code{\link[=crowd_plots_as_tabset]{crowd_plots_as_tabset()}} for the plot equivalent.
}
