Liste
Parcourir les enregistrements en lignes compactes, avec un titre et quelques propriétés.
La liste affiche une ligne par enregistrement : la case de sélection, un titre, les propriétés choisies et les actions de ligne. Elle utilise les mêmes enregistrements, la même requête, la même sélection et les mêmes actions que le tableau, et ouvrir une ligne équivaut à cliquer sur une ligne du tableau.
Essayer la liste
Choisissez React ou Vue : chaque onglet exécute son framework. Chaque ligne affiche le nom du projet, puis son statut, sa catégorie, son budget et sa date de début. Ouvrez Paramètres de la vue › Réglages des propriétés affichées pour changer le titre et les propriétés, afficher les libellés ou renvoyer les titres à la ligne, ou passez le Mode d’affichage sur Table pour comparer. Sous 768 px, mobileMaxProperties garde deux propriétés. L’aperçu utilise les projets d’ouverture de magasins communs à tous les guides de vues ; voir les données des exemples pour project-config.ts et l’hôte en mémoire.
Données de démonstration. Les modifications restent dans cet aperçu.
import { defineTableConfig } from "@/components/ui/yayaw-table";
import { projectConfig } from "./project-config";
export const exampleConfig = defineTableConfig({
...projectConfig,
table: {
...projectConfig.table,
displayModes: ["list", "table"],
defaultDisplayMode: "list",
list: {
titleColumn: "name",
cardColumnIds: ["status", "category", "budget", "start"],
showCardLabels: false,
mobileMaxProperties: 2,
},
},
});Données de démonstration. Les modifications restent dans cet aperçu.
import { defineTableConfig } from "@/components/ui/yayaw-table-vue";
import { projectConfig } from "./project-config";
export const exampleConfig = defineTableConfig({
...projectConfig,
table: {
...projectConfig.table,
displayModes: ["list", "table"],
defaultDisplayMode: "list",
list: {
titleColumn: "name",
cardColumnIds: ["status", "category", "budget", "start"],
showCardLabels: false,
mobileMaxProperties: 2,
},
},
});Configuration
Ajoutez "list" à displayModes et décrivez la ligne avec table.list. La configuration est identique en React et en Vue.
export const listConfig = defineTableConfig({
...productConfig,
table: {
...productConfig.table,
displayModes: ["table", "list", "kanban"],
list: {
titleColumn: "name",
cardColumnIds: ["status", "price"],
showCardLabels: false,
},
},
});| Option | Par défaut | Description |
|---|---|---|
titleColumn | Première colonne de données | Colonne affichée comme titre de la ligne. |
cardColumnIds | Toutes les autres colonnes de données | Propriétés affichées après le titre, dans cet ordre. |
showCardLabels | false | Affiche le nom de la colonne avant chaque valeur. |
wrap | false | Le titre passe à la ligne au lieu d’être tronqué. |
showActions | true | Affiche le menu des actions de ligne en fin de ligne. |
propertyAlign | "end" | "start" place les propriétés juste après le titre. |
maxProperties | Toutes | Nombre maximal de propriétés affichées. |
mobileMaxProperties | Toutes | Nombre maximal sous 768 px ; la limite la plus basse l’emporte. |
Le titre reste prioritaire sur les lignes étroites : il garde sa largeur naturelle et n’est tronqué qu’en dernier, tandis que les propriétés alignées à la fin rétrécissent d’abord et ne prennent jamais plus de 60 % de la ligne ; une longue adresse e-mail ne réduit donc plus le titre à quelques lettres. Les propriétés alignées au début suivent le titre.
Réglages des lignes
Ouvrez Vue → Réglages des propriétés affichées pour choisir le titre et les propriétés visibles, afficher les libellés, laisser le titre passer à la ligne, placer les propriétés, les limiter (y compris séparément sur mobile) ou masquer les actions de ligne. Les choix sont enregistrés avec les vues et dans la clé d’URL <tableId>-list ; Réinitialiser revient à table.list.
Regroupement
La liste suit le premier niveau de regroupement du tableau. Chaque section est intitulée « Colonne : valeur » avec son nombre d’enregistrements, les enregistrements sans valeur apparaissent sous « No value », et la colonne regroupée est retirée des propriétés. Comme la galerie et le Kanban, la liste affiche la page courante.
Réordonner les lignes
Quand la vue est triée par Ordre manuel (voir le tri), faites glisser une ligne par sa poignée ⋮⋮ à la souris, au doigt ou au stylet, ou sélectionnez-la au clavier et appuyez sur Alt+↑ / Alt+↓. Les lignes se déplacent à l’intérieur de leur groupe. La nouvelle position s’affiche aussitôt et est enregistrée via actions.reorder ; en cas d’échec, l’erreur s’affiche et l’ordre du serveur revient.
Densité
La liste suit la densité du tableau (Vue → Densité, de 2XS à 2XL) : les lignes reprennent les hauteurs, marges et tailles de texte des lignes du tableau, les propriétés restent 2px plus petites (jamais sous 10px), et le choix est enregistré avec la vue.
Avatars
list.avatar (true, ou { nameColumn, imageColumn, shape }) affiche un avatar avant le titre de chaque ligne : l’image de imageColumn quand elle se charge, sinon jusqu’à deux initiales sur une couleur stable tirée de nameColumn (par défaut, le titre). À côté du titre, il est décoratif, et il est enregistré avec les réglages des lignes de la vue.