syncfusion-maui-toolkit-popup

实现 .NET MAUI 弹出窗口

全面介绍如何实现 Syncfusion .NET MAUI Popup (SfPopup) 控件，以显示警告消息、自定义视图和模态对话框，并提供丰富的位置和自定义选项。

何时使用此技能

在以下情况下使用此技能：

• 在 .NET MAUI 应用中显示警告消息、确认信息或通知
• 显示需要用户交互的模态对话框
• 创建带有自定义页眉、页脚和内容的弹出窗口
• 将弹出窗口放置在特定位置（居中、绝对位置、相对于视图）
• 显示信息叠加层，而无需导航到新页面
• 实现工具提示、上下文菜单或弹出内容
• 显示加载指示器或进度对话框
• 创建全屏模态体验
• 在弹出窗口中显示自定义视图（ListView、DataGrid、表单）
• 通过按钮回调处理用户的接受或拒绝操作

组件概览

Syncfusion .NET MAUI Popup (SfPopup) 是一款多用途布局控件，可显示可自定义的弹出窗口，具有以下功能：

• 灵活定位：居中、绝对坐标、相对于任意视图或全屏
• 可自定义布局：支持模板和自定义样式的页眉、主体和页脚。
• 外观模式：单按钮或双按钮页脚布局
• 模态支持：阻止与背景交互，直到弹出窗口关闭
• 动画：内置缩放、淡入淡出和滑动动画
• 自动调整大小：根据内容尺寸自动调整
• MVVM 支持：全面支持数据绑定和命令

文档与导航指南

入门与安装

📄 阅读： references/getting-started.md

• NuGet 包安装（Syncfusion.Maui.Toolkit）
• 在 MauiProgram.cs 中注册处理程序
• 基本弹出窗口初始化（XAML 和 C#）
• 显示和关闭弹出窗口
• 实现第一个弹出窗口
• 原生嵌入（Android/iOS）

定位选项

📄 阅读： references/positioning.md

• 使用 IsOpen 或 Show() 居中定位
• 在 x、y 坐标处进行绝对定位
• 相对于任意视图进行定位
• 带偏移量的绝对相对定位
• 全屏模式
• MVVM 定位模式
• 按时长自动关闭
• 定位在操作栏上方
• 使用 ShowAsync() 返回结果

布局自定义

📄 阅读： references/layout-customization.md

• 外观模式（OneButton、TwoButton）
• 显示/隐藏页眉、页脚、关闭按钮
• 自定义页眉模板
• 自定义页脚模板
• 自定义内容模板
• 页眉和页脚高度
• 自定义按钮文本
• Message 属性
• 禁用叠加层背景

尺寸与动画

📄 阅读： references/sizing-and-animations.md

• 配置宽度和高度
• 自动调整大小模式（Height、Width、Both、None）
• 全屏弹出窗口模式
• 动画类型（Zoom、Fade、SlideOnLeft、SlideOnRight、SlideOnTop、SlideOnBottom）
• 动画时长和缓动
• 自定义动画效果

事件与模态行为

📄 阅读： references/events-and-modal.md

• 弹出窗口生命周期事件（Opening、Opened、Closing、Closed）
• 事件参数和取消操作
• 模态模式配置
• 叠加层交互设置
• 点击叠加层时关闭的行为
• 接受和拒绝按钮事件

样式与外观

📄 阅读： references/styling-and-appearance.md

何时阅读： 通过设置页眉、页脚和消息的样式来自定义弹出窗口的视觉外观。自定义叠加层和描边。

涵盖内容：

• 页眉样式
• 页脚样式
• 消息/内容样式
• 边框自定义
• 叠加层背景样式
• 模糊效果
• 背景样式
• 阴影效果
• 样式示例

---

高级集成与示例

📄 阅读：references/advanced-integration.md

• 在弹出窗口中显示 ListView
• DataGrid 单元格点击集成
• Switch 控件绑定示例
• 使用命令实现 MVVM 模式
• 本地化支持
• 从旧版本迁移
• 最佳实践与模式