Passer au contenu principal

Pagination de table

Utilisation​

Présentation​

La pagination permet aux utilisateurs de naviguer dans de grands ensembles de données en divisant le contenu en pages gérables. Elle fournit des commandes permettant de parcourir les pages et d’ajuster le nombre d’éléments affichés en même temps, ce qui est essentiel pour maintenir les performances et la lisibilité dans les applications gourmandes en données.

Quand l'utiliser​

  • Pour gérer des ensembles de données volumineux : utilisez cette fonction lorsqu’une table comporte des centaines ou des milliers de lignes et que leur affichage simultané a un impact sur les performances ou le temps de chargement des pages.
  • Pour améliorer la lisibilité : utilisez cette fonction lorsqu'une trop grande quantité de données sur une page submerge les utilisateurs, ce qui rend plus difficile la recherche ou la comparaison des valeurs.
  • Pour améliorer l’accessibilité : utilisez cette fonction lorsque les tables volumineuses génèrent des problèmes de navigation pour les lecteurs d’écran ou les utilisateurs du clavier (par exemple, une table comportant des centaines de lignes n’est pas pratique à explorer).
  • Pour exploiter les vues filtrées : utilisez cette fonction lorsque les utilisateurs consultent généralement un sous-ensemble de données, comme des résultats de recherche ou des vues filtrées. La pagination permet de les guider et facilite la gestion des blocs.

Quand ne pas l'utiliser​

  • Pour les petits ensembles de données : évitez cette fonction si toutes les lignes peuvent être affichées sans problèmes de performances ou sans surcharger l’utilisateur (par exemple, 20 à 50 lignes).
  • Pour les tâches de comparaison de grande ampleur : évitez cette fonction lorsque les utilisateurs doivent comparer plusieurs lignes à la fois ; envisagez plutôt le défilement virtuel ou les vues filtrées.
  • Pour les tâches reposant sur une vue unique : n’utilisez pas cette fonction si l’ensemble de données représente un ensemble complet qui ne peut pas être réparti sur plusieurs pages, comme une table de paramètres.

Formatage​

Structure​

Structure du composant de pagination, avec des légendes numérotées pour le sélecteur « Lignes par page », l’affichage de la plage d’éléments et des boutons de navigation.

Le composant de pagination apparaît au bas du contenu qu’il contrôle et se compose des éléments suivants :

  1. Sélection des lignes par page : liste déroulante qui permet aux utilisateurs de modifier le nombre d’éléments affichés sur chaque page.
  2. Affichage de la plage d’éléments : étiquette de texte qui indique les éléments actuellement affichés dans le contexte du nombre total d’éléments (par exemple, « 1 - 10 sur 25 »).
  3. Commandes de navigation : boutons avec icônes permettant aux utilisateurs de passer à la page de données précédente ou suivante, ainsi qu’à la première et à la dernière page.

Contenu​

Directives générales relatives à la rédaction​

  • Mettez une majuscule en début de phrase pour tous les aspects relatifs à la conception des interfaces de produit Guidewire. Ne mettez pas la 1re lettre du 1er mot du titre en majuscule.
  • Utilisez des verbes au présent et la forme active dans la plupart des cas.
  • Utilisez des contractions courantes pour donner à votre texte un ton plus naturel et informel.
  • Utilisez un langage simple. Évitez tout jargon inutile et les formulations complexes.
  • Utilisez des termes et des phrases concis.

Comportements​

États​

Les principaux états du composant de pagination sont liés à ses commandes de navigation.

  • Le bouton Page précédente doit être désactivé lorsque l’utilisateur se trouve sur la première page de données.
  • Le bouton Page suivante doit être désactivé lorsque l’utilisateur se trouve sur la dernière page de données.

Interactions​

  • La sélection d’une nouvelle valeur dans la liste déroulante Lignes par page recharge le composant associé pour afficher le nombre d’éléments choisi.
  • En cliquant sur les boutons Page suivante ou Page précédente, l’utilisateur navigue dans l’ensemble de données, une page à la fois.

Approches en termes d’utilisation de la pagination​

  • Utilisation par défaut : utilisez le composant dans un contexte synchrone standard. Les clients fournissent les valeurs directement au composant.
  • Utilisation avec des tables asynchrones : lorsqu’elle est utilisée avec des tables qui récupèrent des données de manière asynchrone auprès d’un serveur, la pagination reflète l’état actuel de la table. Le composant lui-même reste synchrone ; la table gère la logique asynchrone. Cette approche s’applique à la fois à l’utilisation par défaut et à l’utilisation de TanStack Table.
  • Utilisation de TanStack Table : lors de l’utilisation d’une table gérée par TanStack Table, l’utilisateur transmet l’état de pagination de la table au composant de pagination. Cela permet à l’interface utilisateur de pagination de refléter l’état actuel de la table, y compris les mises à jour asynchrones ou pilotées par le serveur gérées par la table.

Accessibilité​

Ce composant a été validé pour répondre aux directives d’accessibilité WCAG 2.2 AA dans sa configuration de base par défaut. Il s’agit notamment de s’assurer que :

  • Le rapport de contraste des éléments textuels par rapport à leur arrière-plan est supérieur à 4.5:1.
  • Le contenu non textuel qui doit transmettre le sens (comme les icônes et les indicateurs de focus) a un rapport de contraste d’au moins 3:1 avec ses couleurs adjacentes.
  • Cet élément peut être utilisé à l’aide d’un clavier et d’une souris.
  • Le contenu est accessible à l’aide de lecteurs d’écran, tels que JAWS et VoiceOver.

La conformité de l’accessibilité dépend en définitive de la façon dont ce composant est implémenté et personnalisé. Les modifications apportées par l’auteur du contenu peuvent affecter l’accessibilité. Pour en savoir plus sur notre modèle de responsabilité partagée, consultez notre Déclaration d’accessibilité Jutro complète.

Lorsque vous utilisez ce composant dans votre application, respectez les meilleures pratiques suivantes :

  • Interaction avec le clavier : tous les contrôles du composant de pagination doivent être accessibles et activables au clavier. Les utilisateurs doivent pouvoir naviguer entre les boutons déroulants et de navigation à l’aide de la touche Tab et les activer à l’aide des touches Enter ou Space.
  • Lecteur d’écran : le composant de pagination doit être enveloppé dans un élément <nav> avec un élément aria-label de type « pagination » pour l’identifier comme une région de repérage. Tous les contrôles doivent avoir des noms clairs et accessibles. Pour les boutons de navigation, utilisez des attributs aria-label tels que « Aller à la page précédente » et « Passer à la page suivante ». L’affichage de la plage d’éléments (par exemple, « 1 - 10 sur 25 ») doit être associé par programmation aux commandes afin qu’il puisse être annoncé aux utilisateurs de lecteurs d’écran et fournir ainsi un contexte essentiel pour la navigation.