Syncfusion WinUI Slider(SfSlider)是一个高度交互的 UI 控件,用于让用户从一段数值范围中选择单一数值,适用于 WinUI 3 桌面应用。
用途
当你需要以下场景时,可使用该技能:
- 允许用户从某一区间中选择单个数值
- 提供交互式方式调节数值(如音量、亮度、价格区间等)
- 通过标签、刻度、工具提示等提供数值选择的视觉反馈
- 创建外观与行为可自定义的滑块控件
- 实现用于筛选或配置的范围选择器
- 构建带可调数值参数的设置面板
- 为测量、评分或打分添加交互式控件
主要能力
控件提供以下特性:
- 数值支持:可在任意数值区间内选择值
- 标签:以可自定义样式显示格式化数值
- 刻度:按间隔显示主刻度与次刻度
- 分隔线:在间隔之间提供视觉分隔
- 拇指自定义:内置图标与自定义样式
- 工具提示:以自定义格式显示所选值
- 轨道样式:可自定义激活与未激活轨道外观
- 方向:支持水平或垂直布局
- 无障碍:支持完整键盘与屏幕阅读器
关键属性包括 Value、Minimum(默认 0)、Maximum(默认 100)、Interval、ShowLabels(默认 false)、ShowTicks(默认 false)、ShowDividers(默认 false)、ShowToolTip(默认 false)、Orientation(默认 Horizontal)、IsInversed(默认 false)、MinorTicksPerInterval(默认 0)、ActiveTrackHeight、InactiveTrackHeight、DividerHeight、DividerWidth。关键事件为 ValueChanged,在滑块值变化时触发。
使用方式
基础实现需在 XAML 中添加命名空间 xmlns:slider="using:Syncfusion.UI.Xaml.Sliders",并设置 Value、Minimum、Maximum、Width、Margin 等属性。也可在代码后台创建 SfSlider 实例并设置属性、订阅 ValueChanged 事件。
常用模式包括:音量控制(通过 TwoWay 绑定 Volume,显示标签、刻度、工具提示)、价格范围筛选(绑定 MaxPrice)、垂直滑块(设置 Orientation="Vertical")、禁用状态(IsEnabled="False")。
文档结构包含以下参考章节:入门(创建 WinUI 3 应用、安装 Syncfusion.Sliders.WinUI NuGet、导入命名空间、基础初始化、设置最小/最大/当前值、启用刻度/标签/分隔线)、核心功能与配置(数值范围、方向、数据绑定、间隔与步进频率、IsEnabled 与 IsInversed、ValueChanged 事件)、标签(ShowLabels、位置、格式字符串、LabelStyle、LabelOffset、自定义模板、RTL)、刻度(ShowTicks、MinorTicksPerInterval、位置与偏移、样式、TickPlacement、自定义模板)、分隔线(ShowDividers、高度与宽度、样式、自定义模板)、拇指与工具提示(拇指图标与样式、叠加效果、ShowToolTip、位置、TooltipFormat、自定义模板)、轨道自定义(激活/未激活高度与样式、颜色、渐变、自定义模板、圆角)。
适用场景
音频/视频控制、筛选滑块(价格、年龄、评分)、设置面板、图像编辑(亮度、对比度、饱和度)、测量工具(温度、压力、比例)、评分系统、进度指示器、缩放控制。
限制
资料未提供控件的具体收费方式、价格或许可信息。使用该控件需安装 Syncfusion.Sliders.WinUI NuGet 包,并创建 WinUI 3 桌面应用。若滑块未显示、值不更新、标签/刻度不可见或工具提示不出现,资料给出了对应的排查建议,如检查 NuGet 安装、命名空间导入、设置 TwoWay 绑定、启用 IsEnabled、定义 Interval、设置 ShowToolTip 等。