鸿蒙Harmony应用开发—ArkTS声明式开发（基础手势：Slider）

代码与思维

已于 2024-03-16 01:30:50 修改

阅读量1.7k

点赞数 25

CC 4.0 BY-SA版权

分类专栏：鸿蒙鸿蒙-ArkTS 文章标签： harmonyos 华为 ArkTS ArkUI android 鸿蒙鸿蒙系统

于 2024-03-12 21:29:23 首次发布

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

说明：

该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

无

Slider(options?: SliderOptions)

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	描述
options	SliderOptions	否	配置滑动条的参数。

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

从API version 9开始，该接口支持在ArkTS卡片中使用。

名称	描述
OutSet	滑块在滑轨上。
InSet	滑块在滑轨内。

支持除触摸热区以外的通用属性。

名称	参数类型	描述
blockColor	ResourceColor	设置滑块的颜色。从API version 9开始，该接口支持在ArkTS卡片中使用。说明：默认值：'#ffffff'。当滑块形状设置为`SliderBlockType.DEFAULT`时，`blockColor`可设置默认圆形滑块颜色；当滑块形状设置为`SliderBlockType.IMAGE`时，滑块无填充，设置`blockColor`不生效；当滑块形状设置为`SliderBlockType.SHAPE`时，`blockColor`可设置自定义形状的填充颜色。
trackColor	ResourceColor	设置滑轨的背景颜色。从API version 9开始，该接口支持在ArkTS卡片中使用。说明：默认值：'#19182431'。
selectedColor	ResourceColor	设置滑轨的已滑动部分颜色。从API version 9开始，该接口支持在ArkTS卡片中使用。说明：默认值：'#007dff'。
showSteps	boolean	设置当前是否显示步长刻度值。默认值：false 从API version 9开始，该接口支持在ArkTS卡片中使用。
showTips	value: boolean, content10+?: ResourceStr	value：设置滑动时是否显示气泡提示。默认值：false cont