讲师中心 微信公众号
AI工具推荐 视频效率加速

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

轻宇君_9444

轻宇君_9444

发布时间:2025-12-20 10:18:33

|

772人浏览过

|

来源于php中文网

原创

MAUI中实现可折叠列表项最直接方式是使用Expander控件配合CollectionView,通过为每个数据项添加IsExpanded属性并绑定,实现独立展开/收起;需确保模型实现INotifyPropertyChanged,XAML正确绑定,注意iOS早期版本布局问题。

maui怎么实现一个可折叠的列表项 maui expander控件

MAUI 中实现可折叠的列表项,最直接的方式是使用内置的 Expander 控件,配合 CollectionView 或 ListView 使用。它本身不支持直接放在 ItemTemplate 里“自动展开/收起”,但通过绑定 + 数据模型控制,完全可以做到每个列表项独立折叠。

Expander 基础用法(单个)

Expander 是一个容器控件,包含 Header(点击区域)和 Content(折叠内容)。默认点击 header 切换展开状态:

<Expander>
    <Expander.Header>
        <Label Text="点击展开详情" />
    </Expander.Header>
    <Expander.Content>
        <StackLayout Padding="10">
            <Label Text="这里是隐藏的详细信息..." />
            <Button Text="操作按钮" />
        </StackLayout>
    </Expander.Content>
</Expander>

在 CollectionView 中为每个项添加独立折叠能力

关键点:每个数据项需自带一个 IsExpanded 属性,并绑定到 Expander 的 IsExpanded 属性。这样每条数据控制自己的展开状态,互不影响。

windows-shell-syntax
windows-shell-syntax

在 Windows 上执行终端命令,或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe,再给出相应命令……

下载
  • 定义数据模型(例如 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:
    <CollectionView ItemsSource="{Binding Items}">
        <CollectionView.ItemTemplate>
            <DataTemplate x:DataType="model:ListItem">
                <Expander IsExpanded="{Binding IsExpanded}">
                    <Expander.Header>
                        <Label Text="{Binding Title}" FontSize="16" Margin="10,5" />
                    </Expander.Header>
                    <Expander.Content>
                        <StackLayout Padding="10,0,10,10">
                            <Label Text="{Binding Detail}" />
                            <Button Text="编辑" Command="{Binding Source={RelativeSource AncestorType={x:Type vm:MainPageViewModel}}, Path=EditCommand}" CommandParameter="{Binding}" />
                        </StackLayout>
                    </Expander.Content>
                </Expander>
            </DataTemplate>
        </CollectionView.ItemTemplate>
    </CollectionView>
    

优化体验的小技巧

  • 默认全部收起:初始化时确保每个 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 绑定写对,每个列表项就能独立、流畅地折叠展开。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

相关专题

更多
windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3239

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2818

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

1488

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

2579

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3290

2023.08.08

windows自动更新
windows自动更新

Windows操作系统的自动更新功能可以确保系统及时获取最新的补丁和安全更新,以提高系统的稳定性和安全性。然而,有时候我们可能希望暂时或永久地关闭Windows的自动更新功能。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1617

2023.08.10

windows boot manager
windows boot manager

windows boot manager无法开机的解决方法:1、系统文件损坏,使用Windows安装光盘或USB启动盘进入恢复环境,选择修复计算机,然后选择自动修复;2、引导顺序错误,进入恢复环境,选择命令提示符,输入命令"bootrec /fixboot"和"bootrec /fixmbr",然后重新启动计算机;3、硬件问题,使用硬盘检测工具进行扫描和修复;4、重装操作系统。本专题还提供其他解决

2497

2023.08.28

windows锁屏快捷键
windows锁屏快捷键

windows锁屏快捷键是Windows键+L、Ctrl+Alt+Del、Windows键+D、Windows键+P和Windows键+R。本专题为大家提供windows相关的文章、下载、课程内容,供大家免费下载体验。

4887

2023.08.30

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

80

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 44.5万人学习

Java 教程
Java 教程

共578课时 | 192.7万人学习

Uniapp从零开始实现新闻资讯应用
Uniapp从零开始实现新闻资讯应用

共64课时 | 9.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn