Vue liste — Pagination, tri, recherche et filtres

Par défaut, toutes les colonnes de l'entité sont affichées. Déclarer list_display restreint l'affichage à une sélection ordonnée :

admin! {
    users: users::Model => RegisterForm {
        title: "Utilisateurs",
        permissions: ["admin"],
        list_display: [
            ["username", "Nom d'utilisateur"],
            ["email", "Email"],
            ["is_active", "Actif"],
        ]
    }
}

Chaque entrée est une paire ["nom_colonne", "Libellé"]. Les colonnes déclarées dans list_display servent aussi de whitelist pour le tri : seules ces colonnes (et id) acceptent un sort_by.

Disponible dans le contexte Tera via visible_columns (liste des noms) et column_labels (libellés).

Déclarer list_filter active une barre latérale avec les valeurs distinctes de chaque champ :

admin! {
    users: users::Model => RegisterForm {
        title: "Utilisateurs",
        permissions: ["admin"],
        list_filter: [
            ["is_active", "Actif"],                     // défaut : 10 valeurs par page
            ["is_superuser", "Superuser"],              // défaut : 10 valeurs par page
            ["username", "Nom d'utilisateur", 5],       // limite explicite : 5 valeurs par page
        ]
    }
}

• Pour chaque colonne, le daemon génère une requête SQL qui charge les valeurs distinctes avec LIMIT / OFFSET.
• La pagination de la sidebar (‹ 1/N ›) est entièrement serveur via le paramètre fp_{colonne} dans l'URL — aucun JavaScript requis.
• La limite par page est configurée par colonne via le 3ème élément optionnel (défaut : 10).
• Les valeurs sont affichées telles quelles (CAST(colonne AS TEXT)). Ne pas utiliser list_filter sur des clés étrangères (FK) ou des colonnes id — la valeur brute (35, 128…) n'est pas lisible. Utiliser la barre de recherche à la place.
• Bons candidats : booléens, énumérations, codes courts (lang, status, block_type).
• Cliquer sur une valeur applique un filtre WHERE colonne = valeur à la requête SQL.
• Plusieurs filtres sur des colonnes différentes se cumulent (AND).

Chaque en-tête de colonne est cliquable. L'URL résultante :

/admin/users/list?sort_by=email&sort_dir=asc&page=1

• sort_by : nom de la colonne (doit être dans list_display ou être id)
• sort_dir : asc ou desc
• Changer le tri remet automatiquement à la page 1

La direction actuelle est indiquée par ▲ / ▼ dans l'en-tête. Cliquer une seconde fois sur la même colonne inverse le sens.

La barre de recherche filtre les enregistrements sur toutes les colonnes texte visibles (ILIKE '%terme%'). Elle préserve les paramètres de tri actifs.

/admin/users/list?search=alice&sort_by=email&sort_dir=asc

Le compteur d'entrées reflète le résultat filtré.

La pagination est calculée côté SQL (LIMIT / OFFSET). La taille de page est configurée au niveau de l'application :

.with_admin(|a| {
    a.site_title("Administration")
     .auth(RuniqueAdminAuth::new())
     .page_size(15)   // ← entrées par page
})

Les filtres et la recherche actifs sont préservés dans les liens de pagination.