MAUI中实现可折叠列表项最直接方式是使用Expander控件配合CollectionView,通过为每个数据项添加IsExpanded属性并绑定,实现独立展开/收起;需确保模型实现INotifyPropertyChanged,XAML正确绑定,注意iOS早期版本布局问题。
MAUI 中实现可折叠的列表项,最直接的方式是使用内置的
Expander
控件,配合
CollectionView
或
ListView
使用。它本身不支持直接放在
里“自动展开/收起”,但通过绑定 + 数据模型控制,完全可以做到每个列表项独立折叠。
Expander 基础用法(单个)
Expander 是一个容器控件,包含
(点击区域)和
(折叠内容)。默认点击 header 切换展开状态:
在 CollectionView 中为每个项添加独立折叠能力
关键点:每个数据项需自带一个
属性,并绑定到 Expander 的
属性。这样每条数据控制自己的展开状态,互不影响。
Trae win
Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统(64位)。国内开发者可直接访问 Trae 中文官网(trae.cn 或 trae.com.cn),一键下载官方正版 .exe 安装包,享受国内直连的高速稳定体验。安装过程极其简便,双击即可运行,并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型,让你开箱即用,轻松开启高效的 AI 智能编程之旅。
下载
定义数据模型(例如
):
在 XAML 的
中使用 Expander:
优化体验的小技巧
默认全部收起
:初始化时确保每个
点击 header 外区域不触发
:Expander 默认只响应 header 点击,无需额外处理;若想点击整行展开,可把整个
或
设为 header,或用
手动切换
动画更自然
:MAUI 5.0+ 默认已有淡入/高度变化动画;如需自定义,可通过
(部分平台支持),或用
配合
/
避免嵌套滚动冲突
:Expander 内容若含 ScrollView,在 iOS 上可能滑动卡顿;建议限制内容高度、禁用内部滚动,或改用
+ 动画控制
注意事项
Expander 在 Android 和 Windows 上表现稳定;iOS 上早期版本(.NET MAUI 6.0~7.0)有轻微布局
重绘
问题,升级到 .NET MAUI 8.0+ 已基本修复。若遇到内容不显示,检查是否遗漏
或绑定路径错误,以及
是否正确触发。
基本上就这些 —— Expander 不复杂但容易忽略绑定细节,只要模型可通知、XAML 绑定写对,每个列表项就能独立、流畅地折叠展开。
ItemTemplateHeaderContent
IsExpandedIsExpandedListItempublic class ListItem : INotifyPropertyChanged
{
private bool _isExpanded;
public string Title { get; set; }
public string Detail { get; set; }
public bool IsExpanded
{
get => _isExpanded;
set
{
if (_isExpanded != value)
{
_isExpanded = value;
OnPropertyChanged();
}
}
}
public event PropertyChangedEventHandler PropertyChanged;
protected virtual void OnPropertyChanged([CallerMemberName] string propertyName = null) =>
PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
}
CollectionView.ItemTemplate
ListItem.IsExpanded = falseStackLayoutGridTapGestureRecognizerIsExpandedExpander.AnimatedExpandCollapseVisualStateManagerScaleToFadeToHeightRequestx:DataTypeINotifyPropertyChanged