README

Un bundle Symfony pour gérer facilement la pagination dans vos composants Twig.

Fonctionnalités

Pagination simple et intuitive
Support de la pagination "Voir plus"
Intégration avec UX Filters
Personnalisation complète des templates et styles
Support du tri des éléments
Compatible avec les composants Live

Installation

composer require akyos/ux-pagination

Configuration

Le bundle ne nécessite pas de configuration supplémentaire. Il utilise les valeurs par défaut suivantes :

Limite par page : 24 éléments
Type de pagination : classique
Tri par défaut : createdAt en ordre décroissant

Utilisation

Dans un Composant

<?php

namespace App\Twig\Components\Product;

use Akyos\UXPagination\Trait\ComponentWithPaginationTrait;
use App\Entity\Product;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\UX\LiveComponent\Attribute\AsLiveComponent;

#[AsLiveComponent]
final class Index extends AbstractController
{
    use ComponentWithPaginationTrait;

    public function __construct()
    {
        $this->repository = Product::class;
        $this->setLimit(24);
    }
}

Dans le Template

<div{{ attributes }}>
    {# Liste des éléments paginés #}
    {% for product in elements %}
        <div class="product">
            <h3>{{ product.name }}</h3>
            <p>{{ product.description|raw }}</p>
        </div>
    {% endfor %}

    {# Affichage de la pagination #}
    {{ pagination|raw }}
</div>

Documentation

La documentation complète est disponible dans le dossier docs/ :

Personnalisation

Le bundle offre plusieurs options de personnalisation :

Surcharge des templates
Personnalisation des styles CSS
Configuration des classes CSS
Personnalisation des messages
Configuration du tri et de la limite

Intégration avec UX Filters

Le bundle s'intègre parfaitement avec UX Filters pour une expérience de filtrage et de pagination fluide.

Licence

Ce bundle est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

akyos / ux-pagination

Maintainers

Details