Vue liste — Pagination, tri, recherche et filtres

.list(|l| l.display([Title, Status, Views]))

Sans display, toutes les colonnes non secrètes apparaissent (sauf comptes : username, email, is_active), avec les dates et les heures en dernier. Un display déclaré garde son ordre. La fiche d'une ligne reprend cet ordre, mais y met toujours les dates et les heures à la fin.

L'ordre du tableau est l'ordre d'affichage des en-têtes.

.list(|l| l.display([Title, Status]).links([Title]))

Sans effet pour l'instant : links est accepté et vérifié (ses colonnes doivent être dans display), mais la liste affiche chaque ligne en carte avec son propre lien vers le détail (et son menu), quelles que soient les colonnes déclarées.

Tri par défaut (SQL) :

.list(|l| {
    l.display([Title, CreatedAt])
        .ordering([(CreatedAt, Order::Desc), (Title, Order::Asc)])
})

Tri cliquable depuis l'UI / l'URL — uniquement les colonnes déclarées :

.sortable([Title, Status])

Tout autre ?sort_by= est ignoré.

.list(|l| l.search([Title, Summary]))

Comportement :

• minimum 3 caractères (sinon la recherche est ignorée)
• au-delà de .search_max_len(n) du staging (150 par défaut), le terme est tronqué
• sans .search(...) : les colonnes texte de display sont utilisées
• .search([]) désactive la recherche
• .search_help("…") est accepté mais pas encore affiché

.list(|l| l.filter([Status, Lang]))

Chaque filtre propose les valeurs distinctes présentes dans le périmètre autorisé, page par page. L'URL utilise le préfixe filter_ :

?filter_status=Published&filter_status=Draft&filter_lang=fr

Plusieurs valeurs d'une colonne s'additionnent (Published ou Draft), plusieurs colonnes se cumulent (et). Cliquer sur une valeur l'active ; cliquer de nouveau la retire, les autres restent. Une colonne accepte au plus 100 valeurs depuis l'URL.

Chaque groupe du panneau a ses flèches, et un seul sélecteur, sous le titre du panneau, règle le nombre de valeurs de tous les groupes :

// site
admin.filter_size(8)

// modèle
.list(|l| l.filter([PageId]).filter_size(15))

Le choix fait dans le sélecteur (10, 25, 50 ou 100) l'emporte sur ces réglages.

.list(|l| {
    l.display([Title, Status])
        .action(Status, "Published", "Publier")
        .action(Status, "Archived", "Archiver")
})

L'UI envoie l'index de l'action (a0, a1…), jamais la valeur brute. La valeur est fixée dans le code.

Contraintes (validées au boot) :

• colonne writable à l'édition
• pas de secret, pas d'owner, pas de drapeaux de rang comptes

// site
admin.page_size(15)

// modèle
.list(|l| l.per_page(30))

Le sélecteur de la liste (10, 25, 50 ou 100) l'emporte sur ces réglages. L'URL ne peut pas demander une autre taille.

Exemple :

/admin/blog/list?page=2&sort_by=title&sort_dir=asc&search=runique&filter_status=Published

.list(|l| l.empty_value("—"))

Sans effet pour l'instant : accepté, mais la liste n'utilise pas encore ce texte.