This is a virtual list component packaged with blazor.
$ dotnet add package Blazor.VirtualizationThis is a virtual list component packaged with blazor. Built in layouts such as Waterfall, LinedFlow, and GridList. And it supports incremental loading.
However, the size of the data items for WaterfallLayout and LinedFlowLayout must be known, or can be calculated based on the data items. So the two layouts don't support auto-sizing items.
dotnet add package Blazor.Virtualization
PM> Install-Package Blazor.Virtualization
<PackageReference Include="Blazor.Virtualization" Version="1.0.3" />
<link href="_content/Blazor.Virtualization/Blazor.Virtualization.bundle.scp.css" rel="stylesheet" />
@using Blazor.Virtualization
@using Blazor.Virtualization.Layout
<VirtualList TItem="int" Items="data">
<Layout>
<WaterfallLayout VirtualList="context"
Spacing="24"
HeightCalculator="(o,_)=>o"></WaterfallLayout>
</Layout>
<ItemTemplate>
<div style="height:100%;background-color:#aaccee;">@context</div>
</ItemTemplate>
</VirtualList>
@code {
private List<int> data =
Enumerable
.Range(0, 500)
.Select(o => new Random().Next(120, 300))
.ToList();
}
<VirtualList TItem="int"
IncrementalItemsProvider="@this.LoadDataAsync">
<Layout>
<WaterfallLayout VirtualList="context"
Spacing="12"
HeightCalculator="(o,_)=>o"></WaterfallLayout>
</Layout>
<ItemTemplate>
<div style="height:100%;background-color:#aaccee;">@context</div>
</ItemTemplate>
</VirtualList>
@code {
private async ValueTask<IEnumerable<int>> LoadDataAsync()
{
await Task.Delay(500);
var items = Enumerable
.Range(0, 50)
.Select(o => new Random().Next(120, 600));
return items;
}
}
<VirtualList TItem="int"
IncrementalItemsProvider="@this.LoadDataAsync">
<Layout>
<GridListLayout VirtualList="context"
Spacing="12"
ItemHeight="Auto"></GridListLayout>
</Layout>
<ItemTemplate>
<div style="height:100%;background-color:#aaccee;">@context</div>
</ItemTemplate>
</VirtualList>
@code {
private async ValueTask<IEnumerable<int>> LoadDataAsync()
{
await Task.Delay(300);
var items = Enumerable
.Range(0, 50)
.Select(o => new Random().Next(120, 600));
return items;
}
}
<VirtualList TItem="int"
IncrementalItemsProvider="@this.LoadDataAsync">
<Layout>
<LinedFlowLayout VirtualList="context"
Spacing="8"
WidthCalculator="o=>o*1f"></LinedFlowLayout>
</Layout>
<ItemTemplate>
<div style="height:100%;background-color:#aaccee;">@context</div>
</ItemTemplate>
</VirtualList>
@code {
private async ValueTask<IEnumerable<int>> LoadDataAsync()
{
await Task.Delay(300);
var items = Enumerable
.Range(0, 50)
.Select(o => new Random().Next(120, 300));
return items;
}
}
| Name | Type | Default value | Description |
|---|---|---|---|
| Items | IList | null | The datasource. |
| Layout | RenderFragment | null | The list layout. |
| EmptyTemplate | RenderFragment | null | The template if no data. |
| IncrementalItemsProvider | ValueTask<List> | null | The Incremental loading datasource provider |
| Name | Type | Default value | Description |
|---|---|---|---|
| HeightCalculator | Func<TItem, float, float> | null | The calculator of item height. The first parameter is the data item. And then second parameter is the ItemWidth. You can calculate the height based on these two parameters. |
| Spacing | float | 8 | The spacing of items. |
| MinItemWidth | float | 200 | The minimum width of the item. |
| MinColumnCount | float | 1 | The minimum column count of the component. |
| Name | Type | Default value | Description |
|---|---|---|---|
| Spacing | float | 8 | The spacing of items. |
| MinItemWidth | float | 200 | The minimum width of the item. |
| MinColumnCount | float | 1 | The minimum column count of the component. |
| ItemHeight | string | Auto | The height of all the items. If the value is "Auto" or other non-numeric type, the value will be ItemWidth. |
| Name | Type | Default value | Description |
|---|---|---|---|
| Spacing | float | 8 | The spacing of items. |
| RowHeight | float | 200 | The height of all the rows. |
| WidthCalculator | Func<TItem, float> | null | The calculator of the minwidth. The parameter is data of the item. |