Aller au contenu principal
Version: 26.0.10.0

pagination

Le tag pagination expose les données de pagination dans son corps à partir d'une WP_Query.

Variables disponibles​

VariableTypeDescription
prevarray|nullLien "Précédent" — clés label et link
nextarray|nullLien "Suivant" — clés label et link
linksarrayLiens de pages — chaque entrée a label, link et active

Utilisation​

views/my-template.html.twig
{% pagination query %}
    {% if prev %}
        <a href="{{ prev.link }}">{{ prev.label }}</a>
    {% endif %}

    {% for page in links %}
        <a href="{{ page.link }}" class="{{ page.active ? 'active' : '' }}">
            {{ page.label }}
        </a>
    {% endfor %}

    {% if next %}
        <a href="{{ next.link }}">{{ next.label }}</a>
    {% endif %}
{% endpagination %}

Comportement de la query​

Le tag résout la query dans cet ordre :

  1. Si l'argument est une instance de WP_Query — l'utilise directement
  2. Si l'argument est un tableau non vide — crée une WP_Query à partir du tableau
  3. Si l'argument est null ou vide — utilise la $wp_query globale

Si aucun lien de pagination n'est généré (page unique, pas assez de résultats), le contenu du bloc n'est pas rendu.

astuce

Utilisez ce tag lorsque vous avez besoin de contrôler intégralement le markup (classes CSS personnalisées, composants, accessibilité…). Pour un rendu rapide sans personnalisation, préférez la fonction paginate().