滑块文档 - layui.slider

作为一个拖拽式的交互性组件,滑块往往能给产品带来更好的操作体验。layui 深以为然,slider 模块包含了你能想到的大部分功能,尽管它可以作为一个独立的个体,但很多时候它往往会出现 form 元素中,想象一下吧。
模块加载名称:slider

注意:slider 为 layui 2.4.0 新增模块

使用

通过对 slider 模块的使用,你可以在页面构建出可拖动的滑动元素,如下是一个最基本的用法:

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>滑块</title>
  <link rel="stylesheet" href="../src/css/layui.css">
</head>
<body>
<div id="slideTest1"></div>
<script src="../src/layui.js"></script>
<script>
layui.use('slider', function(){
  var slider = layui.slider;
  
  //渲染
  slider.render({
    elem: '#slideTest1'  //绑定元素
  });
});
</script>
</body>
</html>
      
基础参数

slider 组件支持以下参数

参数选项 说明 类型 默认值
elem 指向容器选择器 string/object -
type 滑块类型,可选值有:default(水平滑块)、vertical(垂直滑块) string default
min 滑动条最小值,正整数,默认为 0 number 0
max 滑动条最大值 number 100
range 是否开启滑块的范围拖拽,若设为 true,则滑块将出现两个可拖拽的环 boolean false
value 滑块初始值,默认为数字,若开启了滑块为范围拖拽(即 range: true),则需赋值数组,异表示开始和结尾的区间,如:value: [30, 60] number/Array 0
step 拖动的步长 number 1
showstep 是否显示间断点 boolean false
tips 是否显示文字提示 boolean true
input 是否显示输入框(注意:若 range 参数为 true 则强制无效)
点击输入框的上下按钮,以及输入任意数字后回车或失去焦点,均可动态改变滑块
boolean false
height 滑动条高度,需配合 type:"vertical" 参数使用 number 200
disabled 是否将滑块禁用拖拽 boolean false
theme 主题颜色,以便用在不同的主题风格下 string #009688
自定义提示文本

当鼠标放在圆点和滑块拖拽时均会触发提示层。其默认显示的文本是它的对应数值,你也可以自定义提示内容:

slider.render({
  elem: '#slideTest1'
  ,setTips: function(value){ //自定义提示文本
    return value + '%';
  }
});
      
数值改变的回调

在滑块数值被改变时触发。该回调非常重要,可动态获得滑块当前的数值。你可以将得到的数值,赋值给隐藏域,或者进行一些其它操作。

//当滑块为普通模式,回调返回的 value 是一个数值
slider.render({
  elem: '#slideTest1'
  ,change: function(value){
    console.log(value) //动态获取滑块数值
    //do something
  }
});
 
//当滑块为范围模式,回调返回的 value 是一个数组,包含开始和结尾
slider.render({
  elem: '#slideTest1'
  ,range: true
  ,change: function(value){
    console.log(value[0]) //得到开始值
    console.log(value[1]) //得到结尾值
    //do something
  }
});
      
实例方法

执行 slider 实例时,会返回一个当前实例的对象,里面包含针对当前实例的方法和属性。
语法:var ins1 = slider.render(options);

var ins1 = slider.render(options); //获得实例对象
 
ins1.config //获得当前实例的配置项
ins1.setValue(nums); //动态给滑块赋值
      
动态改变滑块数值

你可以通过外部方法动态改变滑块数值,如:

var ins1 = slider.render({
  elem: '#test1'
  //…
});      
 
//改变指定滑块实例的数值
ins1.setValue(20)
 
//若滑块开启了范围(range: true)
ins1.setValue(20, 0) //设置开始值
ins1.setValue(60, 1) //设置结尾值
      
结语

layui.slider 可以大幅度提升你 Web 应用中的很多操作体验,可尽情发挥。

layui - 在每一个细节中,用心与你沟通