pagination

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

Variables disponibles

Variable	Type	Description
prev	array|null	Lien "Précédent" — clés label et link
next	array|null	Lien "Suivant" — clés label et link
links	array	Liens 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().