syncfusion-maui-slider

实现 .NET MAUI 滑块

Syncfusion .NET MAUI Slider（SfSlider）是一种高度交互的 UI 控件，可让用户从定义的范围中选择单个值。它提供丰富的自定义功能，包括轨道样式、标签、刻度线、分隔符和工具提示，帮助开发者打造直观且视觉效果出色的滑块体验。

何时使用此技能

在用户需要以下功能时使用此技能：

• 在 .NET MAUI 应用程序中实现数值滑块控件
• 允许用户从某个范围中选择单个值（例如音量、亮度、价格）
• 配置滑块轨道、滑块拇指、标签、刻度线、分隔符或工具提示
• 通过事件或命令处理滑块值变化
• 创建带步长值的离散滑块
• 使用颜色、尺寸和样式自定义滑块外观
• 启用延迟更新或液态玻璃效果等高级功能
• 从 Xamarin.Forms RangeSlider 迁移到 .NET MAUI Slider
• 实现水平和垂直方向的滑块

Syncfusion .NET MAUI Slider（SfSlider）是一种高度交互的 UI 控件，用于从某个范围中选择单个数值，提供丰富的功能，包括可自定义的轨道、标签、刻度线、分隔符、工具提示和响应式交互。

组件概述

SfSlider 是 .NET MAUI 的数值滑块控件，用户可沿轨道拖动滑块拇指来选择单个值。它提供：

• 数值支持：从数值范围中选择值，并可配置最小值和最大值
• 视觉元素：轨道、滑块拇指、覆盖层、标签、刻度线、分隔符和工具提示
• 方向：支持水平和垂直布局
• 交互：流畅的拖动体验，并提供用于处理值变化的事件和命令
• 离散模式：按指定步长选择值
• 自定义：为所有视觉组件提供丰富的样式选项
• 高级功能：延迟更新、液态玻璃效果和 Visual State Manager 支持

文档和导航指南

入门

📄 阅读： references/getting-started.md

• 安装 Syncfusion.Maui.Sliders NuGet 包
• 使用 ConfigureSyncfusionCore 注册处理程序
• 在 XAML 和 C# 中创建基本滑块
• 为 Visual Studio、VS Code 和 JetBrains Rider 进行设置
• 方向（水平/垂直）
• 用于反向滑块的 IsInversed 属性

轨道和值配置

📄 阅读： references/track-and-values.md

• Minimum 和 Maximum 属性
• Value 属性和数据绑定
• 使用 TrackStyle 自定义轨道
• ActiveFill 和 InactiveFill 颜色
• 用于设置轨道粗细的 ActiveSize 和 InactiveSize
• 轨道高度和自定义样式

标签和格式设置

📄 阅读： references/labels-and-formatting.md

• 用于显示标签的 ShowLabels 属性
• 间隔配置（手动和自动）
• 用于设置标签格式的 NumberFormat（前缀/后缀）
• 用于自定义标签文本的 LabelCreated 事件
• SliderLabelCreatedEventArgs（Text、Style 属性）
• 标签样式（颜色、字体、字体系列、偏移量）

刻度线和分隔符

📄 阅读： references/ticks-and-dividers.md

• 用于显示主刻度线的 ShowTicks 属性
• MinorTicksPerInterval 用于设置次刻度线
• 刻度线尺寸、长度和样式
• 用于显示轨道标记的 ShowDividers 属性
• 分隔符半径、填充和描边自定义
• ActiveRadius、InactiveRadius、ActiveFill、InactiveFill
• ActiveStroke、InactiveStroke、ActiveStrokeThickness、InactiveStrokeThickness
• 用于禁用分隔符的 Visual State Manager

工具提示

📄 阅读： references/tooltip.md

• 使用 SliderTooltip 启用工具提示
• 使用 ShowAlways 属性显示常驻工具提示
• 使用 Tooltip.NumberFormat 格式化数值
• 使用 TooltipLabelCreated 事件自定义工具提示文本
• SliderTooltipLabelCreatedEventArgs（Text、TextColor、FontSize、FontFamily、FontAttributes）
• 工具提示的位置和样式

滑块、选区和叠加层

📄 阅读： references/thumb-selection-overlay.md

• 使用 ThumbStyle 自定义滑块
• 滑块半径、填充、描边和描边粗细
• 使用 ThumbOverlayStyle 设置 ThumbOverlay 属性
• 叠加层半径和颜色配置
• 选区轨道样式
• 使用 Visual State Manager 设置禁用滑块状态
• 完整样式示例

事件、命令和交互

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

• ValueChangeStart 事件（按下滑块）
• 拖动期间触发的 ValueChanging 事件及 SliderValueChangingEventArgs
• 拖动完成时触发的 ValueChanged 事件及 SliderValueChangedEventArgs
• ValueChangeEnd 事件（松开滑块）
• DragStartedCommand 和 DragStartedCommandParameter
• DragCompletedCommand 和 DragCompletedCommandParameter
• 使用 ViewModel 和 ICommand 绑定命令
• 事件处理程序模式

高级功能和迁移

📄 阅读： references/advanced-features.md

• 使用 StepSize 离散选择数值
• EnableDeferredUpdate 和 DeferredUpdateDelay
• 使用 IsEnabled 属性设置禁用状态
• EnableLiquidGlassEffect（面向 .NET 10+ 的现代半透明设计）
• LiquidGlass 的前提条件（iOS 26、macOS 26）
• 使用 Visual State Manager（VSM）根据状态设置样式
• 自定义主题和样式模式
• 从 Xamarin.Forms SfRangeSlider 迁移
• 属性映射（Xamarin → MAUI）