自动化助手

    滑动条

    • 更新时间:2026-03-15 10:38:37

    滑动条-slider

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

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

    一、常用属性

    开始值 - 开始值

    设置开始值

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

    结束值 - 结束值

    设置结束值

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

    当前值 - 初始值

    设置初始值

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

    进步值 - 进步值

    设置进步值

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

    主题颜色 - 主题颜色

    设置主题颜色

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

    标签 - 标签文字

    设置标签文字

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

    标签尾部 - 标签文字尾部

    设置标签文字尾部

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

    内边距 - 内边距

    设置内边距

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

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

    背景颜色 - 背景颜色

    设置背景颜色

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

    背景图片 - 背景图片

    设置背景图片

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

    二、常用函数

    设置背景颜色(颜色)

    设置背景颜色

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

    设置背景颜色(颜色)

    设置背景颜色

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

    设置主题颜色(颜色)

    设置主题颜色

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

    设置主题颜色(颜色)

    设置主题颜色

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

    标签格式化(回调)

    设置标签格式化

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

    监听变化(回调)

    监听数值变化

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

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

    获取值()

    获取当前值

    • 返回 : {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);