自动化助手

    滑动条

    • 更新时间:2026-06-15 07:53:04

    滑动条-slider

    原生类型:{com.google.android.material.slider.Slider}

    滚动条：常用于动态设置数字参数，通过滑动就可以变换数值。

    一、常用属性

    开始值 - 开始值

    设置开始值

    <滑动条 开始值="0" />

    结束值 - 结束值

    设置结束值

    <滑动条 结束值="100" />

    当前值 - 初始值

    设置初始值

    <滑动条 当前值="30" />

    进步值 - 进步值

    设置进步值

    <滑动条 进步值="1" />

    主题颜色 - 主题颜色

    设置主题颜色

    <滑动条 主题颜色="#FF0000" />

    标签 - 标签文字

    设置标签文字

    <滑动条 标签="进度:" />

    标签尾部 - 标签文字尾部

    设置标签文字尾部

    <滑动条 标签尾部="个" />

    内边距 - 内边距

    设置内边距

    参数顺序:左,上,右,下(单位:dp)

    <滑动条 内边距="20,20,20,20" />

    背景颜色 - 背景颜色

    设置背景颜色

    <滑动条 背景颜色="#1E1F22" />

    背景图片 - 背景图片

    设置背景图片

    <滑动条 背景图片="./资源/图片.png" />

    存储关键字 - 应用内存储

    应用内存储

    通过storeKey(存储关键字)指定一个存储整数的关键字，获取值时可以直接通过$storage($存储)获取进度值。

    注意：不同的控件存储的类型不同，对于本控件(进度条)则存储的是整数类型，表达当前进度值

    <!-- 你必须在ui(界面)节点中通过store(存储)指定$storage($存储)的命名空间，等价于使用代码：let storage = $storage.create("MySlider"); -->
<界面 存储="MySlider">
    <状态栏 />
    <!-- 使用storeKey(存储关键字)属性，指定关键字，等价于使用代码：let data = $storage.create("MySlider").getFloat("进度"); -->
    <!-- 使用storeDef(存储默认值)属性，指定关键字，等价于使用代码：let data = $storage.create("MySlider").getFloat("进度",50); -->
    <滑动条 存储关键字="进度" 存储默认值="50" />
</界面>

    如果我们已经配置好了应用内存储，则可以直接获取数据：

    注意：一、要使用应用内存储，必须在ui(界面)节点指定属性store(存储)的值，该值指定存储的命名空间； 二、不是所有的控件都支持应用内存储； 三、不同的控件存储的数据类型可能都不一致，例如：输入类型的控件存储的是字符串类型，开关、多选框存储的就是布尔类型的数据。

    //创建(或者加载)存储对象
let storage = $storage.create("MySlider");//名称要一致
//获取数据
let data = storage.getFloat("progress",50);//数据类型是小数

    二、常用函数

    设置背景颜色(颜色)

    设置背景颜色

    • 参数 : 颜色 {数字} 文本颜色值
    • 版本 : 1.8.2
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滚动条 = 界面.找控件("我的滚动条");
//设置背景颜色
滚动条.设置背景颜色($颜色.红色);

    设置背景颜色(颜色)

    设置背景颜色

    • 参数 : 颜色 {字符串} 颜色字符串
    • 版本 : 1.8.2
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滚动条 = 界面.找控件("我的滚动条");
//设置背景颜色
滚动条.设置背景颜色("#1E1F22");

    设置主题颜色(颜色)

    设置主题颜色

    • 参数 : 颜色 {数字} 文本颜色值
    • 版本 : 1.8.2
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滚动条 = 界面.找控件("我的滚动条");
//设置主题颜色
滚动条.设置主题颜色($颜色.红色);

    设置主题颜色(颜色)

    设置主题颜色

    • 参数 : 颜色 {字符串} 颜色字符串
    • 版本 : 1.8.2
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滚动条 = 界面.找控件("我的滚动条");
//设置主题颜色
滚动条.设置主题颜色("#1E1F22");

    标签格式化(回调)

    设置标签格式化

    • 参数 : 回调 {(浮点值)=>{ return "标签"; }} 格式化回调

    监听变化(回调)

    监听数值变化

    注意:只监听由用户手动触发的数值变化,若为编程时设置的数值,则忽略

    • 参数 : 回调 {(数值)=>{}}
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//监听数值变化
滑动条.监听变化((数值)=>{
    //..
});
//取消监听 滑动条.监听变化(null);

    获取值()

    获取当前值

    • 返回 : {float} 当前数值
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//获得当前值
定义 当前值 = 滑动条.获取值();

    设置值(数值)

    设置当前值

    • 参数 : 数值 {float} 当前值
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//设置当前值
滑动条.设置值(10);

    设置开始值(开始值)

    设置开始值

    • 参数 : 开始值 {float} 开始值
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//设置开始值
滑动条.设置开始值(0);

    设置进步值(进步值)

    设置进步值

    • 参数 : 进步值 {float} 进步值
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//设置进步值
滑动条.设置进步值(1);

    设置结束值(结束值)

    设置结束值

    • 参数 : 结束值 {float} 结束值
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//设置结束值
滑动条.设置结束值(100);

    设置数据(开始, 结束)

    设置数据

    • 参数 : 开始 {float} 开始值
    • 参数 : 结束 {float} 结束值
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//设置数据(开始,结束)
滑动条.设置数据(0,100);

    设置数据(开始, 结束, 当前值)

    设置数据

    • 参数 : 开始 {float} 开始值
    • 参数 : 结束 {float} 结束值
    • 参数 : 当前值 {float} 当前值
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//设置数据(开始,结束,当前值)
滑动条.设置数据(0,100,20);

    监听触摸开始(回调)

    监听触摸开始

    用户用手指滑动时，当触摸开始时回调。若要取消监听，则设置为null即可。

    • 参数 : 回调 {()=>{}} 回调
    • 版本 : 1.9.5
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//监听触摸开始
滑动条.监听触摸开始(()=>{
    //..
});

    监听触摸结束(回调)

    监听触摸结束

    用户用手指滑动时，当触摸结束时回调。若要取消监听，则设置为null即可。

    • 参数 : 回调 {()=>{}} 回调
    • 版本 : 1.9.5
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//监听触摸结束
滑动条.监听触摸结束(()=>{
    //..
});