用途
Bottom Sheet(底部工作表)是一种从屏幕底部向上滑出的用户界面组件,允许用户在不离开主界面的情况下与附加信息或操作进行交互。Syncfusion SfBottomSheet 控件为 .NET MAUI 应用提供状态管理、内容配置、手势支持和丰富的自定义选项。
该技能适用于以下场景:
- 无需整页导航即可显示补充内容(产品详情、信息面板、设置)。
- 创建数据驱动的交互,将列表选择绑定到详细内容视图。
- 实现覆盖主内容的模态对话框或确认工作表。
- 提供部分揭示模式,让用户逐步展开内容(peek-a-boo 效果)。
- 支持基于手势的界面,用户通过滑动来显示更多信息。
- 自定义外观以匹配应用主题(颜色、尺寸、圆角、动画)。
- 以程序化方式或通过用户交互处理状态转换。
- 在移动优先应用中管理焦点与覆盖层行为。
主要能力
- 多种状态:FullExpanded、HalfExpanded、Collapsed、Hidden。
- 灵活的内容配置,支持数据绑定。
- 触摸手势:滑动以展开/收起。
- 丰富的自定义:颜色、尺寸、圆角、内边距、抓取条样式。
- 事件处理与状态变更通知。
- 模态与非模态显示模式。
- 通过 IsOpen 属性及 Show/Close 方法进行程序化控制。
使用方式
该技能按主题组织为多个参考文档,可按需查阅:
- 入门:references/getting-started.md —— 项目设置与模板创建、NuGet 包安装(Syncfusion.Maui.Toolkit)、在 MauiProgram.cs 中注册 Handler、基本控件初始化、结合 ListView 的首个可用示例。
- 内容配置:references/content-configuration.md —— 设置主内容与底部工作表内容、使用 ViewModel 进行数据绑定、布局模式(VerticalStackLayout、Grid、ListView)、动态内容更新、绑定上下文管理。
- 状态与状态管理:references/states-management.md —— State 属性值与转换、AllowedState 配置(FullExpanded、HalfExpanded、All)、用于程序化控制的 IsOpen 属性、状态变更场景与用例。
- 自定义与样式:references/customization-styling.md —— 弹出模式(IsModal)与覆盖层行为、背景色与圆角、高度调整(FullExpandedRatio、HalfExpandedRatio、CollapsedHeight)、宽度模式(Full、Custom)、内容内边距与间距、抓取条元素自定义、动画时长配置。
- 手势、事件与方法:references/gestures-events-methods.md —— 滑动手势支持(EnableSwiping)、StateChanged 事件处理、用于覆盖层交互的 CollapseOnOverlayTap、用于程序化控制的 Show/Close 方法、事件参数检查。
- 常见模式与真实场景:references/common-patterns.md —— 带列表选择的数据驱动 Bottom Sheet、模态对话框与确认工作表、部分揭示与 peek 模式、动态内容绑定、错误处理与边界情况、最佳实践与反模式。
适用场景
适合移动优先的 .NET MAUI 应用,用于展示产品详情、信息面板、设置项、确认弹窗,或实现列表选择联动详情、部分揭示等交互模式。
限制
资料未提供关于收费、价格、平台兼容范围、性能指标或具体版本要求的信息,暂未提供。