Zum Inhalt springen

v1.0.3

de

Auf dieser Seite

Übersicht
Beispiel
Parameter
Ereignisse
Paket
Verwandte Steuerelemente

DataGrid

Complete

Tabelle mit Sortierung (Klick auf eine Kopfzelle: aufsteigend, absteigend, aus), Filtern pro Spalte, Seitenwechsel, Zeilenauswahl und Vorlagen.

Beispiel

Steuerelement DataGrid

Parameter

DataGrid

Parameter	Typ	Beschreibung
`Adaptive`	`bool`	Zeigt jede Zeile auf schmalen Bildschirmen als Karte.
`AllowAdd`	`bool`	Zeigt eine Schaltfläche Add, die ein neues Element erstellt (siehe NewItemFactory).
`AllowCardView`	`bool`	Fügt der Symbolleiste eine Schaltfläche hinzu, die zwischen Tabelle und Kartenansicht umschaltet.
`AllowDelete`	`bool`	Zeigt den Befehl Delete in der Befehlsspalte (fragt nach Bestätigung).
`AllowEdit`	`bool`	Zeigt den Befehl Edit in der Befehlsspalte.
`AllowPaste`	`bool`	Stapelmodus: Fügt eine Schaltfläche Paste hinzu, die bearbeitbare Zellen aus durch Tabulatoren getrenntem Text der Zwischenablage füllt.
`AllowView`	`bool`	Fügt einen Befehl View hinzu, der die Zeile schreibgeschützt in einem Dialogfeld zeigt.
`CardView`	`bool`	Zeigt jede Zeile als Karte statt als Tabellenzeile. Verwenden Sie es mit @bind-CardView.
`CellNavigation`	`bool`	Macht das Raster zu einem Tastaturraster: Pfeiltasten, Pos1, Ende, Bild auf und Bild ab bewegen zwischen Zellen; Eingabe, F2 oder Leertaste aktivieren das Steuerelement in der Zelle.
`Class`	`string`	Zusätzliche CSS-Klassen, die dem Wurzelelement hinzugefügt werden.
`ColumnMenu`	`bool`	Fügt jeder Kopfzelle eine Menüschaltfläche mit Befehlen zum Sortieren und Ausblenden der Spalte hinzu.
`Columns`	`RenderFragment`	Spaltendefinitionen: DataGridColumn-Elemente.
`DataProvider`	`Func<DataGridRequest, ValueTask<DataGridResult<TItem>>>`	Lädt Zeilen von Ihrer Seite: erhält Start, Anzahl, Sortierung, Filter, Suche, Gruppen und Aggregate sowie ein Abbruchtoken (abgebrochen, wenn eine neuere Anfrage beginnt oder das Raster entfernt wird) und gibt ein DataGridResult zurück.
`Dense`	`bool`	Verwendet engeren Zellenabstand.
`DetailTemplate`	`RenderFragment<TItem>`	Inhalt, der unter einer Zeile angezeigt wird, wenn ihre Schaltfläche zum Aufklappen gedrückt wird.
`EditMode`	`DataGridEditMode`	None, Row (inline), Dialog oder Batch (alle Zeilen auf einmal).
`EmptyContent`	`RenderFragment`	Wird angezeigt, wenn es keine Zeilen gibt.
`ExportChoices`	`bool`	Macht aus Export ein Menü: CSV oder JSON, aktuelle Ansicht, gewählte Zeilen, alle Zeilen, ausgeblendete Spalten.
`ExportFileName`	`string`	Dateiname des CSV-Exports, ohne Erweiterung.
`FilterOperators`	`bool`	Fügt über jedem Filterfeld eine Operatorliste hinzu (enthält, beginnt mit, ist gleich, größer als, ist leer ...).
`FormatRules`	`IEnumerable<DataGridFormatRule>`	Regeln, die Zellen oder Zeilen einfärben: Feld, Filteroperator, Wert, Schweregrad und Cell oder Row. Die erste passende Regel gewinnt.
`FreezeFirstColumn`	`bool`	Hält die erste Spalte beim seitlichen Scrollen sichtbar.
`FrozenColumns`	`int`	Anzahl der führenden Spalten, die sichtbar bleiben, während der Rest seitwärts scrollt.
`FrozenEndColumns`	`int`	Anzahl der Spalten am rechten Rand, die sichtbar bleiben, während die Tabelle seitwärts scrollt.
`FrozenRows`	`int`	Anzahl der Zeilen, die unter der Kopfzeile bleiben, während der Körper scrollt (erfordert Height).
`GroupBy`	`Func<TItem, Object>`	Gruppiert Zeilen nach dem zurückgegebenen Wert; jede Gruppe hat eine einklappbare Kopfzeile.
`GroupPanel`	`bool`	Fügt über der Tabelle einen Streifen hinzu, in dem Benutzer Zeilen gruppieren, indem sie Kopfzellen ziehen oder Spalten wählen.
`GroupSummary`	`bool`	Zeigt die Spaltenaggregate in den Gruppenzeilen (lokal berechnet oder mit einem DataProvider aus DataGridResult.Groups übernommen).
`GroupTitle`	`string`	Text vor dem Gruppenwert in der Kopfzeile.
`Height`	`string`	Maximale Höhe des Rasterkörpers, zum Beispiel 24rem (Standard 28rem mit VirtualScroll).
`ItemKey`	`Func<TItem, Object>`	Gibt pro Element einen stabilen Schlüssel zurück, damit Auswahl und geöffnete Details ein Neuladen überstehen.
`Items`	`IEnumerable<TItem>`	Die Optionen zur Auswahl.
`KeyboardShortcuts`	`bool`	Strg+A alles auswählen, Strg+C gewählte Zeilen kopieren, Esc Auswahl aufheben, Alt+Pfeile Seite wechseln.
`Label`	`string`	Sichtbarer Beschriftungstext (Diagramme: zugänglicher Name; IconButton: zugänglicher Name und QuickInfo).
`Loading`	`bool`	Zeigt über den Zeilen einen Fortschrittsbalken.
`LoadingSkeleton`	`bool`	Zeigt beim ersten Laden Platzhalterzeilen.
`LoadMore`	`bool`	Ersetzt die Seitennavigation durch eine Schaltfläche Load more, die die nächste Seite anhängt.
`MultiSort`	`bool`	Umschalt+Klick auf Kopfzellen sortiert nach mehreren Spalten; die Kopfzellen zeigen die Reihenfolge.
`NewItemFactory`	`Func<TItem>`	Erstellt das Element für eine neue Zeile; Standard ist der parameterlose Konstruktor.
`NoMatchContent`	`RenderFragment`	Inhalt, der angezeigt wird, wenn Filter oder Suche keine Zeilen übrig lassen (Standard: ein Text mit Clear filters).
`PageSize`	`int`	Zeilen pro Seite.
`PageSizeOptions`	`IEnumerable<int>`	Zeilenzahlen, die in einem Dropdown unter der Tabelle angeboten werden.
`Paging`	`bool`	Zeigt die Leiste für den Seitenwechsel (Standard true).
`PastePreview`	`bool`	Stapelmodus: Zeigt, was ein Einfügen ändern wird, und fragt vor dem Anwenden nach (Standard an).
`PersistKey`	`string`	Merkt sich Position und Größe (Window), die Teilung (Splitter) oder das Layout eines DataGrid (Sortierung, Filter, Spalten, Breiten, Seite) unter diesem Namen im lokalen Speicher und stellt sie beim nächsten Mal wieder her.
`Reorderable`	`bool`	Lässt Benutzer Spalten durch Ziehen der Kopfzellen oder mit dem Menü Columns verschieben.
`Resizable`	`bool`	Fügt einen Ziehgriff (und Pfeiltasten) zum Ändern der Breite jeder Spalte hinzu.
`RowClass`	`Func<TItem, string>`	Gibt eine zusätzliche CSS-Klasse für eine Zeile zurück.
`RowHeight`	`int`	Zeilenhöhe in Pixeln, wenn VirtualScroll aktiv ist (Standard 44).
`RowMenu`	`Func<TItem, IEnumerable<MenuCommand>>`	Gibt die Befehle des Kontextmenüs einer Zeile zurück.
`RowReorder`	`bool`	Lässt Zeilen aufeinander ziehen; behandeln Sie RowMoved, um Ihre Liste zu ändern.
`RowSeverity`	`Func<TItem, Severity?>`	Gibt einen Schweregrad zurück, um eine Zeile einzufärben, oder null.
`RowValidator`	`Func<TItem, IEnumerable<string>>`	Prüft die ganze Zeile, nachdem die Bearbeitung angewendet wurde; gibt Fehlertexte zurück.
`SelectedItems`	`IEnumerable<TItem>`	Gewählte Zeilen. Verwenden Sie es mit @bind-SelectedItems.
`Selection`	`SelectionMode`	None (Standard), Single oder Multiple.
`SelectionActions`	`RenderFragment<IReadOnlyList<TItem>>`	Schaltflächen in der Auswahlleiste; erhält die gewählten Elemente.
`ServerBulkLimit`	`int`	Mit DataProvider: die größte Zeilenzahl, die das Raster in einer Anfrage anfordert, um alle gefilterten Zeilen auszuwählen oder zu exportieren (Standard 10000). Darüber werden nur die Zeilen der Seite verwendet.
`ShowCopy`	`bool`	Zeigt die Kopieren-Schaltfläche.
`ShowFilters`	`bool`	Zeigt unter jeder filterbaren Kopfzelle ein Filterfeld.
`ShowPrint`	`bool`	Fügt eine Schaltfläche Print hinzu, die die Tabelle druckt.
`ShowSearch`	`bool`	Fügt ein Suchfeld hinzu, das Text in allen Spalten findet und in den Zellen markiert.
`ShowSelectionBar`	`bool`	Zeigt die Leiste mit der Anzahl gewählter Zeilen, alle Zeilen auswählen und Auswahl aufheben (Auswahl Multiple).
`ShowToolbar`	`bool`	Zeigt die Symbolleiste mit Spaltenauswahl und CSV-Export.
`Striped`	`bool`	Schattiert jede zweite Zeile.
`Style`	`string`	Inline-Stil, der dem Wurzelelement hinzugefügt wird.
`ToolbarContent`	`RenderFragment`	Zusätzlicher Inhalt in der Symbolleiste eines Rasters mit ShowToolbar, zum Beispiel DataGridSpreadsheetButton.
`TypedFilters`	`bool`	Verwendet Filterfelder für Zahl, Datum und Ja/Nein je nach Typ der Spaltenwerte (Standard an).
`UndoRedo`	`bool`	Fügt Rückgängig und Wiederholen für gespeicherte Zeilenänderungen, hinzugefügte und gelöschte Zeilen hinzu (Schaltflächen und Strg+Z / Strg+Y).
`ValueFilters`	`bool`	Fügt jeder filterbaren Kopfzelle einen Wertelistenfilter (Suche, alles auswählen, leeren) hinzu; arbeitet mit Elementen im Speicher.
`VirtualScroll`	`bool`	Zeichnet nur die sichtbaren Zeilen (Zeilen müssen die feste RowHeight haben).

DataGridColumn

Parameter	Typ	Beschreibung
`Aggregate`	`DataGridAggregate`	Fügt einen Wert für die Zusammenfassungszeile hinzu: Sum, Average, Min, Max oder Count.
`Align`	`TextAlign`	Left (Standard), Center oder Right.
`BadgeSeverities`	`IReadOnlyDictionary<string, Severity>`	Farbe einer Badge-Spalte pro Wert.
`CellSeverity`	`Func<TItem, Severity?>`	Gibt einen Schweregrad zurück, um eine Zelle einzufärben, oder null.
`ColumnSpan`	`Func<TItem, int>`	Gibt zurück, wie viele Spalten die Zelle eines Elements abdeckt.
`DataBar`	`bool`	Zeichnet hinter Zahlen einen Balken relativ zum größten Wert der Spalte.
`Editable`	`bool`	Lässt Benutzer die Zellen der Spalte durch Anklicken bearbeiten.
`EditOn`	`DataGridEditOn`	Always, Create (nur neue Zeilen) oder Update (nur vorhandene Zeilen).
`EditorOptions`	`IEnumerable<KeyValuePair<string, string>>`	Wert-Beschriftung-Paare; der Editor wird zu einer Liste.
`Field`	`string`	Eigenschaftsname des Elements (auch verschachtelte Namen wie Address.City funktionieren). Er liest die Zelle, sortiert und filtert, wenn Value nicht gesetzt ist, und wird als Spaltenkennung an DataProvider gesendet (Standard Title).
`Filterable`	`bool`	Zeigt ein Filterfeld für diese Spalte (Standard true).
`Format`	`string`	Formatzeichenfolge für Zahlen und Datumswerte, z. B. N0 oder d.
`Group`	`string`	Text der gestapelten Kopfzeile über dieser Spalte; Nachbarn mit demselben Text teilen sich eine Zelle.
`HelpText`	`string`	Ein Hinweis unter dem Feld im Bearbeitungsdialog.
`Hidden`	`bool`	Blendet die Spalte zunächst aus; Benutzer können sie über die Symbolleiste anzeigen.
`ImageAlt`	`Func<TItem, string>`	Alternativtext einer Image-Spalte pro Zeile.
`ImageHeight`	`int`	Höhe des Bildes in Pixeln (Standard 32).
`LinkHref`	`Func<TItem, string>`	Adresse einer Link-Spalte pro Zeile (Standard: der Wert).
`LinkTarget`	`string`	Ziel des Links, zum Beispiel _blank.
`Max`	`Double?`	Größter zulässiger Wert (ProgressBar: der Wert, der 100 % bedeutet; Rating: Anzahl der Sterne).
`MaxLength`	`int?`	Größte zulässige Zeichenzahl.
`MaxWidth`	`string`	Container: feste Maximalbreite ab einem Haltepunkt (Xs bis Xxl). DataGridColumn: größte Breite als CSS-Länge; der Ziehgriff hält dort an.
`MergeRows`	`bool`	Verbindet vertikal benachbarte Zellen mit demselben Text.
`Min`	`Double?`	Kleinster zulässiger Wert.
`MinLength`	`int?`	Kleinste Zeichenzahl, die beim Speichern einer Bearbeitung akzeptiert wird.
`Pattern`	`string`	Regulärer Ausdruck, dem der bearbeitete Text entsprechen muss.
`PatternMessage`	`string`	Fehlertext, der angezeigt wird, wenn Pattern nicht passt.
`ProgressMax`	`Double`	Wert, der eine Progress-Spalte füllt (Standard 100).
`Required`	`bool`	Der Editor lehnt einen leeren Wert ab.
`Sortable`	`bool`	Erlaubt das Sortieren nach dieser Spalte (Standard true).
`Template`	`RenderFragment<TItem>`	Eigener Zelleninhalt. Die Zeile steht als Kontext zur Verfügung.
`Title`	`string`	Titeltext (Kopfzeile der Seitenleiste, Registerbeschriftung, Spaltenüberschrift, Schrittbeschriftung).
`Type`	`DataGridColumnType`	Wie die Zelle gezeichnet wird: Text, Check, Image, Progress, Link, Badge oder Dropdown.
`Validate`	`Func<TItem, Object, string>`	Stepper-Schritt: läuft vor dem Weitergehen, geben Sie false zurück, um auf dem Schritt zu bleiben. DataGrid-Spalte: erhält das Element und den gelesenen Wert und gibt einen Fehlertext oder null zurück.
`Value`	`Func<TItem, Object>`	Gibt den Zellenwert zurück. Wird für Anzeige, Sortierung und Filterung verwendet.
`Width`	`string`	Skeleton: jede CSS-Länge. Charts: Zeichenbreite in SVG-Einheiten (das Diagramm skaliert weiterhin mit seinem Container).

Ereignisse

DataGrid

Ereignis	Typ	Beschreibung
`CardViewChanged`	`EventCallback<bool>`	Wird ausgelöst, wenn der Benutzer zwischen Tabelle und Karten umschaltet.
`OnLoadError`	`EventCallback<Exception>`	Wird mit der Ausnahme ausgelöst, wenn DataProvider fehlschlägt; das Raster zeigt dann keine Zeilen. Ohne Handler geht der Fehler an die Fehlergrenze.
`OnRowDeleting`	`EventCallback<DataGridRowChange<TItem>>`	Läuft nach der Bestätigung; setzen Sie Error am Argument, um das Löschen abzubrechen.
`OnRowSaving`	`EventCallback<DataGridRowChange<TItem>>`	Läuft, bevor eine Zeile übernommen wird; setzen Sie Error am Argument, um abzubrechen und den Text zu zeigen.
`PageSizeChanged`	`EventCallback<int>`	Wird ausgelöst, wenn eine andere Seitengröße gewählt wird.
`RowAdded`	`EventCallback<TItem>`	Wird mit dem neuen Element ausgelöst, nachdem es gespeichert wurde; fügen Sie es Ihrer Liste hinzu.
`RowDeleted`	`EventCallback<TItem>`	Wird mit dem Element ausgelöst, nachdem das Löschen bestätigt wurde; entfernen Sie es aus Ihrer Liste.
`RowMoved`	`EventCallback<DataGridRowMove<TItem>>`	Wird ausgelöst, wenn eine Zeile auf einer anderen Zeile abgelegt wird: das Element, die Seitenindizes (FromIndex, ToIndex), die Indizes in der gesamten sortierten und gefilterten Liste (AbsoluteFromIndex, AbsoluteToIndex; PageOffset ist die Differenz) und das Element, auf dem abgelegt wurde (TargetItem).
`RowSaved`	`EventCallback<TItem>`	Wird mit dem Element ausgelöst, nachdem eine gültige Bearbeitung darauf angewendet wurde.
`RowsPasted`	`EventCallback<int>`	Wird mit der Anzahl der von Paste gefüllten Zeilen ausgelöst.
`SelectedItemsChanged`	`EventCallback<IEnumerable<TItem>>`	Wird ausgelöst, wenn sich die Auswahl ändert.
`StateChanged`	`EventCallback<DataGridState>`	Meldet den DataGridState nach jeder Änderung von Sortierung, Filtern, Spalten, Breiten oder Seite.

DataGridColumn

Ereignis	Typ	Beschreibung
`Edited`	`EventCallback<DataGridEdit<TItem>>`	Wird mit dem Element und dem neuen Text ausgelöst, wenn eine Bearbeitung bestätigt wird.

Paket

DataGrid gehört zu RayCraft Complete. Paket: RayCraft.Blazor.Complete. Es stammt aus dem privaten RayCraft-Feed und erfordert eine aktive Lizenz. Siehe Erste Schritte.

DataGridPdfButtonEine Schaltfläche, die das verbundene DataGrid in eine PDF-Datei exportiert.

Feedback sendenVersion 1.0.3