MAUI默认不支持瀑布流布局,需通过第三方库(如Telerik的StaggeredLayout)或自定义Layout实现;轻量场景可用Grid分组模拟,但存在滚动不同步等问题。

MAUI 默认的 CollectionView 不直接支持瀑布流(Staggered Grid)布局,但可以通过自定义 Layout 或借助第三方库实现。官方目前只提供线性(List)、网格(Grid)和堆叠(Stack)三种内置布局,瀑布流需额外处理。
使用第三方库:Sharpnado.HorizontalListView / Telerik UI for .NET MAUI
推荐使用成熟的第三方组件库,省去底层实现复杂度:
-
Sharpnado.HorizontalListView:虽主打横向列表,其
HorizontalVariableSizedWrapGrid可适配垂直方向变高项,稍作改造可模拟瀑布流; -
Telerik UI for .NET MAUI:提供
RadListView+StaggeredLayout,原生支持垂直/水平瀑布流,设置简单稳定,适合商业项目; - 安装后在 XAML 中声明即可,例如:
纯 MAUI 自定义 Layout(进阶方案)
若坚持不用第三方,可继承 Layout 实现瀑布流逻辑,核心是按列高度动态分配子项位置:
- 重写
OnMeasure预估整体尺寸,OnLayout计算每个子项的X、Y和大小; - 维护一个列高数组(如
double[] columnHeights),每次添加子项时选最短列放置,并更新该列高度; - 需监听
ItemsSource变化或使用BindableLayout绑定子项; - 注意处理旋转、动态加载、刷新等场景,需触发重新布局(调用
InvalidateLayout());
替代思路:用 Grid + 手动分组模拟瀑布流
适用于数据量不大、列数固定(如 2~3 列)的轻量场景:
- 将数据源按“最短列优先”逻辑预分组为多个
IEnumerable列表; - 用
Grid定义多列,每列放一个CollectionView或BindableLayout堆叠控件; - 优点是完全基于原生控件,兼容性好;缺点是无法跨列复用
ItemTemplate,滚动不同步,且不支持原生下拉刷新/上拉加载;
基本上就这些。真要稳定交付,建议优先选 Telerik 或 Syncfusion 等商用控件;学习或小项目可尝试自定义 Layout,但要注意性能和边界情况处理。










