鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之Slider组件
一、操作环境
操作系统: Windows 10 专业版、IDE:DevEco Studio 3.1、SDK:HarmonyOS 3.1+
二、Slider组件
滑动条组件,通常用于快速调节设置值,如音量调节、亮度调节等应用场景。
子组件
无。
接口
Slider(options?: {value?: number, min?: number, max?: number, step?: number, style?: SliderStyle, direction?: Axis, reverse?: boolean})
从API version 9开始,该接口支持在ArkTS卡片中使用。
参数
参数名 |
参数类型 |
必填 |
参数描述 |
---|---|---|---|
value |
number |
否 |
当前进度值。 默认值:参数min |
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.Horizontal |
|
reverse8+ |
boolean |
否 |
设置滑动条取值范围是否反向,横向Slider默认为从左往右滑动,竖向Slider默认为从上往下滑动。 默认值:false |