Overleaf – How to Generate Long Tables with Tabularray in LaTeX

overleaftabularray

i am trying to generate an unconventional table like the one below

here is my attempt:

\documentclass[12pt,reqno]{report}
\usepackage{siunitx}
\setlength{\arrayrulewidth}{1mm}
\setlength{\tabcolsep}{35pt}
\usepackage{multirow}
\usepackage{longtable}
\usepackage{booktabs}
\usepackage{pdfcomment}
\usepackage{textcomp}
\usepackage{tabularx}
\usepackage{xcolor}
\definecolor{lavender}{rgb}{0.9, 0.9, 0.98}
\usepackage{tabularray}
\UseTblrLibrary{booktabs}
\usepackage{caption}

\begin{document}

\begin{table}
    \refstepcounter{table}
    \centering
    \begin{tblr}{
            colspec={|l l l},
            rows={rowsep=5pt},
            row{odd} = {bg=lavender},
            row{1,2} = {bg=white},
            row{2} = {rowsep=0pt},
            row{3} = {font=\bfseries},
            columns={colsep=6pt},
            column{1} = {bg=white, colsep=3pt},
            vline{1} = {abovepos = 1, belowpos = 1},
        }
        & \SetCell[c=2]{c} \textbf{Table \thetable}. Parameters for protein solvation calculations using APBSmem & \\
        \cline[1.5pt]{2,3} & & \\[-6pt]
        \cline[1.5pt]{2,3} & Parameter & Value \\
        \cline[1.5pt,gray]{2,3} & Calculation type & Protein solvation \\
        & Grid Dimensions & $\qtyproduct{289 x 289 x 257}{\angstrom}$ \\
        & Coarse Grid Lengths & $\qtyproduct{202.889 x 202.915 x 185.759}{\angstrom}$ \\
        & Fine Grid Lengths & $\qtyproduct{139.347 x 139.362 x 129.27}{\angstrom}$ \\
        & Counter-Ions & 1.0, 0.154, 1.65 \\
        & & -1.0, 0.154, 1.67 \\
        & Protein Dielectric & 2.0 \\
        & Solvent Dielectric & 80.0 \\
        & Membrane Dielectric & 8.0 \\
        & Headgroup Dielectric & 80.0 \\
        & Boundary Conditions & Focus \\
        & Solvent probe radius (srad) & 1.4 \\
        & Surface sphere density (sdens) & 10 \\
        & Temperature & 298.15 \\
        & Z-position of membrane bottom & -23.9 \\
        & Membrane thickness & 47.8 \\
        & Headgroup thickness & -- \\
        & Upper exclusion radius & 0 \\
        & Lower exclusion radius & 0 \\
        \cline[1.5pt]{2,3}
    \end{tblr}
    \label{table:1}
\end{table}

\end{document}

the table generated is not long enough or it is shifted down to the end of the page, in a way that includes the page number inside of it. any trick to tackle this?

Best Answer

With provided MWE your table can be nicely fit on one page.
Your table can be transformed to long table by the following changes in your MWE:
- remove table environment
- instead of tblr use longtblr
- Since longtblr automatically insert caption label before table (where it should not be, since caption is moved into the first table row), in front of the table must be inserted:

\DefTblrTemplate{firsthead, middlehead,lasthead}{default}{} % <---
\DefTblrTemplate{contfoot-text}{normal}{\scriptsize\textit{Continued on the next page}}
 \SetTblrTemplate{contfoot-text}{normal}

for proper caption numbering of next tables, end of table must be followed by \addtocounter{table}{-1}.

Complete MWE transformed to a long table is:

\documentclass[12pt,reqno]{report}

\usepackage{pdfcomment}
\usepackage{textcomp}
\usepackage{xcolor}
\definecolor{lavender}{rgb}{0.9, 0.9, 0.98}
\usepackage{tabularray}
\UseTblrLibrary{booktabs, siunitx}
\usepackage{caption}

\usepackage{lipsum}

\begin{document}
\lipsum[1]

{
    \centering
    \refstepcounter{table}
\DefTblrTemplate{firsthead, middlehead,lasthead}{default}{} % <---
\DefTblrTemplate{contfoot-text}{normal}{\scriptsize\textit{Continued on the next page}}
\SetTblrTemplate{contfoot-text}{normal}
    \begin{longtblr}[
 label={table:1}   
                    ]{
            colspec={|l l l},
            colsep=6pt,
            rows=5pt,
            row{odd} = {bg=lavender},
            row{1,2} = {bg=white},
            row{2} = {rowsep=0pt},
            row{3} = {font=\bfseries},
            column{1} = {bg=white, colsep=3pt},
            vline{1} = {abovepos = 1, belowpos = 1},
            rowhead=3
        }
    & \SetCell[c=2]{c} \textbf{Table \thetable}. Parameters for protein solvation calculations using APBSmem & \\
    \cline[1.5pt]{2,3} & & \\[-6pt]
    \cline[1.5pt]{2,3} & Parameter & Value \\
    \cline[1.5pt,gray]{2,3} & Calculation type & Protein solvation \\
    & Grid Dimensions & $\qtyproduct{289 x 289 x 257}{\angstrom}$ \\
    & Coarse Grid Lengths & $\qtyproduct{202.889 x 202.915 x 185.759}{\angstrom}$ \\
    & Fine Grid Lengths & $\qtyproduct{139.347 x 139.362 x 129.27}{\angstrom}$ \\
    & Counter-Ions & 1.0, 0.154, 1.65 \\
    & & $-1.0$, 0.154, 1.67 \\
    & Protein Dielectric & 2.0 \\
    & Solvent Dielectric & 80.0 \\
    & Membrane Dielectric & 8.0 \\
    & Headgroup Dielectric & 80.0 \\
    & Boundary Conditions & Focus \\
    & Solvent probe radius (srad) & 1.4 \\
    & Surface sphere density (sdens) & 10 \\
    & Temperature & 298.15 \\
    & Z-position of membrane bottom & $-23.9$ \\
    & Membrane thickness & 47.8 \\
    & Headgroup thickness & -- \\
    & Upper exclusion radius & 0 \\
    & Lower exclusion radius & 0 \\
    \cline[1.5pt]{2,3}
\end{longtblr}
\addtocounter{table}{-1}
}

\begin{table}[ht]
\caption{For test of tables numbering}
\begin{tabular*}{\linewidth}{@{} p{\linewidth} @{}}
\hline
\lipsum[66] \\
\hline
\end{tabular*}
\end{table}

\end{document}

Related Solutions

Tabularray – Align Tabular with Text: A Guide

From tabularray version 2022A (2022-03-01), \firsthline and \lasthline commands are deprecated in favor of baseline=T and baseline=B specifications. You can write baseline option as either an inner specification or an outer specification. And when baseline=T/B is an outer specification, you can omit the key name and write the value only:

\documentclass{article}
\usepackage{tabularray}
\usepackage{array}
\begin{document}

\section{Tabularray}

Test 1
\begin{tblr}[T]{vlines, colspec={c}}
\hline
  Test 2 \\
\hline
  Test 3 \\
\hline
\end{tblr}
Test 1
\begin{tblr}[B]{vlines, colspec={c}}
\hline
  Test 2 \\
\hline
  Test 3 \\
\hline
\end{tblr}

\section{Tabular}

Test 1
\begin{tabular}[t]{|c|}
\firsthline
  Test 2 \\
\hline
  Test 3 \\
\hline
\end{tabular}
Test 1
\begin{tabular}[b]{|c|}
\hline
  Test 2 \\
\hline
  Test 3 \\
\lasthline
\end{tabular}

\end{document}

But you can still roll back to version 2021Q with \usepackage{tabularray}[=v2021], so that you can use \firsthline and \lasthline commands in tblr environment. The usage is the same as in tabular environment:

\documentclass{article}
\usepackage{tabularray}[=v2021]
\usepackage{array}
\begin{document}

\section{Tabularray}

Test 1
\begin{tblr}[t]{vlines, colspec={c}}
\firsthline
  Test 2 \\
\hline
  Test 3 \\
\hline
\end{tblr}
Test 1
\begin{tblr}[b]{vlines, colspec={c}}
\hline
  Test 2 \\
\hline
  Test 3 \\
\lasthline
\end{tblr}

\section{Tabular}

Test 1
\begin{tabular}[t]{|c|}
\firsthline
  Test 2 \\
\hline
  Test 3 \\
\hline
\end{tabular}
Test 1
\begin{tabular}[b]{|c|}
\hline
  Test 2 \\
\hline
  Test 3 \\
\lasthline
\end{tabular}

\end{document}

tabularray – Troubleshooting Lost Lines in Colored Tables with Tabularray

Updated on 2021-09-09: This bug should has been fixed. You may download the latest package file from https://github.com/lvjr/tabularray/raw/main/tabularray.sty and test whether there are other problems.

In fact, this is a bug only for long tables. If you change longtblr to tblr, everything will be OK.

\documentclass[12pt,a4paper]{article}

\usepackage{tabularray}
\usepackage{xcolor}
\colorlet{titleblue}{blue!70!black}

\begin{document}

\begin{tblr}{
    colspec = {lXX}, width = \textwidth,
    rowhead = 1,
    hlines, vlines,
    row{2} = {bg=titleblue!15},
    cell{2,3}{2} = {c=2}{l},
}
    Head  & Head          & Head \\
    1     & Combined text &  \\
    1.1   & Sub text      &  \\
    1.1.1 & Text          & Normal row \\
\end{tblr}

\end{document}

Recently, in order to solve the problem of disappeared borders in some PDF readers, tabularray changed some code to draw table borders after table cells (see issue #76). The new method works very well for short tables, but unfortunely fails for some long tables.

A long table in a page consists of three parts: head, body and foot. In this example, the second hline is in the head, while the second row is in the body. Therefore the hline may be covered by the row in some cases in PDF readers.

To solve this problem, I need to modify the code of long table typesetting, drawing table body before table head.

But it is too late for version 2021N. Therefore I will fix this bug after 2021N and update this answer afterwards.

Best Answer

Related Solutions

Tabularray – Align Tabular with Text: A Guide

tabularray – Troubleshooting Lost Lines in Colored Tables with Tabularray

Related Question