Aller au contenu

v1.0.3

fr

Sur cette page

Vue d'ensemble
Exemple
Paramètres
Événements
Paquet
Contrôles associés

DataGrid

Complete

Tableau avec tri (clic sur un en-tête : croissant, décroissant, désactivé), filtres par colonne, pagination, sélection de lignes et modèles.

Exemple

Contrôle DataGrid

Paramètres

DataGrid

Paramètre	Type	Description
`Adaptive`	`bool`	Affiche chaque ligne sous forme de carte sur les écrans étroits.
`AllowAdd`	`bool`	Affiche un bouton Add qui crée un nouvel élément (voir NewItemFactory).
`AllowCardView`	`bool`	Ajoute à la barre d'outils un bouton qui bascule entre le tableau et l'affichage en cartes.
`AllowDelete`	`bool`	Affiche la commande Delete dans la colonne des commandes (demande confirmation).
`AllowEdit`	`bool`	Affiche la commande Edit dans la colonne des commandes.
`AllowPaste`	`bool`	Mode par lot : ajoute un bouton Paste qui remplit les cellules modifiables à partir d'un texte du presse-papiers séparé par des tabulations.
`AllowView`	`bool`	Ajoute une commande View qui affiche la ligne en lecture seule dans une boîte de dialogue.
`CardView`	`bool`	Affiche chaque ligne sous forme de carte au lieu d'une ligne de tableau. À utiliser avec @bind-CardView.
`CellNavigation`	`bool`	Fait de la grille une grille au clavier : les flèches, Origine, Fin, Page précédente et Page suivante se déplacent entre les cellules ; Entrée, F2 ou Espace activent le contrôle de la cellule.
`Class`	`string`	Classes CSS supplémentaires ajoutées à l'élément racine.
`ColumnMenu`	`bool`	Ajoute à chaque en-tête un bouton de menu avec des commandes de tri et de masquage de colonne.
`Columns`	`RenderFragment`	Définitions de colonnes : éléments DataGridColumn.
`DataProvider`	`Func<DataGridRequest, ValueTask<DataGridResult<TItem>>>`	Charge des lignes de votre côté : reçoit le début, le nombre, le tri, les filtres, la recherche, les groupes et les agrégats ainsi qu'un jeton d'annulation (annulé quand une requête plus récente démarre ou que la grille est retirée), et renvoie un DataGridResult.
`Dense`	`bool`	Utilise un remplissage de cellule plus serré.
`DetailTemplate`	`RenderFragment<TItem>`	Contenu affiché sous une ligne quand son bouton de développement est actionné.
`EditMode`	`DataGridEditMode`	None, Row (en ligne), Dialog ou Batch (toutes les lignes d'un coup).
`EmptyContent`	`RenderFragment`	Affiché quand il n'y a aucune ligne.
`ExportChoices`	`bool`	Transforme Export en menu : CSV ou JSON, vue actuelle, lignes sélectionnées, toutes les lignes, colonnes masquées.
`ExportFileName`	`string`	Nom du fichier de l'export CSV, sans extension.
`FilterOperators`	`bool`	Ajoute au-dessus de chaque zone de filtre une liste d'opérateurs (contient, commence par, égale, supérieur à, est vide...).
`FormatRules`	`IEnumerable<DataGridFormatRule>`	Règles qui colorent des cellules ou des lignes : champ, opérateur de filtre, valeur, gravité et Cell ou Row. La première règle qui correspond l'emporte.
`FreezeFirstColumn`	`bool`	Maintient la première colonne visible pendant le défilement latéral.
`FrozenColumns`	`int`	Nombre de colonnes de tête qui restent visibles pendant que le reste défile latéralement.
`FrozenEndColumns`	`int`	Nombre de colonnes au bord droit qui restent visibles pendant le défilement latéral du tableau.
`FrozenRows`	`int`	Nombre de lignes qui restent sous l'en-tête pendant que le corps défile (nécessite Height).
`GroupBy`	`Func<TItem, Object>`	Groupe les lignes selon la valeur renvoyée ; chaque groupe a un en-tête repliable.
`GroupPanel`	`bool`	Ajoute au-dessus du tableau une bande où les utilisateurs regroupent les lignes en glissant des en-têtes ou en choisissant des colonnes.
`GroupSummary`	`bool`	Affiche les agrégats des colonnes dans les lignes de groupe (calculés localement, ou repris de DataGridResult.Groups avec un DataProvider).
`GroupTitle`	`string`	Texte avant la valeur du groupe dans l'en-tête.
`Height`	`string`	Hauteur maximale du corps de la grille, par exemple 24rem (28rem par défaut avec VirtualScroll).
`ItemKey`	`Func<TItem, Object>`	Renvoie une clé stable par élément, afin que la sélection et les détails ouverts survivent aux rechargements.
`Items`	`IEnumerable<TItem>`	Les options à choisir.
`KeyboardShortcuts`	`bool`	Ctrl+A tout sélectionner, Ctrl+C copier les lignes sélectionnées, Échap effacer la sélection, Alt+flèches changer de page.
`Label`	`string`	Texte d'étiquette visible (graphiques : nom accessible ; IconButton : nom accessible et info-bulle).
`Loading`	`bool`	Affiche une barre de progression au-dessus des lignes.
`LoadingSkeleton`	`bool`	Affiche des lignes indicatives pendant le premier chargement.
`LoadMore`	`bool`	Remplace la pagination par un bouton Load more qui ajoute la page suivante.
`MultiSort`	`bool`	Maj+clic sur les en-têtes trie selon plusieurs colonnes ; les en-têtes montrent l'ordre.
`NewItemFactory`	`Func<TItem>`	Crée l'élément d'une nouvelle ligne ; par défaut le constructeur sans paramètre.
`NoMatchContent`	`RenderFragment`	Contenu affiché quand les filtres ou la recherche ne laissent aucune ligne (par défaut : un texte avec Clear filters).
`PageSize`	`int`	Lignes par page.
`PageSizeOptions`	`IEnumerable<int>`	Nombres de lignes proposés dans une liste déroulante sous le tableau.
`Paging`	`bool`	Affiche la barre de pagination (true par défaut).
`PastePreview`	`bool`	Mode par lot : montre ce qu'un collage va modifier et demande avant de l'appliquer (activé par défaut).
`PersistKey`	`string`	Mémorise la position et la taille (Window), la division (Splitter) ou la disposition d'un DataGrid (tri, filtres, colonnes, largeurs, page) dans le stockage local sous ce nom et les restaure la fois suivante.
`Reorderable`	`bool`	Permet aux utilisateurs de déplacer des colonnes en glissant les en-têtes ou avec le menu Columns.
`Resizable`	`bool`	Ajoute une poignée de glissement (et des flèches) pour redimensionner chaque colonne.
`RowClass`	`Func<TItem, string>`	Renvoie une classe CSS supplémentaire pour une ligne.
`RowHeight`	`int`	Hauteur de ligne en pixels quand VirtualScroll est activé (44 par défaut).
`RowMenu`	`Func<TItem, IEnumerable<MenuCommand>>`	Renvoie les commandes du menu contextuel d'une ligne.
`RowReorder`	`bool`	Permet de glisser des lignes les unes sur les autres ; gérez RowMoved pour modifier votre liste.
`RowSeverity`	`Func<TItem, Severity?>`	Renvoie une gravité pour teinter une ligne, ou null.
`RowValidator`	`Func<TItem, IEnumerable<string>>`	Vérifie toute la ligne après l'application de la modification ; renvoie des textes d'erreur.
`SelectedItems`	`IEnumerable<TItem>`	Lignes sélectionnées. À utiliser avec @bind-SelectedItems.
`Selection`	`SelectionMode`	None (par défaut), Single ou Multiple.
`SelectionActions`	`RenderFragment<IReadOnlyList<TItem>>`	Boutons dans la barre de sélection ; reçoit les éléments sélectionnés.
`ServerBulkLimit`	`int`	Avec DataProvider : le plus grand nombre de lignes que la grille demande en une requête pour sélectionner toutes les lignes filtrées ou les exporter (10000 par défaut). Au-delà, seules les lignes de la page sont utilisées.
`ShowCopy`	`bool`	Affiche le bouton de copie.
`ShowFilters`	`bool`	Affiche une zone de filtre sous l'en-tête de chaque colonne filtrable.
`ShowPrint`	`bool`	Ajoute un bouton Print qui imprime le tableau.
`ShowSearch`	`bool`	Ajoute une zone de recherche qui trouve du texte dans toutes les colonnes et le met en évidence dans les cellules.
`ShowSelectionBar`	`bool`	Affiche la barre avec le nombre de lignes sélectionnées, sélectionner toutes les lignes et effacer la sélection (sélection Multiple).
`ShowToolbar`	`bool`	Affiche la barre d'outils avec le sélecteur de colonnes et l'export CSV.
`Striped`	`bool`	Ombre une ligne sur deux.
`Style`	`string`	Style en ligne ajouté à l'élément racine.
`ToolbarContent`	`RenderFragment`	Contenu supplémentaire dans la barre d'outils d'une grille avec ShowToolbar, par exemple DataGridSpreadsheetButton.
`TypedFilters`	`bool`	Utilise des zones de filtre pour nombre, date et oui/non selon le type des valeurs de la colonne (activé par défaut).
`UndoRedo`	`bool`	Ajoute Annuler et Rétablir pour les modifications de lignes enregistrées, les lignes ajoutées et supprimées (boutons et Ctrl+Z / Ctrl+Y).
`ValueFilters`	`bool`	Ajoute à chaque en-tête filtrable un filtre par liste de valeurs (recherche, tout sélectionner, effacer) ; fonctionne sur les éléments en mémoire.
`VirtualScroll`	`bool`	Ne dessine que les lignes visibles (les lignes doivent avoir la RowHeight fixe).

DataGridColumn

Paramètre	Type	Description
`Aggregate`	`DataGridAggregate`	Ajoute une valeur à la ligne de synthèse : Sum, Average, Min, Max ou Count.
`Align`	`TextAlign`	Left (par défaut), Center ou Right.
`BadgeSeverities`	`IReadOnlyDictionary<string, Severity>`	Couleur d'une colonne Badge par valeur.
`CellSeverity`	`Func<TItem, Severity?>`	Renvoie une gravité pour teinter une cellule, ou null.
`ColumnSpan`	`Func<TItem, int>`	Renvoie le nombre de colonnes couvertes par la cellule d'un élément.
`DataBar`	`bool`	Dessine une barre derrière les nombres relativement à la plus grande valeur de la colonne.
`Editable`	`bool`	Permet aux utilisateurs de modifier les cellules de la colonne en cliquant dessus.
`EditOn`	`DataGridEditOn`	Always, Create (nouvelles lignes seulement) ou Update (lignes existantes seulement).
`EditorOptions`	`IEnumerable<KeyValuePair<string, string>>`	Paires valeur et étiquette ; l'éditeur devient une liste.
`Field`	`string`	Nom de propriété de l'élément (les noms imbriqués comme Address.City fonctionnent). Il lit la cellule, trie et filtre quand Value n'est pas défini, et il est envoyé à DataProvider comme identifiant de colonne (Title par défaut).
`Filterable`	`bool`	Affiche une zone de filtre pour cette colonne (true par défaut).
`Format`	`string`	Chaîne de format pour les nombres et les dates, p. ex. N0 ou d.
`Group`	`string`	Texte de l'en-tête empilé au-dessus de cette colonne ; les voisines avec le même texte partagent une cellule.
`HelpText`	`string`	Une indication affichée sous le champ dans la boîte de dialogue de modification.
`Hidden`	`bool`	Masque d'abord la colonne ; les utilisateurs peuvent l'afficher depuis la barre d'outils.
`ImageAlt`	`Func<TItem, string>`	Texte alternatif d'une colonne Image par ligne.
`ImageHeight`	`int`	Hauteur de l'image en pixels (32 par défaut).
`LinkHref`	`Func<TItem, string>`	Adresse d'une colonne Link par ligne (par défaut : la valeur).
`LinkTarget`	`string`	Cible du lien, par exemple _blank.
`Max`	`Double?`	Plus grande valeur autorisée (ProgressBar : la valeur qui signifie 100 % ; Rating : nombre d'étoiles).
`MaxLength`	`int?`	Plus grand nombre de caractères autorisé.
`MaxWidth`	`string`	Container : largeur maximale fixe à partir d'un point de rupture (Xs à Xxl). DataGridColumn : largeur maximale en longueur CSS ; la poignée de redimensionnement s'y arrête.
`MergeRows`	`bool`	Fusionne verticalement les cellules voisines qui ont le même texte.
`Min`	`Double?`	Plus petite valeur autorisée.
`MinLength`	`int?`	Plus petit nombre de caractères accepté lors de l'enregistrement d'une modification.
`Pattern`	`string`	Expression régulière que le texte modifié doit respecter.
`PatternMessage`	`string`	Texte d'erreur affiché quand Pattern ne correspond pas.
`ProgressMax`	`Double`	Valeur qui remplit une colonne Progress (100 par défaut).
`Required`	`bool`	L'éditeur refuse une valeur vide.
`Sortable`	`bool`	Autorise le tri par cette colonne (true par défaut).
`Template`	`RenderFragment<TItem>`	Contenu personnalisé de la cellule. La ligne est disponible comme contexte.
`Title`	`string`	Texte du titre (en-tête de tiroir, légende d'onglet, en-tête de colonne, légende d'étape).
`Type`	`DataGridColumnType`	Comment la cellule est dessinée : Text, Check, Image, Progress, Link, Badge ou Dropdown.
`Validate`	`Func<TItem, Object, string>`	Étape de Stepper : s'exécute avant de passer à la suivante, renvoyez false pour rester sur l'étape. Colonne de DataGrid : reçoit l'élément et la valeur analysée et renvoie un texte d'erreur ou null.
`Value`	`Func<TItem, Object>`	Renvoie la valeur de la cellule. Utilisée pour l'affichage, le tri et le filtrage.
`Width`	`string`	Skeleton : toute longueur CSS. Charts : largeur du dessin en unités SVG (le graphique s'adapte toujours à son conteneur).

Événements

DataGrid

Événement	Type	Description
`CardViewChanged`	`EventCallback<bool>`	Déclenché quand l'utilisateur bascule entre le tableau et les cartes.
`OnLoadError`	`EventCallback<Exception>`	Déclenché avec l'exception quand DataProvider échoue ; la grille n'affiche alors aucune ligne. Sans gestionnaire, l'erreur va à la limite d'erreur.
`OnRowDeleting`	`EventCallback<DataGridRowChange<TItem>>`	S'exécute après la confirmation ; définissez Error sur l'argument pour annuler la suppression.
`OnRowSaving`	`EventCallback<DataGridRowChange<TItem>>`	S'exécute avant qu'une ligne soit conservée ; définissez Error sur l'argument pour annuler et afficher le texte.
`PageSizeChanged`	`EventCallback<int>`	Déclenché quand une autre taille de page est choisie.
`RowAdded`	`EventCallback<TItem>`	Déclenché avec le nouvel élément après son enregistrement ; ajoutez-le à votre liste.
`RowDeleted`	`EventCallback<TItem>`	Déclenché avec l'élément après la confirmation de la suppression ; retirez-le de votre liste.
`RowMoved`	`EventCallback<DataGridRowMove<TItem>>`	Déclenché quand une ligne est déposée sur une autre : l'élément, les index de page (FromIndex, ToIndex), les index dans toute la liste triée et filtrée (AbsoluteFromIndex, AbsoluteToIndex ; PageOffset est la différence) et l'élément sur lequel elle a été déposée (TargetItem).
`RowSaved`	`EventCallback<TItem>`	Déclenché avec l'élément après l'application d'une modification valide.
`RowsPasted`	`EventCallback<int>`	Déclenché avec le nombre de lignes remplies par Paste.
`SelectedItemsChanged`	`EventCallback<IEnumerable<TItem>>`	Déclenché quand la sélection change.
`StateChanged`	`EventCallback<DataGridState>`	Signale le DataGridState après chaque changement de tri, de filtres, de colonnes, de largeurs ou de page.

DataGridColumn

Événement	Type	Description
`Edited`	`EventCallback<DataGridEdit<TItem>>`	Déclenché avec l'élément et le nouveau texte quand une modification est confirmée.

Paquet

DataGrid fait partie de RayCraft Complete. Paquet : RayCraft.Blazor.Complete. Il provient du flux privé RayCraft et nécessite une licence active. Voir Premiers pas.

DataGridPdfButtonUn bouton qui exporte le DataGrid connecté vers un fichier PDF.

Envoyer un retourVersion 1.0.3