HarmonyOS NEXT实战：滑动条

原创

中雨

发布于 2025-06-26 15:48:01

4010

文章被收录于专栏：HarmonyOS NEXT实战HarmonyOS NEXT实战

##HarmonyOS Next实战##HarmonyOS SDK应用服务##教育##

目标：实现横向和竖向滑动条

Slider滑动条组件，通常用于快速调节设置值，如音量调节、亮度调节等应用场景。

知识点：

SliderOptions对象属性

value：当前进度值。默认值：与参数min的取值一致。从API version 10开始，该参数支持$$双向绑定变量。取值范围： min, max。小于min时取min，大于max时取max。
min：设置最小值。默认值：0
max：设置最大值。默认值：100。说明：min >= max异常情况，min取默认值0，max取默认值100。value不在min, max范围之内，取min或者max，靠近min取min，靠近max取max。
step：设置Slider滑动步长。默认值：1。取值范围：0.01, max - min。说明：若设置的step值小于0或大于max值时，则按默认值显示。
style：设置Slider的滑块与滑轨显示样式。默认值：SliderStyle.OutSet
direction：设置滑动条滑动方向为水平或竖直方向。默认值：Axis.Horizontal
reverse：设置滑动条取值范围是否反向。默认值：false。值为true时，横向Slider从右往左滑动，竖向Slider从下往上滑动。值为false时，横向Slider从左往右滑动，竖向Slider从上往下滑动

组件属性

blockColor(value: ResourceColor)

设置滑块的颜色。默认值：$r('sys.color.ohos_id_color_foreground_contrary')

当滑块形状设置为SliderBlockType.DEFAULT时，blockColor可设置默认圆形滑块颜色。
当滑块形状设置为SliderBlockType.IMAGE时，滑块无填充，设置blockColor不生效。
当滑块形状设置为SliderBlockType.SHAPE时，blockColor可设置自定义形状的填充颜色。

trackColor(value: ResourceColor | LinearGradient)

设置滑轨的背景颜色。说明：设置渐变色时，若颜色断点颜色值为非法值或者渐变色断点为空时，渐变色不起效果。默认值：$r('sys.color.ohos_id_color_component_normal')。该接口中的LinearGradient类型不支持在元服务中使用。

selectedColor(value: ResourceColor)

设置滑轨的已滑动部分颜色。默认值：$r('sys.color.ohos_id_color_emphasize')

showSteps(value: boolean)

设置当前是否显示步长刻度值。值为true时显示刻度值，值为false时不显示刻度值。默认值：false

实战：SliderPage

@Entry
@Component
struct SliderPage {
  @State outSetValueOne: number = 40
  @State vInSetValueOne: number = 40

  build() {
    Column({ space: 10 }) {
      Text('Slider实战')
      Text('横向滑动条')
      Row() {
        Slider({
          value: this.outSetValueOne,
          min: 0,
          max: 100,
          style: SliderStyle.OutSet
        })
          .showTips(true)
          .onChange((value: number, mode: SliderChangeMode) => {
            this.outSetValueOne = value
            console.info('value:' + value + 'mode:' + mode.toString())
          })
        // toFixed(0)将滑动条返回值处理为整数精度
        Text(this.outSetValueOne.toFixed(0)).fontSize(12)
      }
      .width('80%')

      Text('竖向滑动条')
      Slider({
        value: this.vInSetValueOne,
        style: SliderStyle.InSet,
        direction: Axis.Vertical,
        reverse: true // 竖向的Slider默认是上端是min值，下端是max值，因此想要从下往上滑动，需要设置reverse为true
      })
        .showTips(true)
        .height(300)
        .onChange((value: number, mode: SliderChangeMode) => {
          this.vInSetValueOne = value
          console.info('value:' + value + 'mode:' + mode.toString())
        })
    }.width('100%')
  }
}

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

harmonyos

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

harmonyos

登录后参与评论

0 条评论

热度

HarmonyOS NEXT实战：滑动条

HarmonyOS NEXT实战：滑动条

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐