Skip to Content
Documentation
Vues

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.

Agrandir ↗

Données de démonstration. Les modifications restent dans cet aperçu.

Agrandir ↗

Données de démonstration. Les modifications restent dans cet aperçu.

Configuration

Ajoutez "list" à displayModes et décrivez la ligne avec table.list. La configuration est identique en React et en Vue.

list-config.ts
export const listConfig = defineTableConfig({
  ...productConfig,
  table: {
    ...productConfig.table,
    displayModes: ["table", "list", "kanban"],
    list: {
      titleColumn: "name",
      cardColumnIds: ["status", "price"],
      showCardLabels: false,
    },
  },
});
OptionPar défautDescription
titleColumnPremière colonne de donnéesColonne affichée comme titre de la ligne.
cardColumnIdsToutes les autres colonnes de donnéesPropriétés affichées après le titre, dans cet ordre.
showCardLabelsfalseAffiche le nom de la colonne avant chaque valeur.
wrapfalseLe titre passe à la ligne au lieu d’être tronqué.
showActionstrueAffiche le menu des actions de ligne en fin de ligne.
propertyAlign"end""start" place les propriétés juste après le titre.
maxPropertiesToutesNombre maximal de propriétés affichées.
mobileMaxPropertiesToutesNombre 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.