syncfusion-maui-rotator

实现 .NET MAUI Rotator

Syncfusion .NET MAUI Rotator（SfRotator）是一种用于显示和浏览图像内容的数据控件。它支持缩略图和圆点导航模式、自动播放功能、循环播放以及丰富的自定义选项。

何时使用此技能

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

• 在 .NET MAUI 应用程序中实现图像轮播或幻灯片
• 创建支持缩略图或圆点导航的产品图库
• 构建推荐语滑块或促销横幅
• 显示自动切换的轮播内容
• 创建支持滑动导航的图像查看器
• 实现带自定义导航控件的内容轮播
• 构建支持水平和垂直导航的图库
• 创建具有自定义切换时间和循环播放行为的幻灯片

组件概览

SfRotator 控件提供：

• 多种导航模式： 缩略图（图像预览）和圆点（指示器）
• 数据绑定： 支持 IList、ObservableCollection 和 SfRotatorItem 集合
• 自动播放和循环播放： 自动切换，支持配置延迟时间和无限循环
• 方向导航： 支持六种导航方向，包括水平、垂直和单向模式
• 丰富的自定义选项： 自定义颜色、描边、模板和导航按钮样式
• 交互控件： 滑动手势、导航按钮和通过代码选择索引
• 事件处理： SelectedIndexChanged 事件，用于响应导航操作

文档和导航指南

入门

📄 阅读： references/getting-started.md

• 安装 Syncfusion.Maui.Rotator NuGet 包
• 注册处理程序（ConfigureSyncfusionCore）
• 基本的 XAML 和 C# 实现
• 使用图像的首个可运行示例

数据和内容

📄 阅读： references/populating-data.md

• 创建数据模型和 ViewModel
• 将 ItemsSource 绑定到集合（IList、ObservableCollection）
• 使用 DataTemplate 配置 ItemTemplate
• 在简单场景中使用 SfRotatorItem
• 从 URL 加载在线图像

导航模式和样式

📄 阅读： references/navigation-modes.md

• NavigationStripMode（Thumbnail、Dots）
• 自定义圆点（描边、选中/未选中颜色）
• 自定义缩略图（描边颜色）
• 设置导航按钮样式（图标颜色、背景）
• 显示/隐藏导航按钮
• DotPlacement 选项（Default、None、Outside）

位置和方向

📄 阅读： references/placement-and-direction.md

• NavigationStripPosition（Top、Bottom、Left、Right）
• NavigationDirection（Horizontal、Vertical、LeftToRight、RightToLeft、TopToBottom、BottomToTop）
• 组合使用位置和方向
• 布局最佳实践

自动播放和用户交互

📄 阅读： references/autoplay-and-interaction.md

• 使用 EnableAutoPlay 自动切换
• 配置 NavigationDelay 延迟时间
• 使用 EnableLooping 无限滚动
• 使用 EnableSwiping 控制用户交互
• 使用 SelectedIndex 进行代码导航

高级自定义

📄 阅读： references/customization.md

• 使用 DataTemplateSelector 选择动态模板
• 使用 IsTextVisible 显示文本面板
• 自定义布局和样式
• 背景颜色和尺寸设置
• 高级模板场景

事件和迁移

📄 阅读： references/events.md

• 处理 SelectedIndexChanged 事件
• 响应导航更改
• XAML 和 C# 中的事件模式
• API 更改和重大变更