syncfusion-maui-parallax-view

实现 Syncfusion® .NET MAUI Parallax View

Syncfusion .NET MAUI Parallax View（SfParallaxView）通过让背景元素以不同于前景元素的速度滚动，为应用营造富有视觉吸引力的纵深感和动感。该控件将可滚动的前景元素（Source）绑定到背景元素（Content），并以不同速度移动背景，从而营造视差效果。

何时使用此技能

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

• 创建视差滚动效果，使背景图像或视图的移动速度慢于前景内容
• 为可滚动内容增添纵深感，例如列表、文章或图片库
• 实现主视觉区域，使用视差背景打造吸引人的用户界面
• 将 ScrollView 或 ListView 与背景元素绑定，使背景元素能够响应滚动事件
• 创建支持视差效果的自定义可滚动控件，使用 IParallaxView 接口
• 打造沉浸式 UI，让动态背景动画与滚动位置关联
• 增强用户体验，在垂直或水平方向上实现平滑的视差过渡

组件概述

SfParallaxView 可创建分层滚动体验，包含：

• Content：应用视差效果移动的背景视图（Image、StackLayout 或任意视图）
• Source：前景可滚动视图（ScrollView、ListView 或自定义 IParallaxView 控件）
• Speed：可自定义的背景滚动速度（0.0 到 1.0）
• Orientation：支持垂直和水平视差滚动

背景 Content 会自动拉伸以匹配 Source 的大小，确保视觉效果自然衔接。

文档与导航指南

入门

📄 阅读： references/getting-started.md

• 安装 Syncfusion.Maui.ParallaxView NuGet 包
• 在 XAML 和 C# 中注册命名空间
• 基本的 SfParallaxView 初始化
• 使用背景视图设置 Content 属性
• 支持的内容类型（Image、StackLayout、Grid 等）
• 基本的 XAML 和 C# 实现示例

Source 绑定与集成

📄 阅读： references/source-binding.md

• 了解 Source 属性和 IParallaxView 接口
• 绑定 ScrollView 以创建基本的视差效果
• 将 Syncfusion ListView 与视差背景集成
• 包含 ViewModels 和数据绑定的完整示例
• Content 自动拉伸以匹配 Source 大小的行为
• 已知问题和解决方法（Android 图像尺寸）
• 可运行示例的 GitHub 链接

自定义选项

📄 阅读： references/customization.md

• 使用 Speed 属性控制视差滚动强度
• Speed 值及其视觉效果（0.0 = 不移动，1.0 = 速度相同）
• 使用 Orientation 属性设置垂直或水平视差
• 匹配 Source 控件的方向以实现正确效果
• XAML 和 C# 配置示例
• 实现流畅滚动的性能注意事项

自定义控件支持

📄 阅读： references/custom-controls.md

• 为自定义控件实现 IParallaxView 接口
• 用于表示内容总尺寸的 ScrollableContentSize 属性
• 搭配 ParallaxScrollingEventArgs 使用 Scrolling 事件
• ScrollX、ScrollY 和 CanAnimate 参数
• 完整的 CustomListView 实现示例
• 使用 MeasureOverride 动态计算尺寸
• 自定义可滚动控件的集成模式