openharmony 鸿蒙 js-components-basic-slider

2025-06-12 浏览 (1)

slider

说明:

从API version 4开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

滑动条组件,用来快速调节设置值,如音量、亮度等。

子组件

不支持。

属性

除支持通用属性外,还支持以下属性:

名称类型默认值必填描述
minnumber0滑动选择器的最小值。
maxnumber100滑动选择器的最大值。
stepnumber1每次滑动的步长。
valuenumber0滑动选择器的初始值。
mode5+stringoutset滑动条样式:
- outset:滑块在滑杆上;
- inset:滑块在滑杆内。
showsteps5+booleanfalse是否显示步长标识。true表示显示步长标识,false表示不显示步长标识。
showtips5+booleanfalse滑动时是否有气泡提示百分比。true表示有气泡提示百分比,false表示没有气泡提示百分比。

样式

除支持通用样式外,还支持如下样式:

名称类型默认值必填描述
color<color>#19000000滑动条的背景颜色。
selected-color<color>#ff007dff滑动条的已选择颜色。
block-color<color>#ffffff滑动条的滑块颜色。

事件

除支持通用事件外,还支持如下事件:

名称参数描述
changeChangeEvent选择值发生变化时触发该事件。

表1 ChangeEvent

属性类型说明
value5+number当前slider的进度值。
mode5+string当前change事件的类型,可选值为:
- start:slider的值开始改变。
- move:slider的值跟随手指拖动中。
- end:slider的值结束改变。
- click:slider的值在点击进度条后改变。

示例

<!-- xxx.hml -->
<div class="container">
    <slider min="0" max="100" value="{{ value }}" mode="outset" showtips="true"></slider>
    <slider class="" min="0" max="100" value="{{ value }}" step="20" mode="inset"  showtips="true"></slider>
    <slider class="" min="0" max="100" value="{{ value }}" showsteps="true" step="20" mode="inset"  showtips="false"></slider>
</div>
/* xxx.css */
.container {
    flex-direction: column;
    justify-content: center;
    align-items: center;
}
slider{
    margin-top: 100px;
}

zh-cn_image_0000001173324709

你可能感兴趣的鸿蒙文章

harmony 鸿蒙兼容JS的类Web开发范式(ArkUI.Full)

harmony 鸿蒙数据类型说明

harmony 鸿蒙button

harmony 鸿蒙chart

harmony 鸿蒙divider

harmony 鸿蒙image-animator

harmony 鸿蒙image

harmony 鸿蒙input

harmony 鸿蒙label

harmony 鸿蒙marquee

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/DyYvJn