用途:在 .NET MAUI 应用中实现可折叠/可展开的内容区块,通过点击标题显示或隐藏内容,适合手风琴布局、FAQ、设置面板、发票或收据等需要节省空间、组织内容的界面。
主要能力:单击标题即可展开或折叠;Header 与 Content 可完全自定义布局;支持可配置时长与缓动的平滑动画;提供 Expanding、Expanded、Collapsing、Collapsed 事件,其中 Expanding 与 Collapsing 可取消;可通过 IsExpanded 属性以编程方式控制;支持 Visual State Manager 动态样式;可自定义标题背景、图标位置与颜色;在 .NET 10+、macOS 26+、iOS 26+ 上支持液态玻璃效果;针对各平台优化渲染与动画。
使用方式:安装 Syncfusion.Maui.Expander NuGet 包,注册 Syncfusion 处理器(ConfigureSyncfusionCore),创建 SfExpander 实例并定义 Header 与 Content 视图,用 IsExpanded 控制初始状态。动画通过 AnimationDuration(默认 300ms)与 AnimationEasing 设置;外观通过 HeaderIconPosition(Start、End)、HeaderBackground、HeaderIconColor 及 VSM 状态(Expanded、Collapsed、PointerOver、Normal)调整;液态玻璃效果需将 SfExpander 放入 SfGlassEffectView,设置 EnableLiquidGlassEffect="True" 并使用 Background="Transparent"。
适用场景:FAQ、设置面板、分组数据、发票/收据的分段展示,以及需要动态标题/内容布局的界面。
限制:液态玻璃效果有平台与版本要求(.NET 10+、macOS 26+、iOS 26+);资料未提供收费、价格、性能指标等更多信息。