syncfusion-maui-popup

实现 .NET MAUI 弹出窗口

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

何时使用此指南

在以下情况下使用此指南：

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

组件概述

Syncfusion .NET MAUI Popup（SfPopup） 是一款多功能布局控件，可显示可自定义的弹出窗口，支持：

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

**Notice：**2025 年第 3 季度版本（2025 年 9 月中旬）之后，此控件将不再提供功能增强。请切换到 Syncfusion Toolkit for .NET MAUI，以继续获得支持。

文档和导航指南

入门和安装

📄 阅读： references/getting-started.md

• 安装 NuGet 包（Syncfusion.Maui.Popup）
• 在 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 模式
• 本地化支持
• 液态玻璃效果样式
• 从旧版本迁移
• 最佳实践与模式