syncfusion-maui-radial-menu

在 .NET MAUI 中实现径向菜单

Syncfusion .NET MAUI 径向菜单（SfRadialMenu）以圆形布局显示分层菜单，针对支持触控的设备进行了优化。它通常用作上下文菜单，在相同空间内可显示比传统菜单更多的菜单项。

何时使用此技能

当用户需要执行以下操作时，请使用此技能：

• 在 .NET MAUI 应用程序中实现圆形／径向菜单
• 创建支持分层导航的触控优化型上下文菜单
• 构建可在屏幕上拖动的浮动菜单
• 设计包含多个层级菜单项的嵌套菜单系统
• 使用文本、图标或自定义视图自定义中心按钮
• 通过自定义定位和索引划分菜单布局
• 添加带图像、图标或自定义内容的交互式菜单项
• 处理菜单的导航、打开／关闭和菜单项点击事件
• 实现液态玻璃／亚克力样式等现代 UI 效果

组件概览

主要功能：

• 分层导航： 支持多级嵌套菜单项
• 触控优化： 采用专为触控交互设计的圆形布局
• 可拖动： 浮于内容之上，可拖动到屏幕任意位置
• 支持旋转： 菜单项可围绕中心旋转
• 自定义分区： 控制菜单项的位置和间距
• 字体图标： 内置矢量图标支持
• 自定义视图： 使用任意 MAUI 视图作为菜单项内容
• 丰富的自定义选项： 颜色、大小、字体、背景等
• 事件驱动： 为所有交互提供全面的事件系统

文档与导航指南

入门

📄 阅读： references/getting-started.md

• NuGet 包安装（Syncfusion.Maui.RadialMenu）
• 在 MauiProgram.cs 中注册处理程序
• 基本的 SfRadialMenu 设置
• 创建包含菜单项的第一个径向菜单
• XAML 和 C# 实现示例

填充菜单项

📄 阅读： references/populating-items.md

• 通过 RadialMenuItem 集合添加菜单项
• 仅含文本的菜单项、带文本的图像、自定义字体图标
• 创建嵌套／分层菜单结构
• 使用 ItemsSource 和 ItemTemplate 进行数据绑定
• 动画时长、边缘样式、分隔符
• 用于属性绑定的 DisplayMemberPath

自定义中心按钮

📄 阅读： references/center-button-customization.md

• 中心按钮文本和返回按钮文本
• 颜色（文本、背景、描边）
• 大小和半径自定义
• 字体系列、大小和属性
• 中心按钮的自定义视图
• 动画和自动缩放
• 起始角度配置

自定义菜单项

📄 阅读： references/menu-item-customization.md

• SfRadialMenuItem 属性
• 文本、图像和字体图标
• 字体自定义（系列、大小、属性）
• 颜色（背景、文本）
• 大小（ItemHeight、ItemWidth）
• 菜单项的自定义视图
• 命令绑定
• 启用／禁用状态

布局与分区

📄 阅读： references/layout-segmentation.md

• 默认布局（顺序排列）
• 自定义布局（按索引定位）
• VisibleSegmentsCount 属性
• 用于精确定位的 SegmentIndex
• 不同布局类型的适用场景

拖动与旋转

📄 阅读： references/dragging-rotation.md

• 启用拖动功能（IsDragEnabled）
• 旋转控制（EnableRotation）
• 拖动事件（DragBegin）
• 限制拖动行为
• 在父布局中定位菜单

事件

📄 阅读： references/events.md

• 导航事件（Navigating、Navigated）
• 打开／关闭事件
• 中心按钮事件（CenterButtonBackTapped）
• 菜单项交互事件（ItemTapped、TouchDown、TouchUP）
• 事件参数与取消