Pagination
<gcds-pagination>

Autres noms : index de pages, navigation de pages.

La pagination est une division du contenu entre plusieurs pages liées.

• GitHub
• Figma

Créer un composant de pagination

Utilisez la pagination pour séparer le contenu et le répartir sur plusieurs pages. Cela peut faciliter la lecture de sections de contenu importantes et permettre à une personne de se repérer dans les documents.

Codage et accessibilité pour le composant pagination

Configurez la pagination simple

Utilisez la pagination simple lorsque le nombre de pages est peu important.

• Réglez l’attribut display sur simple.
• Définissez l’URL de la page précédente à l’aide de l’attribut previous-href.
• Définissez le libellé de la page précédente à l’aide de l’attribut previous-label.
• Définissez l’URL de la page suivante à l’aide de l’attribut next-href.
• Définissez le libellé de la page suivante à l’aide de l’attribut next-label.

Configurez la pagination sous forme de liste

Utilisez la pagination sous forme de liste si votre contenu est étendu sur un plus grand nombre de pages.

• Réglez l’attribut display sur list.
• Définissez le nombre total de pages pour votre séquence à l’aide de l’attribut total-pages en utilisant un nombre.
• Définissez la page actuelle ou active à l’aide de l’attribut current-page en utilisant un nombre.
• Choisissez d’utiliser l’attribut url pour fournir au composant un groupe de liens de pages. Il peut s’agir d’un objet si vous travaillez dans un environnement JS ou d’une chaîne si vous utilisez HTML.

Appliquez l’objet de l’URL pour la pagination sous forme de liste.

Utilisez l’objet url pour générer les chaînes de requête et les fragments pour les liens de la pagination sous forme de liste.

url = {
  queryStrings: {
    // Key value pairs
    key: value,
  },
  fragment: string, // Target id
};

Pour modifier la valeur en fonction du lien de page visualisé, ajoutez les modificateurs ::offset ou ::match à une clé dans l’objet queryStrings.

::offset entame le décompte depuis la valeur donnée en commençant par le lien de la deuxième page.

url = {
  queryStrings: {
    'index::offset': 100,
  },
};

Utilisez ::match pour le lien de page actuellement visualisée afin de multiplier ce dernier par la valeur fournie.

url = {
  queryStrings: {
    'page::match': 1,
  },
};

Utilisez ::offset ou ::match pour permettre l’injection d’un nombre dans une chaîne. Utilisez {{#}} pour que l’élément modificateur injecte le nombre modifié en fonction de la méthode de comptage dans la chaîne au moment de la visualisation.

url = {
  queryStrings: {
    'index::offset': 'index_{{100}}',
    'page::match': 'page_{{1}}',
  },
};

Obtenez votre code

Générez une version du composant dont vous avez besoin en sélectionnant les propriétés de code correspondantes ou explorez les possibilités en choisissant différentes valeurs de code.

1. Choisissez des valeurs de code pour obtenir l'élément que vous voulez.

2. Obtenez le code et intégrez-le dans votre environnement.

3. Ajoutez tout contenu nécessaire au composant (comme le texte du libellé).

Remarque : Conformément à la pratique courante, le générateur de code utilise l'anglais pour tous les éléments de code.