本文是华为开发者文档中关于 Slider(滑动条组件)的介绍,主要涵盖了组件概述、接口、属性、事件、示例等内容,适用于在 HarmonyOS 应用开发中使用 Slider 组件的开发者。
- 组件概述
- 用途:常用于快速调节设置值,如音量、亮度调节等场景。
- 支持版本:从 API Version 7 开始支持,部分功能在后续版本中陆续添加。
- 接口
- Slider(options?: SliderOptions):用于创建滑动条组件,可在 ArkTS 卡片(API version 9 起)和元服务(API version 11 起)中使用。
- SliderOptions 参数说明
- value:当前进度值,默认与 min 取值一致,从 API version 10 开始支持双向绑定变量。
- min:设置最小值,默认值为 0。
- max:设置最大值,默认值为 100,min >= max 时取默认值。
- step:滑动步长,默认值为 1,取值范围为 [0.01, max - min]。
- style:滑块与滑轨显示样式,默认值为 SliderStyle.OutSet。
- direction:滑动方向,默认值为 Axis.Horizontal(水平)。
- reverse:取值范围是否反向,默认值为 false。
- 属性
- 支持通用属性(除触摸热区外)
- 特定属性
- blockColor:设置滑块颜色,根据滑块形状不同有不同效果。
- trackColor:设置滑轨背景颜色,从 API version 12 开始支持渐变色。
- selectedColor:设置滑轨已滑动部分颜色。
- showSteps:是否显示步长刻度值。
- showTips:是否显示气泡提示及设置提示内容。
- trackThickness:设置滑轨粗细,会影响滑块大小。
- blockBorderColor:设置滑块描边颜色(特定滑块形状有效)。
- blockBorderWidth:设置滑块描边粗细(特定滑块形状有效)。
- stepColor:设置刻度颜色。
- trackBorderRadius:设置底板圆角半径。
- selectedBorderRadius:设置已滑动部分圆角半径。
- blockSize:设置滑块大小,根据滑块形状不同有不同作用。
- blockStyle:设置滑块形状参数。
- stepSize:设置刻度大小。
- minLabel/deprecated:已废弃,使用 min 替代。
- maxLabel/deprecated:已废弃,使用 max 替代。
- sliderInteractionMode:设置用户与滑动条组件交互方式。
- minResponsiveDistance:设置滑动响应的最小距离。
- contentModifier:定制 Slider 内容区的方法。
- slideRange:设置有效滑动区间。
- 事件
- onChange:拖动或点击滑块时触发,返回当前进度值和事件触发状态。
- 示例
- 滑动条基础样式:展示了不同样式(如 OutSet、InSet、NONE)的滑动条,以及水平和垂直方向的滑动条,同时演示了如何显示气泡提示、刻度值和处理滑动事件。
- 设置滑动条样式:通过各种属性设置滑块、刻度、滑轨等的样式,如滑块边框颜色、大小、形状,刻度颜色、大小,滑轨圆角半径等。
- 自定义滑动条:实现了通过样式 Builder 定制内容区,包括增加按钮、减少按钮来控制进度条,同时展示了进度条状态和相关数值。