RayCraftDocs
v1.0.3
pt-BR
raycraft.dev
Nesta página

VirtualList

Free

Uma lista rolável que desenha só as linhas visíveis, para centenas de milhares de itens. As linhas têm altura fixa (um modelo de linha pode ter várias linhas); o teclado alcança todas as linhas. As linhas podem vir do servidor em janelas, várias linhas podem ser selecionadas e arrastadas para um TreeView.

Exemplo

Controle VirtualList

Parâmetros

ParâmetroTipoDescrição
ClassstringClasses CSS extras adicionadas ao elemento raiz.
DraggableboolPermite arrastar linhas; a carga vai para IRayCraftDrag (VirtualList).
DragPayloadFunc<IReadOnlyList<TItem>, Object>Constrói a carga de arrasto a partir das linhas arrastadas (por padrão: a lista de linhas).
HeightstringAltura da lista, por exemplo 24rem (16rem por padrão); a lista rola dentro dela.
ItemBoldFunc<TItem, bool>Informa se o texto de um item está em negrito, por exemplo quando não foi lido.
ItemClassFunc<TItem, string>Adiciona classes CSS a uma linha (VirtualList).
ItemHeightintAltura de uma linha em pixels (36 por padrão). Todas as linhas têm a mesma altura.
ItemKeyFunc<TItem, Object>Devolve uma chave estável por item, para que a seleção e os detalhes abertos sobrevivam a recarregamentos.
ItemsIEnumerable<TItem>Os itens a mostrar.
ItemsProviderFunc<VirtualListRequest, Task<VirtualListResult<TItem>>>Carrega linhas de um servidor: recebe a linha inicial, a quantidade e um token de cancelamento e devolve as linhas com a contagem total (VirtualList; Autocomplete tem seu próprio provedor).
ItemTemplateRenderFragment<TItem>Conteúdo personalizado para cada item. O item está disponível como contexto.
ItemTextFunc<TItem, string>Converte um item no seu texto de exibição (ToString() por padrão).
LabelstringTexto visível do rótulo (gráficos: nome acessível; IconButton: nome acessível e dica de ferramenta).
MultipleboolPermite selecionar várias linhas: clique, Ctrl+clique, Shift+clique, Shift+setas, Ctrl+A (VirtualList).
SelectableboolPermite selecionar linhas (true por padrão).
SelectedItemTItemItem selecionado. Use com @bind-SelectedItem.
SelectedItemsIReadOnlyList<TItem>Linhas selecionadas. Use com @bind-SelectedItems.
ShowDragHandleboolMostra uma alça no início de uma linha e arrasta somente pela alça (VirtualList).
StylestringEstilo embutido adicionado ao elemento raiz.

Eventos

EventoTipoDescrição
OnLoadErrorEventCallback<Exception>Gerado com a exceção quando ItemsProvider não consegue carregar linhas.
SelectedItemChangedEventCallback<TItem>Gerado quando outro item é selecionado.
SelectedItemsChangedEventCallback<IReadOnlyList<TItem>>Gerado quando a seleção muda.

Pacote

VirtualList faz parte do RayCraft Free. Pacote: RayCraft.Blazor. Vem do nuget.org. Veja Primeiros passos.