1 Introduction

Le package DT¹ est une interface de la bibliothèque JavaScript DataTables². Il rend accessible les fonctionnalités de la librairie originale en R. La principale fonction de DT est datatable. Cette fonction permet de construire rapidement et efficacement un tableau interactif en format HTML à partir d’un data frame ou d’une matrice. Le format HTML des tableaux générés par datatable est alors compatible avec les énormes possibilités que permettent les packages rmarkdown et shiny. La fonction datatable offre plusieurs possibilités concernant l’affichage, la filtration de données, la pagination, le tri et bien plus. Un simple tableau est facilement transformé en un tableau interactif avec un esthétisme soigné. C’est définitivement une alternative à la création de tableaux de base (tableaux générés en Markdown avec les caractères « - » et « | »).

Nous pouvons maintenant installer (si ce n’est pas déjà fait) et charger le package DT³.

if (!require("DT")) install.packages('DT')
packageVersion("DT")
## [1] '0.17'
library("DT")

Note. Cette fiche a été créée avec la version 0.17 de DT et 2.6 de rmarkdown. Il se peut qu’il y ait eu des ajouts ou des modifications si vos versions sont plus récentes.

Pour présenter les exemples d’utilisation de DT nous utiliserons des données sur la population des villes canadiennes extraites du site internet de Statistique Canada⁴.

populationVillesCanada <- readRDS("populationVillesCanada.rds")
str(populationVillesCanada)

## 'data.frame':    33 obs. of  4 variables:
##  $ Ville              : chr  "St. John's" "Halifax" "Moncton" ...
##  $ Population2007     : int  186067 386498 131123 125550 157213 736993 195028 147023 ...
##  $ Population2017     : int  219207 431701 152169 128541 159258 812205 218633 158942 ...
##  $ VariationPopulation: num  17.8 11.7 16.1 2.4 1.3 10.2 12.1 8.1 ...

3 Arguments

Les arguments de datatable modifient le tableau et y ajoutent des propriétés utiles au lecteur. Dans cette section, les principaux arguments seront abordés.

datatable(populationVillesCanada, rownames = FALSE,
          options = list(pageLength = 5))
          # L'option ajoutée sert à restreindre le nombre de lignes affichées.

datatable(populationVillesCanada, colnames = c('NouveauNom' = 'VariationPopulation'),
          options = list(pageLength = 5))

datatable(populationVillesCanada, colnames = c('Col1', 'Col2', 'Col3', 'Col4'),
          options = list(pageLength = 5))

datatable(data = populationVillesCanada, rownames = FALSE, class = "hover",
          options = list(pageLength = 5))

datatable(data = populationVillesCanada, 
          rownames = FALSE, 
          class = "hover cell-border", # La modification est combinée à la précédente.
          options = list(pageLength = 5))

datatable(data = populationVillesCanada, 
          rownames = FALSE, 
          class = "hover cell-border compact",
          options = list(pageLength = 5))

datatable(populationVillesCanada, 
          rownames = FALSE, 
          class = "hover cell-border compact", 
          caption = "Tableau 1: Estimations de la population, selon la région métropolitaine de recensement.",
          options = list(pageLength = 5))

datatable(populationVillesCanada, 
          rownames = FALSE, 
          class = "hover cell-border compact", 
          caption = "Tableau 1: Estimations de la population, selon la région métropolitaine de recensement.",
          filter = 'top', # Les filtres sont positionnés au-dessus des colonnes.
          options = list(pageLength = 5))

datatable(populationVillesCanada, 
          rownames = FALSE,
          class = "hover cell-border compact", 
          caption = "Tableau 1: Estimations de la population, selon la région métropolitaine de recensement.",
          filter = 'top', 
          editable = TRUE,
          options = list(pageLength = 5))

6 Autres

Cette fiche détaille les principaux arguments de datatable. Consultez l’annexe 1 pour plus d’informations.

Le package DT contient aussi d’autres fonctions⁶. Par exemple, coerceValue, qui permet de remplacer rapidement une chaîne de caractères par une autre.

L’opérateur foward-pipe %>%, provenant du package magrittr, est importé par le package DT. Il n’est donc pas nécessaire de charger le package magrittr pour y avoir accès lorsque le package DT est chargé.

Pour finir, comme le package DT est fait pour produire des tableaux en HTML, il s’intègre facilement dans des applications shiny. Il est donc possible de produire un tableau DT dans une application shiny et d’interagir avec celui-ci ou d’afficher des éléments en temps réel. Pour ce faire, les principales fonctions sont dataTableAjax, dataTableOutput et dataTableProxy⁷.

7 Conclusion

Le package DT est un wrapper de la bibliothèque JavaScript DataTables, dont la principale fonction est datatable. L’exécution de la fonction datatable combinée à un data frame ou une matrice permet de générer un tableau interactif en format HTML. Le tableau possède des éléments interactifs qui permettent de moduler et filtrer l’affichage des données contenues dans le tableau. De plus, les éléments de base qui composent ce tableau peuvent convenir pour la plupart des occasions. Si l’affichage ne comble pas tous les besoins, davantage d’arguments, d’options, de fonctions, d’extensions et de plug-ins sont disponibles. Parmi toutes ces possibilités, filter, language et order sont nos coups de coeur. Comme les tableaux générés sont en format HTML, il est facile de les intégrer à un rapport R Markdown ou dans une application shiny.

La grand avantage d’un tableau généré par DT par rapport à un tableau Markdown de base (généré avec les caractères « - » et « | ») est que les valeurs affichées sont celles contenues dans un data frame ou une matrice et non pas des valeurs saisies à la main.

Il y a beaucoup de similitudes entre DT et kableExtra⁸. Avec les deux packages, il est possible de faire des tableaux en HTML hautement modifiables. La majorité des fonctions abordées dans ce tutoriel ont une équivalence avec kableExtra. Cependant, DT se démarque par ses capacités interactives, comme la fenêtre de recherche, le tri ou l’affichage des données sur plusieurs pages. Par contre, kableExtra a l’avantage d’être compatible avec Latex pour intégrer des tableaux dans des documents PDF.

Un petit inconvénient au package DT concerne l’affichage des tableaux dans R Markdown. L’affichage est très pâle et peut rendre la lecture difficile, surtout si utilisé avec un projecteur (lors d’une présentation par exemple). Le problème est facilement réglable en changeant le thème de base dans R Markdown. Pour obtenir un affichage adéquat, il faut étrangement ajouter un retour de chariot à la suite du tableau qui vient juste d’être généré. Il est important de souligner que la version de DT utilisée ici est 0.6. Une version inférieure à 1 indique souvent que c’est une version bêta. Cela laisse croire que des inconvénients comme ce problème d’affichage trop pâle seront résolus dans une prochaine version stable.

Somme toute, le package DT est un incontournable pour l’affichage d’un tableau HTML interactif.