blear.ui.draggable-list

1Introduction

description：可拖拽的列表
author：ydr.me
create：2016年06月04日14:09:36
update：2018年05月04日11:03:23
github：https://github.com/blearjs/blear.ui.draggable-list

2Example

var DraggableList = require('blear.ui.draggable-list');

new DraggableList({
    el: '#demo',
    list: [
        2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019
    ],
    active: 7
})

3Static

3.1`.defaults`

类型：Object
说明：默认配置

3.2`.defaults.el`

类型：Element
说明：容器元素

3.3`.defaults.list`

类型：Array<String | {text: String, value: String, visible: Boolean}>
说明：列表

举例：

[2011, 2016, 2022]

或

[
  {text: "2011年", value: 2011},
  {text: "2011年", value: 2011, visible: false},
  {text: "2011年", value: 2022}
]

3.4`.defaults.size`

类型：number
说明：可见范围，建议是一个奇数
默认：7

3.5`.defaults.active`

类型：number
说明：激活的项目在list里的索引值
默认：0

4`new DraggableList(options)`

实例化一个可拖拽（含触摸）的列表，options 为入参，默认值为 .defaults。

5Prototype

5.1`#setVisible(index, visible): this`

设置可见性。

5.1.1`index`

类型：number
说明：索引值

5.1.2`visible`

类型：boolean
说明：可见性

5.2`#setActive(index): this`

设置激活

5.2.1`index`

类型：number
说明：索引值

5.3`#getActive(): item`

获取当前激活项目

5.3.1`item`

类型：{{index: *, value: *, text: *, visible: boolean}}
说明：项目

5.4`#setList(list, [active=0]): this`

重新设置拖拽列表。

5.4.1`list`

类型：Array<String | {text: String, value: String, visible: Boolean}>
说明：参考 .defaults.list

5.4.2`active`

类型：Number
说明：激活索引值
默认：0

5.5`#destroy()`

销毁实例。

6Events

6.1`change(item)`

拖拽（含触摸）改变后触发。

6.1.1`item`

类型：{{index: *, value: *, text: *, visible: boolean}}
说明：项目

7Dependencies

8Reference

无。