19.16 \addvspace

Synopsis :

\addvspace{long-vert}

Ajoute un espace vertical de longueur long-vert. Toutefois, si il y a deux ou plus \addvspace à la suite, alors elles ajoutent seulement l’espace nécessaire à fabriquer la longueur naturelle égale au maximum des long-vert correspondant. Cette commande est fragile (voir \protect). La longueur long-vert est une longueur élastique (voir Lengths).

L’exemple suivante illustre l’usage de la commande. L’environnement picture dessine une échelle sur laquelle deux filets sont posés. Dans un document LaTeX de classe standarde article la longueur \baselineskip vaut 12pt. Comme l’indique l’échelle, les deux filets sont écartés de 22pt : la somme des \baselineskip et de 10pt provenant du premier \addvspace.

\documentclass{article}
\usepackage{color}
\begin{document}
\setlength{\unitlength}{2pt}%
\noindent\begin{picture}(0,0)%
  \multiput(0,0)(0,-1){25}{{\color{blue}\line(1,0){1}}}
  \multiput(0,0)(0,-5){6}{{\color{red}\line(1,0){2}}}
\end{picture}%
\rule{0.25\linewidth}{0.1pt}%
\par\addvspace{10pt}% \addvspace{20pt}%
\par\noindent\rule{0.25\linewidth}{0.1pt}%
\end{document}

Si dans l’exemple précédent on décommente le second \addvspace, l’écart entre les deux filets ne croit pas de 20pt ; mais au lieu de cela l’écart devient la somme de \baselineskip et de 20pt. De sorte que \addvspace en un sens fait le contraire de ce que son nom laisse entendre — elle vérifie que des espaces verticaux multiples ne s’accumulent pas, mais qu’au lieu de cela seul le plus grand d’eux est utilisé.

LaTeX utilise cette commande pour ajuster l’espace vertical au-dessus ou au-dessous d’un environnement qui commence un nouveau paragraphe. Par exemple, un environnement theorem commence et finit avec une \addvspace de sorte que deux theorem consécutifs sont séparés par un espace vertical, et non deux.

Une erreur ‘Something's wrong--perhaps a missing \item’ pointant sur un \addvspace signifie que vous n’étiez pas en mode vertical quand vous avez invoqué cette commande ; une façon pour sortir de cela et de faire précéder \addvspace d’une commande \par (voir \par), comme dans l’exemple plus haut.