Aller au contenu
SkillCodex
Menu

Pagination

Pagination

Un ensemble de liens de navigation qui parcourt les pages sœurs d’une même collection de contenu découpée par quantité.

Essayer le composant
Repères, sources et actions
Sources et révision
Mis à jour le
Version
v1.0.26 · r1
Sources
5 sources
Statut
Publié
Consulter les sources

Tu as peut-être cherché : afficher la page suivante des résultatsaller directement à la page dixdes liens précédent et suivant pour les résultats

Toutes les formulations
Enregistrer et partager

Reconnaître

S’orienter dans un parcours

Essayer

Faut-il situer la page dans une hiérarchie, parcourir des pages de résultats ou montrer l’étape d’un processus ?

Pagination

Contexte commun aux essais

Une personne doit comprendre où elle se trouve et quel déplacement est possible, sans confondre hiérarchie du site, pages de résultats et étapes d’un processus.

Pagination

Mission

Pagination

Active Suivant, va directement à la page 3 puis reviens avec Précédent en vérifiant l’état de page actuelle.

Enregistrements de la page 1

Résultat de l’essai

Page 1 sur 3 affichée.

Étape 1 sur 3

Essayer

Manipule le composant. Le résultat de ton essai apparaît juste au-dessus. Avance à ton rythme.

Comportement et cas limite
À observer
La page 1 est actuelle et Précédent est indisponible à la première page.
Cas limite
Un total final inconnu omet une fausse destination de dernière page et garde Suivant fidèle à la réalité.

Ce que cet essai montre

La pagination change la tranche, découpée par quantité, d’une collection ; le fil d’Ariane expose une hiérarchie, tandis que l’indicateur d’étapes représente des étapes métier.

Lequel convient à ton besoin ?

Pagination

Des résultats ou collections ont besoin de pages stables et partageables

Fil d’Ariane

Les pages appartiennent à une hiérarchie de plusieurs niveaux

Quel composant utilises-tu ici ?
Différence et sources

La pagination change la tranche, découpée par quantité, d’une collection ; le fil d’Ariane expose une hiérarchie, tandis que l’indicateur d’étapes représente des étapes métier.

Consulter les sources

    Parties du spécimen

    Sélectionne un repère numéroté sur le schéma, ou utilise la liste ci-dessous, pour afficher son rôle. Le schéma montre l'état représentatif du concept.

    Liste de pages

    L’ensemble ordonné des destinations de page disponibles et des intervalles masqués.

    Position dans l’atlas

    Carte relationnelle

    Repère le chapitre, les concepts proches et la prochaine décision utile.

    • Chapitre

      S’orienter dans un parcours

      Pagination appartient à ce groupe de concepts comparés.

    • Ne pas confondre

      Fil d’Ariane

      Choisis Pagination si une longue liste ou un ensemble de résultats est découpé en pages stables et partageables. Choisis Fil d’Ariane si la page courante a des parents vers lesquels l’utilisateur peut vouloir revenir.

      Comparer cette paire
    • Ne pas confondre

      Indicateur d’étapes

      Choisis Pagination si les pages sont des tranches équivalentes d’une collection et qu’aucune ne doit être terminée avant une autre. Choisis Indicateur d’étapes si un processus linéaire comporte au moins trois étapes utiles que l’utilisateur accomplit dans l’ordre.

      Comparer cette paire
    • Prochaine étape

      Compare les concepts du chapitre avant de retenir une implémentation.

      Ouvrir le chapitre

    Avec tes mots

    Comprendre

    Ce que les gens décrivent

    Alias documentés : navigation par pages, sélecteur de page, contrôles de pages

    • afficher la page suivante des résultats
    • aller directement à la page dix
    • des liens précédent et suivant pour les résultats
    • découper une longue liste en pages numérotées
    • aller à la dernière page des résultats
    • montrer sur quelle page de résultats je suis

    Choisir

    À utiliser quand

    • Des résultats ou collections ont besoin de pages stables et partageables
    • Tu dois permettre d’atteindre une page ou une limite connue

    À éviter quand

    • Les sections diffèrent par leur sens ou leur étape métier
    • Le chargement continu est essentiel et aucune destination de page n’existe

    Comparer

    Comparer les concepts proches

    Checklist de vérification

    Essaie ces gestes dans le lab, puis vérifie les mêmes comportements dans le résultat de ton agent. Adapte les noms d’exemple à ton interface.

    1. 1. À faire

      Passe à la page suivante, choisis une autre page numérotée, puis reviens en arrière.

      Résultat attendu

      Les éléments affichés correspondent à chaque page demandée, et une seule page est indiquée comme actuelle.

    2. 2. À faire

      Consulte la première page et, lorsque le total est connu, la dernière.

      Résultat attendu

      Les actions précédente ou suivante indisponibles ne sortent pas des limites ; un total inconnu ne crée pas de fausse dernière page.

    3. 3. À faire

      Navigue avec Tab et Entrée, puis identifie les nouveaux résultats affichés.

      Résultat attendu

      Les liens de page fonctionnent au clavier, les points de suspension ne sont pas des arrêts supplémentaires et une mise à jour sur place annonce la page ou place volontairement le focus sur son titre.

    Contrat complet
    1. 1La région de navigation est nommée
    2. 2Chaque page disponible possède un vrai href
    3. 3Un seul lien porte aria-current=page
    4. 4Les ellipses ne sont pas des contrôles
    5. 5Les mises à jour sur place gèrent le focus ou annoncent le contexte

    Comprendre → Reconnaître → Choisir → Comparer

    Pack pour ton agent

    Instructions pré-écrites à coller dans ton agent. Copier n’exécute rien.

    Implémenter correctement

    Construis Pagination sans casser son comportement

    # Implémenter Pagination dans ton agent
    
    ## Objectif
    Implémente Pagination pour ce comportement vérifié : Un ensemble de liens de navigation qui parcourt les pages sœurs d’une même collection de contenu découpée par quantité.
    
    ## Prérequis
    - Inspecte d’abord le dépôt, le design system et les tests existants.
    - Préserve les changements sans rapport et borne les fichiers modifiés.
    - Confirme que Pagination répond au besoin avant de coder.
    
    ## Comportement requis
    - Un lien de page, Précédent ou Suivant charge une autre tranche quantitative de la même collection.
    - Le pointeur, le toucher ou Entrée suit le lien ; Espace conserve son comportement natif de défilement de page.
    
    ## États à couvrir
    - Page 1
    - Page 2
    - Page 3
    
    ## Accessibilité
    - Rôle ARIA : nav[aria-label] > ul > li > a[aria-current=page]
    - Le contrôle principal ou la région nommée pour Pagination possède un nom accessible stable issu d’un texte visible ou d’un libellé programmatique explicite ; le placeholder et l’infobulle ne servent pas de nom.
    - La navigation native suit le navigateur ; une mise à jour sur place déplace le focus vers le titre des résultats ou annonce la nouvelle page de façon cohérente.
    - La pagination est une navigation persistante et ne se ferme pas.
    - Nommer les destinations numériques Page N, marquer exactement une page actuelle et garder les intervalles non interactifs.
    - Tab et Maj+Tab parcourent les liens disponibles
    - Entrée active la destination focalisée
    - Les ellipses ne reçoivent jamais le focus
    
    ## Quand ne pas utiliser
    - Les sections diffèrent par leur sens ou leur étape métier
    - Le chargement continu est essentiel et aucune destination de page n’existe
    
    ## Critères d’acceptation
    - La région de navigation est nommée
    - Chaque page disponible possède un vrai href
    - Un seul lien porte aria-current=page
    - Les ellipses ne sont pas des contrôles
    - Les mises à jour sur place gèrent le focus ou annoncent le contexte
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    
    • Web platform
    • Prérequis · Accès au dépôt, au design system et aux tests
    Pourquoi ça marche
    • Le besoin est relié au comportement canonique avant toute décision technique.
    • Les états, l’accessibilité et les non-objectifs empêchent une implémentation seulement visuelle.
    • Les critères d’acceptation et le format de sortie rendent la vérification observable.

    À essayer ensuite

    Vérifie Pagination sur un parcours réel

    # Vérifier Pagination après l’implémentation
    
    ## Objectif
    Audite l’implémentation de Pagination au regard de son comportement, de ses états et de ses exigences d’accessibilité sans la modifier automatiquement.
    
    ## Contrôles
    - Rejoue le plus petit parcours représentatif.
    - Contrôle le clavier, le focus, le nom accessible et les annonces.
    - Relie chaque écart à un critère d’acceptation précis.
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    

    sha256:44943895d8f163d4abe190cac881d1482130e3b9453866df3efd624b22eb541d

    Diagnostiquer un problème

    Trouve et corrige le défaut de Pagination

    # Déboguer Pagination dans ton agent
    
    ## Symptôme observé
    [DÉCRIS ICI LE SYMPTÔME]
    
    ## Contrôles observables
    - Reproduis le problème avec le plus petit parcours pertinent.
    - Compare le comportement aux états et transitions documentés de Pagination.
    - Vérifie le clavier, le focus, le nom accessible et les annonces.
    
    ## Causes possibles
    - La primitive employée ne correspond pas au comportement attendu.
    - Un état, une transition ou un retour de focus manque.
    - Le composant voisin capture un événement ou masque un signal accessible.
    
    ## Corrections bornées
    - Corrige la cause reproduite sans recréer les composants voisins.
    - Conserve le contrat public et ajoute un test ciblé de non-régression.
    - N’installe aucune dépendance et ne modifie aucun état distant sans autorisation.
    
    ## Vérification finale
    - La région de navigation est nommée
    - Chaque page disponible possède un vrai href
    - Un seul lien porte aria-current=page
    - Les ellipses ne sont pas des contrôles
    - Les mises à jour sur place gèrent le focus ou annoncent le contexte
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    
    • Web platform
    • Prérequis · Accès au dépôt, au design system et aux tests
    Pourquoi ça marche
    • Le symptôme explicite évite de partir d’une correction supposée.
    • Les contrôles séparent comportement, accessibilité et interférences voisines.
    • La correction reste bornée et doit produire une preuve de non-régression.

    À essayer ensuite

    Verrouille la correction de Pagination

    # Empêcher la régression de Pagination
    
    ## Objectif
    Transforme la cause reproduite en test de non-régression ciblé et compare Pagination aux concepts voisins avant d’élargir la correction.
    
    ## Contrôles
    - Prouve que le test échoue avant la correction.
    - Prouve qu’il passe après la correction bornée.
    - Vérifie qu’aucun composant voisin n’a changé de comportement.
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    

    sha256:313a17a5117a6b99b2c0eb6db444bf74492f673adad5129a0d83c2516a71beea

    Fiche complète, enregistrement et provenance

    Instruction pré-écrite par SkillCodex — ta demande n’est ni envoyée ni utilisée pour adapter ce texte ; aucun contenu n’est généré et copier n’exécute rien.

    Digest du Pack: sha256:a5b0f566107346339b47c50e6ed52b869a94ee8a45ad8d0351a282d778a8a32b

    Dans le code

    TechnologiePrimitiveVersionLimite
    Web platform

    nav with ul and a[href]

    NatifUtiliser de vraies destinations dans une région de navigation nommée ; les mises à jour côté client préservent URL, historique, focus et sémantique de page actuelle.

    Détails techniques

    Comportements

    • Changer de page de résultats

      Un lien de page, Précédent ou Suivant charge une autre tranche quantitative de la même collection.

    • Suivre avec l’activation native du lien

      Le pointeur, le toucher ou Entrée suit le lien ; Espace conserve son comportement natif de défilement de page.

    États

    • Page 1

      Page 1

    • Page 2

      Page 2

    • Page 3

      Page 3

    Transitions d’état

    • Page 1 → Page 2

      Activer Suivant charge la page 2.

    • Page 2 → Page 3

      Activer la page 3 charge cette destination directe.

    • Page 3 → Page 2

      Activer Précédent revient à la page 2.

    • Page 2 → Page 1

      Réinitialiser restaure la page 1.

    Scénarios de test

    Contexte
    Un journal d’audit contient trois pages stables d’enregistrements.
    Mission
    Active Suivant, va directement à la page 3 puis reviens avec Précédent en vérifiant l’état de page actuelle.
    État principal
    La page 1 est actuelle et Précédent est indisponible à la première page.
    Cas limite
    Un total final inconnu omet une fausse destination de dernière page et garde Suivant fidèle à la réalité.

    Signaux visuels

    • Précédent et Suivant aux extrémités
    • Destinations numérotées
    • Une page actuelle et des intervalles non interactifs

    Signaux comportementaux

    • Chaque destination est un vrai lien
    • La page actuelle suit la tranche de résultats
    • Les limites et totaux inconnus ne créent pas de contrôles morts

    Accessibilité

    Rôle
    nav[aria-label] > ul > li > a[aria-current=page]
    Nom accessible
    Le contrôle principal ou la région nommée pour Pagination possède un nom accessible stable issu d’un texte visible ou d’un libellé programmatique explicite ; le placeholder et l’infobulle ne servent pas de nom.
    Focus clavier
    La navigation native suit le navigateur ; une mise à jour sur place déplace le focus vers le titre des résultats ou annonce la nouvelle page de façon cohérente.
    Fermeture
    La pagination est une navigation persistante et ne se ferme pas.
    Défilement
    La position actuelle reste visible si possible. Un changement de navigation ou d’étape mène vers un titre pertinent sans saut de défilement inattendu.
    Annonce
    Nommer les destinations numériques Page N, marquer exactement une page actuelle et garder les intervalles non interactifs.
    Clavier
    • Tab et Maj+Tab parcourent les liens disponibles
    • Entrée active la destination focalisée
    • Les ellipses ne reçoivent jamais le focus

    Implémentations

    Ouvrir la matrice HTML, ARIA, Radix et shadcn
    • nav with ul and a[href]

      implementationKind
      custom
      nativeElement
      nav with ul and a[href]
      ariaPattern
      named pagination navigation with aria-current=page
      radixPrimitive
      Non applicable
      shadcnRecipe
      Non applicable
      runtimeDependency
      Non applicable
      packageName
      Non applicable
      exportName
      Non applicable
      exactVersion
      Non applicable
      status
      exception
      sourceId
      source-ui-uswds-pagination
      deprecationStatus
      active
      replacement
      Non applicable
      validFrom
      Non applicable
      validUntil
      Non applicable

      Limite d’équivalence : Utiliser de vraies destinations dans une région de navigation nommée ; les mises à jour côté client préservent URL, historique, focus et sémantique de page actuelle.

      Vérifier la source du binding

    Sources

    • U.S. Web Design System: Pagination
      sourceId
      source-ui-uswds-pagination
      kind
      documentation
      canonicalUrl
      https://designsystem.digital.gov/components/pagination/
      publisher
      U.S. Web Design System
      sourceRevision
      http-etag:W/"616ad61e320cdd16bbf75c0d4cbd23b4"
      consultedAt
      2026-08-10
      license
      Non indiquée
      contentDigest
      sha256:f3dac5b5159ef2307bcfacf7d6bc5538bea9523eac8d24fbf0a770f21610daa5
      status
      verified

      Affirmation couverte : Pagination : parties, API d'état, interactions et limites d'implémentation documentées pour USWDS Pagination.

    • WHATWG HTML: The nav element
      sourceId
      source-ui-html-nav
      kind
      standard
      canonicalUrl
      https://html.spec.whatwg.org/multipage/sections.html#the-nav-element
      publisher
      WHATWG
      sourceRevision
      http-etag:"6a5dd5e8-2c58d"
      consultedAt
      2026-08-10
      license
      Non indiquée
      contentDigest
      sha256:cfd126e3b971918ee24c5244457dba55bbde269c92fb879da1ab97dd6fbb89c6
      status
      verified

      Affirmation couverte : Pagination : sémantique native normative, états, attributs et comportement du navigateur pour nav.

    • WHATWG HTML: The ol element
      sourceId
      source-ui-html-ordered-list
      kind
      standard
      canonicalUrl
      https://html.spec.whatwg.org/multipage/grouping-content.html#the-ol-element
      publisher
      WHATWG
      sourceRevision
      http-etag:"6a5dd5e8-34d05"
      consultedAt
      2026-08-10
      license
      Non indiquée
      contentDigest
      sha256:4e0627672499c1cfdcd9525e54080baafee74ab80e97b8b446737bfe97d146a5
      status
      verified

      Affirmation couverte : Pagination : sémantique native normative, états, attributs et comportement du navigateur pour ol and li.

    • WHATWG HTML: The a element
      sourceId
      source-ui-html-link
      kind
      standard
      canonicalUrl
      https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-a-element
      publisher
      WHATWG
      sourceRevision
      http-last-modified:2026-07-19T13:52:46Z
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:fe0a3d4315ccdf4f171cbb0c61ee6188b0db2dfe13a7c7f1f04f6b37528661f6
      status
      verified

      Affirmation couverte : Pagination : sémantique native normative, états, attributs et comportement du navigateur pour a[href].

    • WCAG 2.2: Focus Appearance
      sourceId
      source-ui-wcag-understanding-focus-appearance
      kind
      documentation
      canonicalUrl
      https://www.w3.org/WAI/WCAG22/Understanding/focus-appearance.html
      publisher
      W3C WAI
      sourceRevision
      http-last-modified:2026-07-02T10:07:49Z
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:fdcf316a1f0e3cc758eda9618322d132862124ff0a3f3b1a3acbf20daf804ff0
      status
      verified

      Affirmation couverte : Pagination : guide WCAG informatif pour évaluer l'apparence visible du focus clavier.