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();