ant-design-blazor/components/table/Table.razor.cs
Hao Sun 78b10019e4 feat(module: table): add table virtualization (#2143)
* feat(module:table): virtualizing

* turn off virtualizing by default

* add document and demo

* NET_6_0 => NET6_0

* update table selection

* update Table.razor.cs

* update table files

* Update table files

* update table files

* update table files

* update table files

* update table files

* update table files

* update table files

* update Virtualizing.razor

* Update AntDesign.csproj

* Update TableRow.razor

* update files

* Update AntDesign.csproj

* update table files

* update Virtualizing.razor

* add DefaultExpandMaxLevel

* rename Virtualizing to EnableVirtualization

Co-authored-by: James Yeung <shunjiey@hotmail.com>
2022-05-28 13:41:01 +08:00

621 lines
19 KiB
C#

using System;
using System.Collections.Generic;
using System.Linq;
using System.Runtime.CompilerServices;
using System.Text.Json;
using System.Threading.Tasks;
using AntDesign.Core.HashCodes;
using AntDesign.JsInterop;
using AntDesign.TableModels;
using Microsoft.AspNetCore.Components;
namespace AntDesign
{
public partial class Table<TItem> : AntDomComponentBase, ITable, IAsyncDisposable
{
private static readonly TItem _fieldModel = (TItem)RuntimeHelpers.GetUninitializedObject(typeof(TItem));
private static readonly EventCallbackFactory _callbackFactory = new EventCallbackFactory();
private bool _preventRender = false;
private bool _shouldRender = true;
private int _parametersHashCode;
[Parameter]
public RenderMode RenderMode { get; set; } = RenderMode.Always;
[Parameter]
public IEnumerable<TItem> DataSource
{
get => _dataSource;
set
{
_waitingDataSourceReload = true;
_dataSourceCount = value?.Count() ?? 0;
_dataSource = value ?? Enumerable.Empty<TItem>();
}
}
[Parameter]
public RenderFragment<TItem> ChildContent { get; set; }
[Parameter]
public RenderFragment<TItem> RowTemplate { get; set; }
[Parameter]
public RenderFragment<RowData<TItem>> ExpandTemplate { get; set; }
[Parameter]
public bool DefaultExpandAllRows { get; set; }
/// <summary>
/// The max expand level when use DefaultExpandAllRows.
/// This attribute is used to avoid endless loop when the tree records have circular reference.
/// The default value is 4.
/// </summary>
[Parameter]
public int DefaultExpandMaxLevel { get; set; } = 4;
[Parameter]
public Func<RowData<TItem>, bool> RowExpandable { get; set; } = _ => true;
[Parameter]
public Func<TItem, bool> RowSelectable { get; set; } = _ => true;
[Parameter]
public Func<TItem, IEnumerable<TItem>> TreeChildren { get; set; } = _ => Enumerable.Empty<TItem>();
[Parameter]
public EventCallback<QueryModel<TItem>> OnChange { get; set; }
[Parameter]
public Func<RowData<TItem>, Dictionary<string, object>> OnRow { get; set; }
[Parameter]
public Func<Dictionary<string, object>> OnHeaderRow { get; set; }
[Parameter]
public bool Loading { get; set; }
[Parameter]
public string Title { get; set; }
[Parameter]
public RenderFragment TitleTemplate { get; set; }
[Parameter]
public string Footer { get; set; }
[Parameter]
public RenderFragment FooterTemplate { get; set; }
[Parameter]
public TableSize Size { get; set; }
[Parameter]
public TableLocale Locale { get; set; } = LocaleProvider.CurrentLocale.Table;
[Parameter]
public bool Bordered { get; set; } = false;
[Parameter]
public string ScrollX { get; set; }
[Parameter]
public string ScrollY { get; set; }
[Parameter]
public int ScrollBarWidth { get; set; } = 17;
[Parameter]
public int IndentSize { get; set; } = 15;
[Parameter]
public int ExpandIconColumnIndex { get; set; }
[Parameter]
public Func<RowData<TItem>, string> RowClassName { get; set; } = _ => "";
[Parameter]
public Func<RowData<TItem>, string> ExpandedRowClassName { get; set; } = _ => "";
[Parameter]
public EventCallback<RowData<TItem>> OnExpand { get; set; }
[Parameter]
public SortDirection[] SortDirections { get; set; } = SortDirection.Preset.Default;
[Parameter]
public string TableLayout { get; set; }
[Parameter]
public EventCallback<RowData<TItem>> OnRowClick { get; set; }
private bool _remoteDataSource;
private bool _hasRemoteDataSourceAttribute;
[Parameter]
public bool RemoteDataSource
{
get => _remoteDataSource;
set
{
_remoteDataSource = value;
_hasRemoteDataSourceAttribute = true;
}
}
[Parameter]
public bool Responsive { get; set; } = true;
#if NET5_0_OR_GREATER
/// <summary>
/// Whether to enable virtualization feature or not, only works for .NET 5 and higher
/// </summary>
[Parameter]
public bool EnableVirtualization { get; set; }
#endif
[Inject]
private IDomEventListener DomEventListener { get; set; }
public ColumnContext ColumnContext { get; set; }
private IEnumerable<TItem> _showItems;
private IEnumerable<TItem> _dataSource;
private IList<SummaryRow> _summaryRows;
private bool _hasInitialized;
private bool _waitingDataSourceReload;
private bool _waitingReloadAndInvokeChange;
private bool _treeMode;
private bool _hasFixLeft;
private bool _hasFixRight;
private int _treeExpandIconColumnIndex;
private QueryModel _currentQueryModel;
private readonly ClassMapper _wrapperClassMapper = new ClassMapper();
private string TableLayoutStyle => TableLayout == null ? "" : $"table-layout: {TableLayout};";
private ElementReference _tableHeaderRef;
private ElementReference _tableBodyRef;
private ElementReference _tableRef;
private bool ServerSide => _hasRemoteDataSourceAttribute ? RemoteDataSource : Total > _dataSourceCount;
bool ITable.TreeMode => _treeMode;
int ITable.IndentSize => IndentSize;
string ITable.ScrollX => ScrollX;
string ITable.ScrollY => ScrollY;
int ITable.ScrollBarWidth => ScrollBarWidth;
int ITable.ExpandIconColumnIndex => ExpandIconColumnIndex + (_selection != null && _selection.ColIndex <= ExpandIconColumnIndex ? 1 : 0);
int ITable.TreeExpandIconColumnIndex => _treeExpandIconColumnIndex;
bool ITable.HasExpandTemplate => ExpandTemplate != null;
TableLocale ITable.Locale => this.Locale;
SortDirection[] ITable.SortDirections => SortDirections;
/// <summary>
/// This method will be called when all columns have been set
/// </summary>
void ITable.OnColumnInitialized() => OnColumnInitialized();
void ITable.OnExpandChange(RowData rowData)
{
if (OnExpand.HasDelegate)
{
OnExpand.InvokeAsync(rowData as RowData<TItem>);
}
}
void ITable.AddSummaryRow(SummaryRow summaryRow)
{
_summaryRows ??= new List<SummaryRow>();
_summaryRows.Add(summaryRow);
}
void OnColumnInitialized()
{
if (_hasInitialized)
{
return;
}
ReloadAndInvokeChange();
_hasInitialized = true;
}
public void ReloadData()
{
PageIndex = 1;
FlushCache();
this.ReloadAndInvokeChange();
}
public void ReloadData(int? pageIndex, int? pageSize = null)
{
ChangePageIndex(pageIndex ?? 1);
ChangePageSize(pageSize ?? PageSize);
FlushCache();
this.ReloadAndInvokeChange();
}
public QueryModel GetQueryModel() => BuildQueryModel();
private QueryModel<TItem> BuildQueryModel()
{
var queryModel = new QueryModel<TItem>(PageIndex, PageSize);
foreach (var col in ColumnContext.HeaderColumns)
{
if (col is IFieldColumn fieldColumn)
{
if (fieldColumn.SortModel != null)
{
queryModel.AddSortModel(fieldColumn.SortModel);
}
if (fieldColumn.FilterModel != null)
{
queryModel.AddFilterModel(fieldColumn.FilterModel);
}
}
}
return queryModel;
}
void ITable.Refresh()
{
_shouldRender = true;
StateHasChanged();
}
void ITable.ReloadAndInvokeChange()
{
ReloadAndInvokeChange();
}
void ITable.ColumnSorterChange(IFieldColumn column)
{
foreach (var col in ColumnContext.HeaderColumns)
{
if (col.ColIndex != column.ColIndex && col is IFieldColumn fieldCol && fieldCol.SorterMultiple <= 0 && fieldCol.Sortable)
{
fieldCol.ClearSorter();
}
}
ReloadAndInvokeChange();
}
private void ReloadAndInvokeChange()
{
var queryModel = this.InternalReload();
StateHasChanged();
if (OnChange.HasDelegate)
{
OnChange.InvokeAsync(queryModel);
}
}
private QueryModel<TItem> InternalReload()
{
var queryModel = BuildQueryModel();
_currentQueryModel = queryModel;
if (ServerSide)
{
_showItems = _dataSource;
_total = Total;
}
else
{
if (_dataSource != null)
{
var query = queryModel.ExecuteQuery(_dataSource.AsQueryable());
_total = query.Count();
_showItems = queryModel.CurrentPagedRecords(query);
}
else
{
_showItems = Enumerable.Empty<TItem>();
_total = 0;
}
if (_total != Total && TotalChanged.HasDelegate)
{
TotalChanged.InvokeAsync(_total);
}
_shouldRender = true;
}
if (!_preventRender)
{
if (_outerSelectedRows != null)
{
_selectedRows = GetAllItemsByTopLevelItems(_showItems, true).Intersect(_outerSelectedRows).ToHashSet();
if (_selectedRows.Count != _outerSelectedRows.Count())
{
SelectedRowsChanged.InvokeAsync(_selectedRows);
}
}
else
{
_selectedRows?.Clear();
}
var removedCacheItems = _dataSourceCache.Keys.Except(_showItems).ToArray();
if (removedCacheItems.Length > 0)
{
foreach (var item in removedCacheItems)
{
_dataSourceCache.Remove(item);
}
_allRowDataCache.Clear();
}
}
_treeMode = TreeChildren != null && (_showItems?.Any(x => TreeChildren(x)?.Any() == true) == true);
if (_treeMode)
{
_treeExpandIconColumnIndex = ExpandIconColumnIndex + (_selection != null && _selection.ColIndex <= ExpandIconColumnIndex ? 1 : 0);
}
return queryModel;
}
private void SetClass()
{
string prefixCls = "ant-table";
ClassMapper.Add(prefixCls)
.If($"{prefixCls}-fixed-header", () => ScrollY != null)
.If($"{prefixCls}-bordered", () => Bordered)
.If($"{prefixCls}-small", () => Size == TableSize.Small)
.If($"{prefixCls}-middle", () => Size == TableSize.Middle)
.If($"{prefixCls}-fixed-column {prefixCls}-scroll-horizontal", () => ScrollX != null)
.If($"{prefixCls}-has-fix-left", () => _hasFixLeft)
.If($"{prefixCls}-has-fix-right", () => _hasFixRight)
//.If($"{prefixCls}-ping-left", () => _pingLeft)
//.If($"{prefixCls}-ping-right", () => _pingRight)
.If($"{prefixCls}-rtl", () => RTL)
;
_wrapperClassMapper
.Add($"{prefixCls}-wrapper")
.If($"{prefixCls}-responsive", () => Responsive) // Not implemented in ant design
.If($"{prefixCls}-wrapper-rtl", () => RTL);
}
protected override void OnInitialized()
{
base.OnInitialized();
if (RowTemplate != null)
{
ChildContent = RowTemplate;
}
this.ColumnContext = new ColumnContext(this);
SetClass();
if (ScrollX != null || ScrollY != null)
{
TableLayout = "fixed";
}
InitializePagination();
FlushCache();
}
private IEnumerable<TItem> GetAllItemsByTopLevelItems(IEnumerable<TItem> items, bool onlySelectable = false)
{
if (items?.Any() != true) return Array.Empty<TItem>();
if (TreeChildren == null) return items;
var result = GetAllDataItemsWithParent(items.Select(x => new DataItemWithParent<TItem>
{
Data = x,
Parent = null
})).Select(x => x.Data);
if (onlySelectable) result = result.Where(x => RowSelectable(x));
return result.ToHashSet();
IEnumerable<DataItemWithParent<TItem>> GetAllDataItemsWithParent(IEnumerable<DataItemWithParent<TItem>> dataItems)
{
if (dataItems?.Any() != true) return Array.Empty<DataItemWithParent<TItem>>();
if (TreeChildren == null) return dataItems ?? Array.Empty<DataItemWithParent<TItem>>();
return dataItems.Union(
dataItems.SelectMany(
x1 =>
{
var ancestors = x1.GetAllAncestors().Select(x2 => x2.Data).ToHashSet();
return GetAllDataItemsWithParent(TreeChildren(x1.Data)?.Select(x2 => new DataItemWithParent<TItem>
{
Data = x2,
Parent = x1
}).Where(x2 => !ancestors.Contains(x2.Data) && x2.Data?.Equals(x1.Data) == false));
})
).ToList();
}
}
class DataItemWithParent<T>
{
public T Data { get; set; }
public DataItemWithParent<T> Parent { get; set; }
public IEnumerable<DataItemWithParent<T>> GetAllAncestors()
{
var result = new HashSet<DataItemWithParent<T>>();
var parent = Parent;
while (parent != null)
{
result.Add(parent);
parent = parent.Parent;
}
return result;
}
}
protected override void OnParametersSet()
{
base.OnParametersSet();
if (_waitingReloadAndInvokeChange)
{
_waitingReloadAndInvokeChange = false;
if (_hasInitialized)
{
_waitingDataSourceReload = false;
ReloadAndInvokeChange();
}
}
else if (_waitingDataSourceReload)
{
_waitingDataSourceReload = false;
if (_hasInitialized)
{
InternalReload();
}
}
if (_preventRender)
{
_shouldRender = false;
_preventRender = false;
}
else if (this.RenderMode == RenderMode.ParametersHashCodeChanged)
{
var hashCode = this.GetParametersHashCode();
this._shouldRender = this._parametersHashCode != hashCode;
this._parametersHashCode = hashCode;
}
else
{
this._shouldRender = true;
}
}
protected override async Task OnAfterRenderAsync(bool firstRender)
{
await base.OnAfterRenderAsync(firstRender);
if (firstRender)
{
DomEventListener.AddShared<JsonElement>("window", "beforeunload", Reloading);
if (ScrollY != null || ScrollX != null)
{
await JsInvokeAsync(JSInteropConstants.BindTableScroll, _tableBodyRef, _tableRef, _tableHeaderRef, ScrollX != null, ScrollY != null);
}
// To handle the case where JS is called asynchronously and does not render when there is a fixed header or are any fixed columns.
if (_hasInitialized && !_shouldRender)
{
_shouldRender = true;
StateHasChanged();
return;
}
// To handle the case where a dynamic table does not render columns until the data is requested
if (!ColumnContext.HeaderColumns.Any() && !_hasInitialized)
{
OnColumnInitialized();
return;
}
}
if (!firstRender)
{
this.FinishLoadPage();
}
_shouldRender = false;
}
protected override bool ShouldRender()
{
// Do not render until initialisation is complete.
this._shouldRender = this._shouldRender && _hasInitialized;
return this._shouldRender;
}
void ITable.HasFixLeft() => _hasFixLeft = true;
void ITable.HasFixRight() => _hasFixRight = true;
void ITable.TableLayoutIsFixed()
{
TableLayout = "fixed";
StateHasChanged();
}
protected override void Dispose(bool disposing)
{
DomEventListener?.Dispose();
base.Dispose(disposing);
}
public async ValueTask DisposeAsync()
{
if (!_isReloading)
{
if (ScrollY != null || ScrollX != null)
{
await JsInvokeAsync(JSInteropConstants.UnbindTableScroll, _tableBodyRef);
}
}
DomEventListener?.Dispose();
}
bool ITable.RowExpandable(RowData rowData)
{
return RowExpandable(rowData as RowData<TItem>);
}
IEnumerable<TItem> SortFilterChildren(IEnumerable<TItem> children)
{
if (_currentQueryModel == null || ServerSide)
{
return children;
}
var query = children.AsQueryable();
foreach (var sort in _currentQueryModel.SortModel.OrderBy(x => x.Priority))
{
query = sort.SortList(query);
}
foreach (var filter in _currentQueryModel.FilterModel)
{
query = filter.FilterList(query);
}
return query;
}
/// <summary>
/// Indicates that a page is being refreshed
/// </summary>
private bool _isReloading;
private void Reloading(JsonElement jsonElement)
{
_isReloading = true;
}
}
}