本文是华为开发者文档中关于 Slider(滑动条组件)的介绍,主要涵盖了组件概述、接口、属性、事件、示例等内容,适用于在 HarmonyOS 应用开发中使用 Slider 组件的开发者。

  1. 组件概述
  • 用途:常用于快速调节设置值,如音量、亮度调节等场景。
  • 支持版本:从 API Version 7 开始支持,部分功能在后续版本中陆续添加。
  1. 接口
  • 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。
  1. 属性
  • 支持通用属性(除触摸热区外)
  • 特定属性
  • 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:设置有效滑动区间。
  1. 事件
  • onChange:拖动或点击滑块时触发,返回当前进度值和事件触发状态。
  1. 示例
  • 滑动条基础样式:展示了不同样式(如 OutSet、InSet、NONE)的滑动条,以及水平和垂直方向的滑动条,同时演示了如何显示气泡提示、刻度值和处理滑动事件。
  • 设置滑动条样式:通过各种属性设置滑块、刻度、滑轨等的样式,如滑块边框颜色、大小、形状,刻度颜色、大小,滑轨圆角半径等。
  • 自定义滑动条:实现了通过样式 Builder 定制内容区,包括增加按钮、减少按钮来控制进度条,同时展示了进度条状态和相关数值。