> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/fr/figures-et-tableaux/01-tables.md).

# article sur les tableaux

Il existe trois façons d'insérer des tableaux dans Overleaf :

1. L'utilisation de la feuille de style [**Insérer un tableau** bouton](/latex/fr/base-de-connaissances/067-how-to-generate-and-insert-latex-tables-in-overleaf.md#inserttable) dans la barre d'outils de l'éditeur.
2. Copier et coller un tableau depuis un autre document tout en utilisant **Éditeur visuel**.
3. Écrire le code LaTeX du tableau dans **Éditeur de code**.

Si vous débutez avec LaTeX, utiliser la [barre d'outils dans **Éditeur visuel**](/latex/fr/base-de-connaissances/067-how-to-generate-and-insert-latex-tables-in-overleaf.md#inserttable) (option 1) est une excellente façon de commencer. Et vous pouvez passer entre **Éditeur visuel** et **Éditeur de code** pour voir le code derrière le tableau. **Cette page se concentre sur l'option 3.**

## Créer un tableau simple en LaTeX

Nous pouvons commencer par l'un des exemples les plus simples de tableau :

```latex
\begin{center}
\begin{tabular}{ c c c }
 cellule1 & cellule2 & cellule3 \\
 cellule4 & cellule5 & cellule6 \\
 cell7 & cell8 & cell9
\end{tabular}
\end{center}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+a+basic+table\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A%5Cbegin%7Btabular%7D%7B+c+c+c+%7D%0A+cell1+%26+cell2+%26+cell3+%5C%5C+%0A+cell4+%26+cell5+%26+cell6+%5C%5C++%0A+cell7+%26+cell8+%26+cell9++++%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D)

![Exemple de tableau](/files/5823ed1a81253a2e81257b8e0ff072fa3d0c8eed)

Le `tabular` L'environnement est la méthode LaTeX par défaut pour créer des tableaux. Vous devez spécifier un paramètre à cet environnement ; ici, nous utilisons `{c c c}` ce qui indique à LaTeX qu'il y a trois colonnes et que le texte à l'intérieur de chacune d'elles doit être centré.

Le `tabular` L'environnement offre davantage de flexibilité ; par exemple, vous pouvez placer des lignes de séparation entre chaque colonne :

```latex
\begin{center}
\begin{tabular}{ |c|c|c| }
 \hline
 cellule1 & cellule2 & cellule3 \\
 cellule4 & cellule5 & cellule6 \\
 cellule7 & cellule8 & cellule9 \\
 \hline
\end{tabular}
\end{center}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+a+basic+table+with+separator+lines\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A%5Cbegin%7Btabular%7D%7B+%7Cc%7Cc%7Cc%7C+%7D+%0A+%5Chline%0A+cell1+%26+cell2+%26+cell3+%5C%5C+%0A+cell4+%26+cell5+%26+cell6+%5C%5C+%0A+cell7+%26+cell8+%26+cell9+%5C%5C+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D)

![Exemple de tableau simple](/files/3a275ae24f0c52ff8dd77d1a731b697b2158eb6c)

Voici une description des constructions utilisées dans l'exemple ci-dessus :

**{ |c|c|c| }**

Cela indique que trois colonnes, séparées par une ligne verticale, vont être utilisées dans le tableau. Chaque c signifie que le contenu de la colonne sera centré. Vous pouvez également utiliser r pour aligner le texte à droite et l pour un alignement à gauche.

**\hline**

Cela insère une ligne horizontale en haut du tableau et aussi en bas. Il n'y a aucune restriction sur le nombre de fois où vous pouvez utiliser \hline.

**cell1 & cell2 & cell3 \\\\**

Chaque & est un séparateur de cellule et le double antislash \\\ marque la fin de cette ligne.

Ci-dessous, vous pouvez voir un deuxième exemple qui utilise diverses lignes verticales et horizontales (souvent appelées « traits ») :

```latex
\begin{center}
\begin{tabular}{||c c c c||}
 \hline
 Col1 & Col2 & Col2 & Col3 \\ [0.5ex]
 \hline\hline
 1 & 6 & 87837 & 787 \\
 \hline
 2 & 7 & 78 & 5415 \\
 \hline
 3 & 545 & 778 & 7507 \\
 \hline
 4 & 545 & 18744 & 7560 \\
 \hline
 5 & 88 & 788 & 6344 \\ [1ex]
 \hline
\end{tabular}
\end{center}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+table+with+horizontal+and+vertical+rules\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A%5Cbegin%7Btabular%7D%7B%7C%7Cc+c+c+c%7C%7C%7D+%0A+%5Chline%0A+Col1+%26+Col2+%26+Col2+%26+Col3+%5C%5C+%5B0.5ex%5D+%0A+%5Chline%5Chline%0A+1+%26+6+%26+87837+%26+787+%5C%5C+%0A+%5Chline%0A+2+%26+7+%26+78+%26+5415+%5C%5C%0A+%5Chline%0A+3+%26+545+%26+778+%26+7507+%5C%5C%0A+%5Chline%0A+4+%26+545+%26+18744+%26+7560+%5C%5C%0A+%5Chline%0A+5+%26+88+%26+788+%26+6344+%5C%5C+%5B1ex%5D+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D)

![Exemple de tableau avec hline](/files/76e60a1cfc075ce4df33232a8c03a6d042da970a)

## Tableaux à largeur fixe

Lorsque vous formatez un tableau, vous pouvez avoir besoin d'une largeur fixe, soit pour chaque colonne, soit pour l'ensemble du tableau. L'exemple suivant ajoute le `array` package à l'en-tête du document :

```latex
\usepackage{array}
```

et l'utilise pour définir des largeurs fixes de colonne :

```latex
\documentclass{article}
\usepackage{array}
\begin{document}
\begin{center}
\begin{tabular}{ | m{5em} | m{1cm}| m{1cm} | }
  \hline
  cell1 dummy text dummy text dummy text& cell2 & cell3 \\
  \hline
  cell1 dummy text dummy text dummy text & cell5 & cell6 \\
  \hline
  cellule7 & cellule8 & cellule9 \\
  \hline
\end{tabular}
\end{center}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Table+with+fixed+column+width\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Barray%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A%5Cbegin%7Btabular%7D%7B+%7C+m%7B5em%7D+%7C+m%7B1cm%7D%7C+m%7B1cm%7D+%7C+%7D+%0A++%5Chline%0A++cell1+dummy+text+dummy+text+dummy+text%26+cell2+%26+cell3+%5C%5C+%0A++%5Chline%0A++cell1+dummy+text+dummy+text+dummy+text+%26+cell5+%26+cell6+%5C%5C+%0A++%5Chline%0A++cell7+%26+cell8+%26+cell9+%5C%5C+%0A++%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D)

![Exemple de tableau à largeur fixe](/files/a91ce17c11c1f43be2d7575cfb9dde9d3a26179a)

Dans l' `tabular` environnement, le paramètre `m{5em}` définit une largeur de `5em` pour la première colonne (`1cm` pour les deux autres) et centre le texte au milieu de la cellule. Les options d'alignement sont `m` pour le milieu, `p` pour le haut et `b` pour le bas. Lorsque vous utilisez ces paramètres, le texte est automatiquement formaté pour tenir dans chaque cellule.

Si vous n'avez pas besoin de contrôler la largeur de chaque cellule, mais celle de l'ensemble du tableau, puis de répartir l'espace uniformément à l'intérieur, utilisez le `tabularx` package. Voir l'exemple ci-dessous :

```latex
\documentclass{article}
\usepackage{tabularx}
\begin{document}
\begin{tabularx}{0.8\textwidth} {
  | >{\raggedright\arraybackslash}X
  | >{\centering\arraybackslash}X
  | >{\raggedleft\arraybackslash}X | }
 \hline
 item 11 & item 12 & item 13 \\
 \hline
 item 21  & item 22  & item 23  \\
\hline
\end{tabularx}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Table+example+using+tabularx+package\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Btabularx%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btabularx%7D%7B0.8%5Ctextwidth%7D+%7B+%0A++%7C+%3E%7B%5Craggedright%5Carraybackslash%7DX+%0A++%7C+%3E%7B%5Ccentering%5Carraybackslash%7DX+%0A++%7C+%3E%7B%5Craggedleft%5Carraybackslash%7DX+%7C+%7D%0A+%5Chline%0A+item+11+%26+item+12+%26+item+13+%5C%5C%0A+%5Chline%0A+item+21++%26+item+22++%26+item+23++%5C%5C%0A%5Chline%0A%5Cend%7Btabularx%7D%0A%5Cend%7Bdocument%7D)

![Exemple de tableau avec le package tabularx](/files/683437d36aa79d0962d96a7907ef2d4627349950)

L'environnement `tabularx` est similaire à `tabular` mais plus flexible. Pour l'utiliser, ajoutez la ligne `\usepackage{tabularx}` à l'en-tête du document. Notez que l'instruction d'ouverture de l'environnement est différente ; dans l'exemple, la largeur du tableau est définie à `0.8\textwidth`, ce qui correspond à 80 % de la largeur de texte du document. Vous pouvez utiliser n'importe quelle [unité LaTeX](/latex/fr/mise-en-forme/01-lengths-in-latex.md) pour définir cette valeur.

Le préfixe entre accolades `| >{\raggedright\arraybackslash}X | >{\centering\arraybackslash}X | >{\raggedleft\arraybackslash}X |` définit l'alignement de chaque colonne : la première à *gauche*, la deuxième à *center* et la troisième à *droite*.

## Fusion des lignes et des colonnes

Les lignes et les colonnes peuvent être fusionnées pour créer des cellules de tableau plus grandes. L'exemple suivant utilise la `\multicolumn` commande pour fusionner plusieurs colonnes :

```latex
\documentclass{article}
\usepackage{multirow}
\begin{document}
\begin{tabular}{ |p{3cm}||p{3cm}|p{3cm}|p{3cm}|  }
 \hline
 \multicolumn{4}{|c|}{Liste des pays} \\
 \hline
 Nom du pays ou de la zone& Code ISO alpha 2 &Code ISO alpha 3&Code numérique ISO\\
 \hline
 Afghanistan   & AF    &AFG&   004\\
 Îles Åland&   AX  & ALA   &248\\
 Albanie &AL & ALB&  008\\
 Algérie    &DZ & DZA&  012\\
 Samoa américaines&   AS  & ASM&016\\
 Andorre& AD  & AND   &020\\
 Angola& AO  & AGO&024\\
 \hline
\end{tabular}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+table+using+the+multicolumn+command\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmultirow%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btabular%7D%7B+%7Cp%7B3cm%7D%7C%7Cp%7B3cm%7D%7Cp%7B3cm%7D%7Cp%7B3cm%7D%7C++%7D%0A+%5Chline%0A+%5Cmulticolumn%7B4%7D%7B%7Cc%7C%7D%7BCountry+List%7D+%5C%5C%0A+%5Chline%0A+Country+Name+or+Area+Name%26+ISO+ALPHA+2+Code+%26ISO+ALPHA+3+Code%26ISO+numeric+Code%5C%5C%0A+%5Chline%0A+Afghanistan+++%26+AF++++%26AFG%26+++004%5C%5C%0A+Aland+Islands%26+++AX++%26+ALA+++%26248%5C%5C%0A+Albania+%26AL+%26+ALB%26++008%5C%5C%0A+Algeria++++%26DZ+%26+DZA%26++012%5C%5C%0A+American+Samoa%26+++AS++%26+ASM%26016%5C%5C%0A+Andorra%26+AD++%26+AND+++%26020%5C%5C%0A+Angola%26+AO++%26+AGO%26024%5C%5C%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bdocument%7D)

![Exemple de tableau utilisant la commande multicolumn](/files/aa0ab1618eef274c33ce195f8be92e6b2dd4590f)

Passons en revue chaque composant de la commande `\multicolumn{4}{|c|}{Liste des pays} \\`:

**{4}**

Le nombre de colonnes à fusionner : 4 dans ce cas.

**{|c|}**

Délimiteurs et alignement de la cellule résultante : dans ce cas, le texte sera centré et une ligne verticale sera tracée de chaque côté de la cellule.

**{Liste des pays}**

Texte à afficher dans la cellule.

Pour combiner des lignes, vous devez ajouter le `multirow` package à l'en-tête de votre document :

```latex
\usepackage{multirow}
```

Vous pouvez ensuite utiliser la `\multirow` commande dans votre document :

```latex
\documentclass{article}
\usepackage{multirow}
\begin{document}
\begin{center}
\begin{tabular}{ |c|c|c| }
\hline
col1 & col2 & col3 \\
\hline
\multirow{3}{4em}{Ligne multiple} & cell2 & cell3 \\
& cell5 & cell6 \\
& cell8 & cell9 \\
\hline
\end{tabular}
\end{center}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Multirow+table+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmultirow%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A%5Cbegin%7Btabular%7D%7B+%7Cc%7Cc%7Cc%7C+%7D+%0A%5Chline%0Acol1+%26+col2+%26+col3+%5C%5C%0A%5Chline%0A%5Cmultirow%7B3%7D%7B4em%7D%7BMultiple+row%7D+%26+cell2+%26+cell3+%5C%5C+%0A%26+cell5+%26+cell6+%5C%5C+%0A%26+cell8+%26+cell9+%5C%5C+%0A%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D)

![Exemple de tableau utilisant la commande multirow](/files/bcb724f1d5069119faca861aac0611ae2f9f0053)

Le `multirow` commande prend trois paramètres ; notre exemple utilise les réglages suivants :

1. le nombre de lignes à fusionner : `3`
2. la largeur de la colonne : `4em`
3. le contenu de la cellule : `Ligne multiple`

## Tableaux multipages

Si vous devez insérer un tableau très long, qui occupe deux pages ou plus dans votre document, utilisez le `longtable` package. Tout d'abord, ajoutez la ligne suivante à l'en-tête de votre document :

```latex
\usepackage{longtable}
```

Vous pouvez ensuite utiliser la `longtable` environnement, comme montré dans l'exemple suivant :

```latex
\documentclass{article}
\usepackage{longtable}

\begin{document}

 \begin{longtable}[c]{| c | c |}
 \caption{Légende du tableau long.\label{long}}\\

 \hline
 \multicolumn{2}{| c |}{Début du tableau}\\
 \hline
 Quelque chose & autre chose\\
 \hline
 \endfirsthead

 \hline
 \multicolumn{2}{|c|}{Suite du tableau \ref{long}}\\
 \hline
 Quelque chose & autre chose\\
 \hline
 \endhead

 \hline
 \endfoot

 \hline
 \multicolumn{2}{| c |}{Fin du tableau}\\
 \hline\hline
 \endlastfoot

 Beaucoup de lignes & comme ceci\\
 Beaucoup de lignes & comme ceci\\
 Beaucoup de lignes & comme ceci\\
 Beaucoup de lignes & comme ceci\\
 Beaucoup de lignes & comme ceci\\
 Beaucoup de lignes & comme ceci\\
 Beaucoup de lignes & comme ceci\\
 Beaucoup de lignes & comme ceci\\
 ...
 Beaucoup de lignes & comme ceci\\
 \end{longtable}
```

![Exemple de tableau avec beaucoup de lignes](/files/b0685cfbf4973df9c393d1b06a45ef81f2e4e64c)

[Ouvrez un `longtable` exemple dans Overleaf](https://www.overleaf.com/project/new/template/20823?id=71401569\&templateName=Longtable+example\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

Le comportement de `longtable` est similaire au comportement par défaut `tabular`, mais génère des tableaux qui peuvent être coupés par l'algorithme standard de coupure de page de LaTeX. Il y a quatre `longtable`éléments propres à longtable :

**\endfirsthead**

Tout ce qui se trouve au-dessus de cette commande apparaîtra au début du tableau, sur la première page.

**\endhead**

Tout ce que vous mettez avant cette commande et sous \endfirsthead sera affiché en haut du tableau sur chaque page sauf la première.

**\endfoot**

Semblable à \endhead, ce que vous mettez après \endhead et avant cette commande apparaîtra en bas du tableau sur chaque page sauf la dernière.

**\endlastfoot**

Semblable à \endfirsthead. Les éléments après \endfoot et avant cette commande seront affichés en bas du tableau, mais uniquement sur la dernière page où le tableau apparaît.

## Positionnement des tableaux

Positionner un tableau est facile s'il se trouve dans un flottant `table` environnement.

```latex
\documentclass{article}
\begin{document}
Ci-dessous, un tableau placé exactement ici :
\begin{table}[h!]
\centering
 \begin{tabular}{||c c c c||}
 \hline
 Col1 & Col2 & Col2 & Col3 \\ [0.5ex]
 \hline\hline
 1 & 6 & 87837 & 787 \\
 2 & 7 & 78 & 5415 \\
 3 & 545 & 778 & 7507 \\
 4 & 545 & 18744 & 7560 \\
 5 & 88 & 788 & 6344 \\ [1ex]
 \hline
 \end{tabular}
\end{table}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Positioning+a+table\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ABelow+is+a+table+positioned+exactly+here%3A%0A%5Cbegin%7Btable%7D%5Bh%21%5D%0A%5Ccentering%0A+%5Cbegin%7Btabular%7D%7B%7C%7Cc+c+c+c%7C%7C%7D+%0A+%5Chline%0A+Col1+%26+Col2+%26+Col2+%26+Col3+%5C%5C+%5B0.5ex%5D+%0A+%5Chline%5Chline%0A+1+%26+6+%26+87837+%26+787+%5C%5C+%0A+2+%26+7+%26+78+%26+5415+%5C%5C%0A+3+%26+545+%26+778+%26+7507+%5C%5C%0A+4+%26+545+%26+18744+%26+7560+%5C%5C%0A+5+%26+88+%26+788+%26+6344+%5C%5C+%5B1ex%5D+%0A+%5Chline%0A+%5Cend%7Btabular%7D%0A%5Cend%7Btable%7D%0A%5Cend%7Bdocument%7D)

![Exemple de positionnement d'un tableau](/files/8e0b32ad9dd25f373efd7d606eca82fb3333d3da)

Le paramètre `h!` transmis à la déclaration de l'environnement table établit que ce tableau doit être placé *ici*, et remplace les valeurs par défaut de LaTeX. Les paramètres de positionnement que l'on peut transmettre comprennent :

**h**

Placera le tableau à peu près ici.

**t**

Place le tableau en haut de la page.

**b**

Place le tableau en bas de la page.

**p**

Place le tableau sur une page spéciale, réservée aux tableaux.

**!**

Outrepasse les paramètres internes de LaTeX.

**H**

Place le tableau à cet emplacement précis, un peu comme h!.

Pour d'autres exemples de positionnement de tableaux, consultez le [Positionnement des images et des tableaux](/latex/fr/figures-et-tableaux/02-positioning-images-and-tables.md) article.

Dans cet exemple, il y a quelques commandes supplémentaires :

**\centering**

Centre le tableau par rapport à l'élément conteneur du flottant.

**\[1ex]**

Cela ajoute un espace supplémentaire à la cellule.

## Légendes, étiquettes et références

Les tableaux peuvent être légendés, étiquetés et référencés au moyen de `table` environnement.

```latex
\documentclass{article}
\begin{document}
Le tableau \ref{table:1} est un exemple d'élément \LaTeX{} référencé.

\begin{table}[h!]
\centering
\begin{tabular}{||c c c c||}
 \hline
 Col1 & Col2 & Col2 & Col3 \\ [0.5ex]
 \hline\hline
 1 & 6 & 87837 & 787 \\
 2 & 7 & 78 & 5415 \\
 3 & 545 & 778 & 7507 \\
 4 & 545 & 18744 & 7560 \\
 5 & 88 & 788 & 6344 \\ [1ex]
 \hline
\end{tabular}
\caption{Tableau pour tester les légendes et les étiquettes.}
\label{table:1}
\end{table}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Table+captions+and+labels\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ATable+%5Cref%7Btable%3A1%7D+is+an+example+of+a+referenced+%5CLaTeX%7B%7D+element.%0A%0A%5Cbegin%7Btable%7D%5Bh%21%5D%0A%5Ccentering%0A%5Cbegin%7Btabular%7D%7B%7C%7Cc+c+c+c%7C%7C%7D+%0A+%5Chline%0A+Col1+%26+Col2+%26+Col2+%26+Col3+%5C%5C+%5B0.5ex%5D+%0A+%5Chline%5Chline%0A+1+%26+6+%26+87837+%26+787+%5C%5C+%0A+2+%26+7+%26+78+%26+5415+%5C%5C%0A+3+%26+545+%26+778+%26+7507+%5C%5C%0A+4+%26+545+%26+18744+%26+7560+%5C%5C%0A+5+%26+88+%26+788+%26+6344+%5C%5C+%5B1ex%5D+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Ccaption%7BTable+to+test+captions+and+labels.%7D%0A%5Clabel%7Btable%3A1%7D%0A%5Cend%7Btable%7D%0A%5Cend%7Bdocument%7D)

![Exemple d'éléments LaTeX référencés](/files/047964e3737912a8f183d4f3ddcaf28cd500f1fc)

Il y a trois commandes importantes dans l'exemple :

**\caption{Tableau pour tester les légendes et les étiquettes}**

Comme vous pouvez vous y attendre, cette commande définit la légende du tableau. Si vous créez une liste des tableaux, cette légende y sera utilisée. Vous pouvez la placer au-dessus ou en dessous du tableau.

**\label{table:1}**

Si vous devez faire référence au tableau dans votre document, définissez une étiquette avec cette commande. L'étiquette numérote le tableau et, combinée avec la commande \ref, vous permettra d'y faire référence.

**\ref{table:1}**

Ce code sera remplacé par le numéro correspondant au tableau référencé.

## Liste des tableaux

Pour créer une liste des tableaux, utilisez la `\listoftables` commande. La légende de chaque tableau sera utilisée pour générer cette liste. Pour les langues prises en charge par le `paquets babel` package, le titre « Liste des tableaux » sera traduit en conséquence. Consultez l'article sur [Prise en charge des langues internationales](/latex/fr/langues/03-international-language-support.md) pour plus d'informations.

```latex
\documentclass{article}
\begin{document}
\listoftables
\vspace{5pt}
Le tableau \ref{table:1} est un exemple d'éléments \LaTeX{} référencés.

\begin{table}[h!]
\centering
\begin{tabular}{||c c c c||}
 \hline
 Col1 & Col2 & Col2 & Col3 \\ [0.5ex]
 \hline\hline
 1 & 6 & 87837 & 787 \\
 2 & 7 & 78 & 5415 \\
 3 & 545 & 778 & 7507 \\
 4 & 545 & 18744 & 7560 \\
 5 & 88 & 788 & 6344 \\ [1ex]
 \hline
\end{tabular}
\caption{Ceci est la légende du premier tableau.}
\label{table:1}
\end{table}

\begin{table}[h!]
\centering
\begin{tabular}{||c c c c||}
 \hline
 Col1 & Col2 & Col2 & Col3 \\ [0.5ex]
 \hline\hline
  4 & 545 & 18744 & 7560 \\
 5 & 88 & 788 & 6344 \\ [1ex]
 \hline
\end{tabular}
\caption{Ceci est la légende du deuxième tableau.}
\label{table:2}
\end{table}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+using+listoftables\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Clistoftables%0A%5Cvspace%7B5pt%7D%0AThe+table+%5Cref%7Btable%3A1%7D+is+an+example+of+referenced+%5CLaTeX%7B%7D+elements.%0A%0A%5Cbegin%7Btable%7D%5Bh%21%5D%0A%5Ccentering%0A%5Cbegin%7Btabular%7D%7B%7C%7Cc+c+c+c%7C%7C%7D+%0A+%5Chline%0A+Col1+%26+Col2+%26+Col2+%26+Col3+%5C%5C+%5B0.5ex%5D+%0A+%5Chline%5Chline%0A+1+%26+6+%26+87837+%26+787+%5C%5C+%0A+2+%26+7+%26+78+%26+5415+%5C%5C%0A+3+%26+545+%26+778+%26+7507+%5C%5C%0A+4+%26+545+%26+18744+%26+7560+%5C%5C%0A+5+%26+88+%26+788+%26+6344+%5C%5C+%5B1ex%5D+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Ccaption%7BThis+is+the+caption+for+the+first+table.%7D%0A%5Clabel%7Btable%3A1%7D%0A%5Cend%7Btable%7D%0A%0A%5Cbegin%7Btable%7D%5Bh%21%5D%0A%5Ccentering%0A%5Cbegin%7Btabular%7D%7B%7C%7Cc+c+c+c%7C%7C%7D+%0A+%5Chline%0A+Col1+%26+Col2+%26+Col2+%26+Col3+%5C%5C+%5B0.5ex%5D+%0A+%5Chline%5Chline%0A++4+%26+545+%26+18744+%26+7560+%5C%5C%0A+5+%26+88+%26+788+%26+6344+%5C%5C+%5B1ex%5D+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Ccaption%7BThis+is+the+caption+for+the+second+table.%7D%0A%5Clabel%7Btable%3A2%7D%0A%5Cend%7Btable%7D%0A%5Cend%7Bdocument%7D)

![Exemple de liste des tableaux](/files/1db7202a6ded253916f6263a590fab6bf51f10f1)

## Modifier l'apparence d'un tableau

Plusieurs éléments d'un tableau peuvent être modifiés pour répondre aux besoins de votre document. Ci-dessous, vous apprendrez à modifier l'épaisseur des lignes, la couleur des lignes et la couleur d'arrière-plan des cellules de votre tableau.

### Épaisseur des lignes et espacement des cellules

La lisibilité d'un tableau peut parfois être améliorée en augmentant l'espacement des colonnes et l'interligne des lignes.

```latex
\documentclass{article}
\setlength{\arrayrulewidth}{0.5mm}
\setlength{\tabcolsep}{18pt}
\renewcommand{\arraystretch}{1.5}
\begin{document}
\begin{tabular}{ |p{3cm}|p{3cm}|p{3cm}|  }
\hline
\multicolumn{3}{|c|}{Liste des pays} \\
\hline
Nom du pays ou de la zone& Code ISO alpha 2 &Code ISO alpha 3 \\
\hline
Afghanistan & AF &AFG \\
Îles Åland & AX   & ALA \\
Albanie &AL & ALB \\
Algérie    &DZ & DZA \\
Samoa américaines & AS & ASM \\
Andorre & AD & AND   \\
Angola & AO & AGO \\
\hline
\end{tabular}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Changing+table+spacing\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Csetlength%7B%5Carrayrulewidth%7D%7B0.5mm%7D%0A%5Csetlength%7B%5Ctabcolsep%7D%7B18pt%7D%0A%5Crenewcommand%7B%5Carraystretch%7D%7B1.5%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btabular%7D%7B+%7Cp%7B3cm%7D%7Cp%7B3cm%7D%7Cp%7B3cm%7D%7C++%7D%0A%5Chline%0A%5Cmulticolumn%7B3%7D%7B%7Cc%7C%7D%7BCountry+List%7D+%5C%5C%0A%5Chline%0ACountry+Name+or+Area+Name%26+ISO+ALPHA+2+Code+%26ISO+ALPHA+3+%5C%5C%0A%5Chline%0AAfghanistan+%26+AF+%26AFG+%5C%5C%0AAland+Islands+%26+AX+++%26+ALA+%5C%5C%0AAlbania+%26AL+%26+ALB+%5C%5C%0AAlgeria++++%26DZ+%26+DZA+%5C%5C%0AAmerican+Samoa+%26+AS+%26+ASM+%5C%5C%0AAndorra+%26+AD+%26+AND+++%5C%5C%0AAngola+%26+AO+%26+AGO+%5C%5C%0A%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bdocument%7D)

![Exemple d'espacement des colonnes](/files/b9aab1c9f26323be06c58d36aca7d598bc742cdc)

Une description des commandes est fournie ci-dessous :

**\setlength{\arrayrulewidth}{0.5mm}**

Cela définit l'épaisseur des bordures du tableau. Dans l'exemple, elle est de 0,5 mm, mais vous pouvez utiliser d'autres unités — voir l'article Les longueurs en LaTeX pour une liste complète.

**\setlength{\tabcolsep}{18pt}**

L'espace entre le texte et la bordure gauche/droite de sa cellule contenante est défini à 18 pt avec cette commande. Là encore, vous pouvez utiliser d'autres unités si nécessaire.

**\renewcommand{\arraystretch}{1.5}**

La hauteur de chaque ligne est définie à 1,5 par rapport à sa hauteur par défaut.

### Coloration alternée des lignes

Vous pouvez appliquer des couleurs alternées aux lignes de votre tableau en utilisant le `xcolor` package avec l'option `table` , comme démontré dans l'exemple suivant :

```latex
\documentclass{article}
\usepackage[table]{xcolor}
\setlength{\arrayrulewidth}{0.5mm}
\setlength{\tabcolsep}{18pt}
\renewcommand{\arraystretch}{2.5}
\begin{document}
{\rowcolors{3}{green!80!yellow!50}{green!70!yellow!40}
\begin{tabular}{ |p{3cm}|p{3cm}|p{3cm}|  }
\hline
\multicolumn{3}{|c|}{Liste des pays} \\
\hline
Nom du pays ou de la zone& Code ISO alpha 2 &Code ISO alpha 3 \\
\hline
Afghanistan & AF &AFG \\
Îles Åland & AX   & ALA \\
Albanie &AL & ALB \\
Algérie    &DZ & DZA \\
Samoa américaines & AS & ASM \\
Andorre & AD & AND   \\
Angola & AO & AGO \\
\hline
\end{tabular}}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Changing+row+colours\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Btable%5D%7Bxcolor%7D%0A%5Csetlength%7B%5Carrayrulewidth%7D%7B0.5mm%7D%0A%5Csetlength%7B%5Ctabcolsep%7D%7B18pt%7D%0A%5Crenewcommand%7B%5Carraystretch%7D%7B2.5%7D%0A%5Cbegin%7Bdocument%7D%0A%7B%5Crowcolors%7B3%7D%7Bgreen%2180%21yellow%2150%7D%7Bgreen%2170%21yellow%2140%7D%0A%5Cbegin%7Btabular%7D%7B+%7Cp%7B3cm%7D%7Cp%7B3cm%7D%7Cp%7B3cm%7D%7C++%7D%0A%5Chline%0A%5Cmulticolumn%7B3%7D%7B%7Cc%7C%7D%7BCountry+List%7D+%5C%5C%0A%5Chline%0ACountry+Name+or+Area+Name%26+ISO+ALPHA+2+Code+%26ISO+ALPHA+3+%5C%5C%0A%5Chline%0AAfghanistan+%26+AF+%26AFG+%5C%5C%0AAland+Islands+%26+AX+++%26+ALA+%5C%5C%0AAlbania+%26AL+%26+ALB+%5C%5C%0AAlgeria++++%26DZ+%26+DZA+%5C%5C%0AAmerican+Samoa+%26+AS+%26+ASM+%5C%5C%0AAndorra+%26+AD+%26+AND+++%5C%5C%0AAngola+%26+AO+%26+AGO+%5C%5C%0A%5Chline%0A%5Cend%7Btabular%7D%7D%0A%5Cend%7Bdocument%7D)

![Exemple de coloration des lignes d'un tableau](/files/a0aa1244e9ae8cb196023f45255ac465cba4a6b1)

Remarquez les accolades juste avant la commande

```latex
\rowcolors{3}{green!80!yellow!50}{green!70!yellow!40}
```

et après le `tabular` environnement. La commande `\rowcolors` prend trois paramètres, chacun passé entre accolades :

* la ligne de départ,
* la couleur des lignes impaires et
* la couleur des lignes paires.

Voir le `xcolor` documentation du package (dans la [lectures complémentaires](#further-reading) section) pour obtenir la liste des couleurs disponibles et savoir comment créer les vôtres. Dans l'exemple, les couleurs verte et jaune sont mélangées en proportions différentes.

Pour que la commande fonctionne, assurez-vous d'ajouter

```latex
\usepackage[table]{xcolor}
```

à l'en-tête de votre fichier LaTeX.

### Coloration d'un tableau (cellules, lignes, colonnes et lignes)

Tous les éléments d'un tableau peuvent être personnalisés pour utiliser une couleur spécifique. Là encore, cette fonctionnalité est fournie par **xcolor** vous devez donc ajouter

```latex
\usepackage[table]{xcolor}
```

à l'en-tête. Vous pouvez voir ci-dessous un exemple.

```latex
\documentclass{article}
\usepackage[table]{xcolor}
\setlength{\arrayrulewidth}{1mm}
\setlength{\tabcolsep}{18pt}
\renewcommand{\arraystretch}{2.5}
\newcolumntype{s}{>{\columncolor[HTML]{AAACED}} p{3cm}}
\arrayrulecolor[HTML]{DB5800}
\begin{document}
\begin{tabular}{ |s|p{3cm}|p{3cm}| }
\hline
\rowcolor{lightgray} \multicolumn{3}{|c|}{Liste des pays} \\
\hline
Nom du pays ou de la zone& Code ISO alpha 2 &Code ISO alpha 3 \\
\hline
Afghanistan & AF &AFG \\
\rowcolor{gray}
Îles Åland & AX & ALA \\
Albanie   &AL & ALB \\
Algérie  &DZ & DZA \\
Samoa américaines & AS & ASM \\
Andorre & AD & \cellcolor[HTML]{AA0044} AND    \\
Angola & AO & AGO \\
\hline
\end{tabular}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+using+colour+in+a+table\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Btable%5D%7Bxcolor%7D%0A%5Csetlength%7B%5Carrayrulewidth%7D%7B1mm%7D%0A%5Csetlength%7B%5Ctabcolsep%7D%7B18pt%7D%0A%5Crenewcommand%7B%5Carraystretch%7D%7B2.5%7D%0A%5Cnewcolumntype%7Bs%7D%7B%3E%7B%5Ccolumncolor%5BHTML%5D%7BAAACED%7D%7D+p%7B3cm%7D%7D%0A%5Carrayrulecolor%5BHTML%5D%7BDB5800%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btabular%7D%7B+%7Cs%7Cp%7B3cm%7D%7Cp%7B3cm%7D%7C+%7D%0A%5Chline%0A%5Crowcolor%7Blightgray%7D+%5Cmulticolumn%7B3%7D%7B%7Cc%7C%7D%7BCountry+List%7D+%5C%5C%0A%5Chline%0ACountry+Name+or+Area+Name%26+ISO+ALPHA+2+Code+%26ISO+ALPHA+3+%5C%5C%0A%5Chline%0AAfghanistan+%26+AF+%26AFG+%5C%5C%0A%5Crowcolor%7Bgray%7D%0AAland+Islands+%26+AX+%26+ALA+%5C%5C%0AAlbania+++%26AL+%26+ALB+%5C%5C%0AAlgeria++%26DZ+%26+DZA+%5C%5C%0AAmerican+Samoa+%26+AS+%26+ASM+%5C%5C%0AAndorra+%26+AD+%26+%5Ccellcolor%5BHTML%5D%7BAA0044%7D+AND++++%5C%5C%0AAngola+%26+AO+%26+AGO+%5C%5C%0A%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bdocument%7D)

![Exemple de couleur personnalisée dans un tableau](/files/71d334c6b8d861e7e13be2630b91274552bed051)

Voici une description de la manière de changer la couleur de chaque élément du tableau :

* **Couleur des lignes**. La commande `\arrayrulecolor` est utilisée pour cela. Dans l'exemple, un format HTML est utilisé, mais d'autres formats sont également disponibles ; voir la documentation de xcolor pour une liste complète (lien fourni dans la [lectures complémentaires](#further-reading) section).
* **Couleur d'arrière-plan d'une cellule**. Utilisez la commande `\cellcolor`. Vous pouvez soit saisir le nom directement entre les accolades (red, gray, green, etc.), soit passer un paramètre de format entre crochets (HTML dans l'exemple), puis définir la couleur souhaitée entre les accolades en utilisant le format établi.
* **Couleur d'arrière-plan d'une ligne**. Dans ce cas `\rowcolor` s'en chargera. Les mêmes remarques sur le choix des couleurs mentionnées dans les deux commandes précédentes s'appliquent également à celle-ci.
* **Couleur d'arrière-plan d'une colonne**. Celle-ci est un peu délicate, mais la façon la plus simple est de définir un nouveau type de colonne. La commande

  ```latex
  \newcolumntype{s}{>{\columncolor[HTML]{AAACED}} p{3cm}}
  ```

  définit un type de colonne appelé `e` dont l'alignement est `p`, la largeur de la colonne est `3cm` et la couleur est définie au format HTML sur `AAACED`. Ce nouveau type de colonne est utilisé dans le `tabular` environnement.

## Guide de référence

Brève description des paramètres dans la `tabular` environnement.

Les tableaux peuvent être créés à l'aide de `tabular` environnement.

```
\begin{tabular}[pos]{cols}
 contenu du tableau
\end{tabular}
```

où les options peuvent être :

* **`pos`** : Position verticale. Il peut prendre les valeurs suivantes :

|               |                                                             |
| ------------- | ----------------------------------------------------------- |
| `t`           | la ligne du haut est alignée avec la ligne de base du texte |
| `b`           | la ligne du bas est alignée avec la ligne de base du texte  |
| `c` ou aucune | le tableau est centré sur la ligne de base du texte         |

* **`cols`** : Définit l'alignement et les bordures de chaque colonne. Il peut prendre les valeurs suivantes :

|                |                                                                                            |
| -------------- | ------------------------------------------------------------------------------------------ |
| `l`            | colonne alignée à gauche                                                                   |
| `c`            | colonne centrée                                                                            |
| `r`            | colonne alignée à droite                                                                   |
| `p{'width'}`   | colonne de paragraphe avec texte aligné verticalement en haut                              |
| `m{'width'}`   | colonne de paragraphe avec texte aligné verticalement au milieu (nécessite `array` paquet) |
| `b{'width'}`   | colonne de paragraphe avec texte aligné verticalement en bas (nécessite `array` paquet)    |
| `\|`           | ligne verticale                                                                            |
| `\|\|`         | double ligne verticale                                                                     |
| `*{num}{form}` | le format est répété *num* fois ; par exemple `*{3}{\|l}\|` est équivalent à `\|l\|l\|l\|` |

Pour séparer les cellules et introduire de nouvelles lignes, utilisez les commandes suivantes :

|                |                                                                                                                                  |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `&`            | séparateur de colonnes                                                                                                           |
| `\\`           | commencer une nouvelle ligne (un espace supplémentaire peut être spécifié après `\\` en utilisant des crochets, comme `\\[6pt]`) |
| `\hline`       | ligne horizontale entre les lignes                                                                                               |
| `\newline`     | commencer une nouvelle ligne dans une cellule (dans une colonne de paragraphe)                                                   |
| `\\cline{i-j}` | ligne horizontale partielle commençant dans la colonne *i* et se terminant dans la colonne *j*                                   |

## Lectures complémentaires

Pour plus d'informations, voir

* [Comment insérer des tableaux dans Overleaf](/latex/fr/base-de-connaissances/067-how-to-generate-and-insert-latex-tables-in-overleaf.md)
* [Positionnement des images et des tableaux](/latex/fr/figures-et-tableaux/02-positioning-images-and-tables.md)
* [Listes des tableaux et des figures](/latex/fr/figures-et-tableaux/03-lists-of-tables-and-figures.md)
* [Longueurs en LaTeX](/latex/fr/mise-en-forme/01-lengths-in-latex.md)
* [Utiliser les couleurs dans LaTeX](/latex/fr/mise-en-forme/13-using-colors-in-latex.md)
* [Manuel du package xcolor](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf)
* [Manuel du package tabularx](https://texdoc.org/pkg/tabularx)
* [Manuel du package longtable](http://mirrors.ctan.org/macros/latex/required/tools/longtable.pdf)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/fr/figures-et-tableaux/01-tables.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
