Formations — 1 037 leçons en français

Accueil › Fullstack Angular + Spring Boot › Pagination et tri de bout en bout

Pagination et tri de bout en bout

Listes, pagination et fichiersintermediaire

Spring alimente seul un Pageable à partir des paramètres page, size et sort :

@GetMapping("/api/produits")
public PagedModel<ProduitDto> lister(
        @RequestParam(required = false) String recherche,
        @PageableDefault(size = 20, sort = "nom") Pageable pageable) {

    Page<ProduitDto> page = service.rechercher(recherche, pageable);
    return new PagedModel<>(page);   // JSON stable
}

GET /api/produits?page=1&size=20&sort=prix,desc produit :

{
  "content": [ { "id": 12, "nom": "Clavier", "prix": 49.90 } ],
  "page": { "size": 20, "number": 1, "totalElements": 137, "totalPages": 7 }
}

Côté front, le type suit cette structure, et les signaux rendent la pagination naturelle :

export interface PageReponse<T> {
  content: T[];
  page: { size: number; number: number; totalElements: number; totalPages: number };
}

export class ProduitsComponent {
  private service = inject(ProduitService);

  protected numeroPage = signal(0);
  protected taille = signal(20);
  protected tri = signal<'nom,asc' | 'prix,asc' | 'prix,desc'>('nom,asc');

  // relance l'appel dès qu'un des signaux change
  protected resultat = httpResource<PageReponse<Produit>>(() =>
    `/api/produits?page=${this.numeroPage()}&size=${this.taille()}&sort=${this.tri()}`,
  );
}

httpResource() est marquée expérimentale en Angular 21 (stabilisation annoncée en Angular 22). L'équivalent sur API stables, avec HttpClient + toSignal, figure dans l'exemple 2.

Les termes à connaître

Pageable

Interface Spring Data qui porte la page demandée, sa taille et le tri. Déclarée en paramètre d'une méthode de contrôleur, elle est alimentée automatiquement depuis les paramètres de requête page, size et sort.

Page<T>

Résultat paginé de Spring Data : le contenu de la page plus les métadonnées (totalElements, totalPages, number, size). Il exécute deux requêtes SQL : une pour les données, une pour le total.

PagedModel

Enveloppe de sérialisation fournie par Spring Data (org.springframework.data.web.PagedModel) qui donne un JSON stable : { "content": [...], "page": { "size", "number", "totalElements", "totalPages" } }. Elle évite de laisser fuiter la forme interne de PageImpl.

Pagination par curseur

Alternative où le client renvoie un repère issu du dernier élément reçu (?apres=2026-11-06T10:00:00Z) au lieu d'un numéro de page. Elle reste stable quand des éléments sont insérés pendant la navigation, et évite le coût du OFFSET sur de gros volumes, mais interdit le saut direct à la page 40.

Slice<T>

Variante de Page qui ne compte pas le total : elle sait seulement s'il existe une page suivante. Une requête SQL au lieu de deux, ce qui est appréciable sur une grosse table où le count(*) est coûteux.

Tri sur un champ inexistant

Un ?sort=nomDuClient qui ne correspond à aucune propriété de l'entité provoque une erreur côté serveur. Le front ne doit donc proposer que des champs triables connus, validés côté back.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.