RayCraftDocs
v1.0.3
de
raycraft.dev
Auf dieser Seite

VirtualList

Free

Eine scrollende Liste, die nur die sichtbaren Zeilen zeichnet, für Hunderttausende von Elementen. Zeilen haben eine feste Höhe (eine Zeilenvorlage kann mehrere Zeilen haben); die Tastatur erreicht jede Zeile. Zeilen können fensterweise vom Server kommen, mehrere Zeilen können gewählt und auf eine TreeView gezogen werden.

Beispiel

Steuerelement VirtualList

Parameter

ParameterTypBeschreibung
ClassstringZusätzliche CSS-Klassen, die dem Wurzelelement hinzugefügt werden.
DraggableboolLässt Zeilen ziehen; die Nutzlast geht an IRayCraftDrag (VirtualList).
DragPayloadFunc<IReadOnlyList<TItem>, Object>Baut die Zieh-Nutzlast aus den gezogenen Zeilen (Standard: die Liste der Zeilen).
HeightstringHöhe der Liste, zum Beispiel 24rem (Standard 16rem); die Liste scrollt darin.
ItemBoldFunc<TItem, bool>Gibt an, ob der Text eines Elements fett ist, zum Beispiel wenn es ungelesen ist.
ItemClassFunc<TItem, string>Fügt einer Zeile CSS-Klassen hinzu (VirtualList).
ItemHeightintHöhe einer Zeile in Pixeln (Standard 36). Alle Zeilen haben dieselbe Höhe.
ItemKeyFunc<TItem, Object>Gibt pro Element einen stabilen Schlüssel zurück, damit Auswahl und geöffnete Details ein Neuladen überstehen.
ItemsIEnumerable<TItem>Die anzuzeigenden Elemente.
ItemsProviderFunc<VirtualListRequest, Task<VirtualListResult<TItem>>>Lädt Zeilen von einem Server: erhält die Startzeile, die Anzahl und ein Abbruchtoken und gibt die Zeilen mit der Gesamtzahl zurück (VirtualList; Autocomplete hat einen eigenen Provider).
ItemTemplateRenderFragment<TItem>Eigener Inhalt für jedes Element. Das Element steht als Kontext zur Verfügung.
ItemTextFunc<TItem, string>Wandelt ein Element in seinen Anzeigetext um (Standard ToString()).
LabelstringSichtbarer Beschriftungstext (Diagramme: zugänglicher Name; IconButton: zugänglicher Name und QuickInfo).
MultipleboolErlaubt die Auswahl mehrerer Zeilen: Klick, Strg+Klick, Umschalt+Klick, Umschalt+Pfeile, Strg+A (VirtualList).
SelectableboolLässt die Auswahl von Zeilen zu (Standard true).
SelectedItemTItemGewähltes Element. Verwenden Sie es mit @bind-SelectedItem.
SelectedItemsIReadOnlyList<TItem>Gewählte Zeilen. Verwenden Sie es mit @bind-SelectedItems.
ShowDragHandleboolZeigt am Anfang einer Zeile einen Griff und zieht nur am Griff (VirtualList).
StylestringInline-Stil, der dem Wurzelelement hinzugefügt wird.

Ereignisse

EreignisTypBeschreibung
OnLoadErrorEventCallback<Exception>Wird mit der Ausnahme ausgelöst, wenn ItemsProvider keine Zeilen laden kann.
SelectedItemChangedEventCallback<TItem>Wird ausgelöst, wenn ein anderes Element gewählt wird.
SelectedItemsChangedEventCallback<IReadOnlyList<TItem>>Wird ausgelöst, wenn sich die Auswahl ändert.

Paket

VirtualList gehört zu RayCraft Free. Paket: RayCraft.Blazor. Es stammt von nuget.org. Siehe Erste Schritte.