RayCraftDocs
v1.0.3
fr
raycraft.dev
Sur cette page

VirtualList

Free

Une liste défilante qui ne dessine que les lignes visibles, pour des centaines de milliers d'éléments. Les lignes ont une hauteur fixe (un modèle de ligne peut avoir plusieurs lignes) ; le clavier atteint chaque ligne. Les lignes peuvent venir du serveur par fenêtres, plusieurs lignes peuvent être sélectionnées et glissées sur un TreeView.

Exemple

Contrôle VirtualList

Paramètres

ParamètreTypeDescription
ClassstringClasses CSS supplémentaires ajoutées à l'élément racine.
DraggableboolPermet de glisser des lignes ; la charge va à IRayCraftDrag (VirtualList).
DragPayloadFunc<IReadOnlyList<TItem>, Object>Construit la charge de glissement à partir des lignes glissées (par défaut : la liste des lignes).
HeightstringHauteur de la liste, par exemple 24rem (16rem par défaut) ; la liste défile à l'intérieur.
ItemBoldFunc<TItem, bool>Indique si le texte d'un élément est en gras, par exemple quand il n'est pas lu.
ItemClassFunc<TItem, string>Ajoute des classes CSS à une ligne (VirtualList).
ItemHeightintHauteur d'une ligne en pixels (36 par défaut). Toutes les lignes ont la même hauteur.
ItemKeyFunc<TItem, Object>Renvoie une clé stable par élément, afin que la sélection et les détails ouverts survivent aux rechargements.
ItemsIEnumerable<TItem>Les éléments à afficher.
ItemsProviderFunc<VirtualListRequest, Task<VirtualListResult<TItem>>>Charge des lignes depuis un serveur : reçoit la ligne de départ, le nombre et un jeton d'annulation et renvoie les lignes avec le nombre total (VirtualList ; Autocomplete a son propre fournisseur).
ItemTemplateRenderFragment<TItem>Contenu personnalisé pour chaque élément. L'élément est disponible comme contexte.
ItemTextFunc<TItem, string>Convertit un élément en son texte d'affichage (ToString() par défaut).
LabelstringTexte d'étiquette visible (graphiques : nom accessible ; IconButton : nom accessible et info-bulle).
MultipleboolAutorise la sélection de plusieurs lignes : clic, Ctrl+clic, Maj+clic, Maj+flèches, Ctrl+A (VirtualList).
SelectableboolPermet de sélectionner des lignes (true par défaut).
SelectedItemTItemÉlément sélectionné. À utiliser avec @bind-SelectedItem.
SelectedItemsIReadOnlyList<TItem>Lignes sélectionnées. À utiliser avec @bind-SelectedItems.
ShowDragHandleboolAffiche une poignée au début d'une ligne et ne glisse que par la poignée (VirtualList).
StylestringStyle en ligne ajouté à l'élément racine.

Événements

ÉvénementTypeDescription
OnLoadErrorEventCallback<Exception>Déclenché avec l'exception quand ItemsProvider n'arrive pas à charger des lignes.
SelectedItemChangedEventCallback<TItem>Déclenché quand un autre élément est sélectionné.
SelectedItemsChangedEventCallback<IReadOnlyList<TItem>>Déclenché quand la sélection change.

Paquet

VirtualList fait partie de RayCraft Free. Paquet : RayCraft.Blazor. Il provient de nuget.org. Voir Premiers pas.