AntDesign Blazor 表格组件分页行为变更解析

前言

在AntDesign Blazor组件库的1.1.4版本中，Table组件的分页显示逻辑发生了一个重要变更。这个变更影响了当隐藏分页控件时表格数据的显示方式，值得开发者特别关注。

变更内容

在1.1.3及更早版本中，当设置HidePagination=true时，无论PageSize属性设置为何值，表格都会显示所有数据行。而在1.1.4版本后，即使隐藏了分页控件，表格仍会遵守PageSize的设置，仅显示指定数量的数据行。

技术细节分析

这个变更实际上使得表格组件的行为更加明确和一致。在旧版本中，HidePagination属性会完全覆盖PageSize的行为，这可能导致一些意料之外的结果。新版本则明确区分了这两个属性的职责：

• PageSize：始终控制每页显示的数据行数
• HidePagination：仅控制分页控件的显示/隐藏

实际影响

这一变更可能会影响以下场景：

1. 开发者原本依赖隐藏分页时自动显示所有数据的逻辑
2. 在表格中需要同时控制显示行数和分页可见性的场景

解决方案

如果需要在隐藏分页时显示所有数据，开发者可以采取以下方式：

<Table TItem="RowModel" 
       DataSource="@rows" 
       PageSize="@(hidePagination ? int.MaxValue : pageSize)" 
       HidePagination="@hidePagination">
   <PropertyColumn Property="c => c.Nr" />
</Table>

或者更优雅的方式是：

@code {
    int actualPageSize => hidePagination ? rows.Count : pageSize;
}

<Table TItem="RowModel" 
       DataSource="@rows" 
       PageSize="@actualPageSize" 
       HidePagination="@hidePagination">
   <PropertyColumn Property="c => c.Nr" />
</Table>

最佳实践建议

1. 明确区分数据分页逻辑和UI显示逻辑
2. 在需要隐藏分页时显示所有数据的场景下，主动设置足够大的PageSize值
3. 在升级到1.1.4+版本时，检查所有使用Table组件的页面

总结

AntDesign Blazor团队通过这一变更使得组件行为更加明确和可预测。虽然这是一个破坏性变更，但它带来了更一致的API设计。开发者应当理解这一变更的技术背景，并在代码中做出相应调整。

对于需要向后兼容的场景，建议封装一个自定义表格组件，内部处理这些分页逻辑，而不是在每个使用处重复处理。