Blend UI Slider API文档

Construct

配置所需参数来初始化一个幻灯片组件Slider

Slider的配置格式如下：

var slider = new Blend.ui.Slider({"options":"values"});

Slider包含以下配置项：

id

slider的id

类型	说明	是否必须
String	slider的id	否

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ]
});

top

配置slider距离屏幕top的坐标

类型	说明	是否必须
Number	slider距离屏幕top的坐标，默认值0	否

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "top": 100,
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ]
});

left

配置slider距离屏幕left的坐标

类型	说明	是否必须
Number	slider距离屏幕left的坐标，默认值0	否

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "top": 100,
    "left": 100,
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ]
});

width

配置slider宽度

类型	说明	是否必须
Number	slider像素宽度，默认为屏幕宽度	否

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "width": 100,
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ]
});

height

配置slider高度

类型	说明	是否必须
Number	slider像素高度，默认为屏幕高度	否

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "height": 100,
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ]
});

bgColor

配置slider背景颜色

类型	说明	是否必须
String	slider背景颜色,默认透明	否

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "bgColor": "#cccccc",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ]
});

images

配置图片数据json

类型	说明	是否必须
Object	图片数据json	是

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ]
});

tap

配置点击slider的事件回调

类型	说明	是否必须
Function	点击slider的事件回调	否

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ],
    "tap": function(e){console.log(e.data.index)}
});

slide

配置滑动slide的事件回调

类型	说明	是否必须
Function	滑动slider的事件回调	否

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ],
    "slide": function(e){console.log(e.data.index)}
});

hasIndicator

是否添加页面指示，可以以圆点的方式展现有多少个图片页面，可以指示当前页面在整个页面的顺序。

类型	说明	是否必须
Boolean	是否添加页面指示,默认值？	否

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ],
    "hasIndicator": true
});

inactiveColor

配置非选中状态的指示圆点图标的颜色

类型	说明	是否必须
String	非选中状态的指示圆点图标的颜色RGB值	否

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ],
    "hasIndicator": true,
    "inactiveColor": "#888888"
});

activeColor

配置选中状态的指示圆点图标的颜色

类型	说明	是否必须
String	选中状态的指示圆点图标的颜色RGB值	否

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ],
    "hasIndicator": true,
    "inactiveColor": "#888888",
    "activeColor": "#ff0000"
});

unitSize

配置页面指示圆点图标的尺寸

类型	说明	是否必须
Number	页面指示圆点图标的尺寸（单位：像素），默认值10	否

实例：

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ],
    "hasIndicator": true,
    "unitSize": 6
});

unitSpace

配置页面指示圆点图标间的间距

类型	说明	是否必须
Number	页面指示圆点图标间的间距（单位：像素），默认值5	否

实例:

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
      ],
    "hasIndicator": true,
    "inactiveColor": "#888888",
    "activeColor": "#ff0000",
    "unitSize": 6,
    "unitSpace": 3
});

Method

prev ( )

滚动到前一个图片页面

实例:

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ]
});

slider.prev();

next ( )

滚动到下一个图片页面

实例:

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ]
});

slider.next();

sliderTo (index)

滑动到第index个图片页面

参数	类型	说明	是否必须
index	Number	滑动到第index个页面	是

实例:

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ]
});

slider.sliderTo(0);

destroy ( )

销毁slider

实例:

var slider = new Blend.ui.Slider({
    "id": "slider",
    "images": [
        {"url":"http://*.com/old_07_02.jpg"},
        {"url":"http://*.com/old_09_02.jpg"}
     ]
});

slider.destroy();