跳转到主内容
新派编程网 - 新潮编程理念,全新技术课堂!

MAUI怎么实现一个可折叠的列表项 MAUI Expander控件

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

相关文章