bui.listview Class
Constructor
bui.listview
(
-
option
Parameters:
-
option
Object-
id
String[控件id]
-
[data]
Array optional[点击触发侧滑的按钮 例如:[{ "text": "修改", "classname":"btn-blue"}] ]
-
[text]
String optional[菜单的文本] -
[classname]
String optional[菜单的样式]
-
-
[handle]
String optional[触发的区域,默认是.bui-btn ]
-
[width]
Number optional[ listview的宽度,默认:0, 0 为自适应屏幕宽度]
-
[height]
Number optional[ listview的高度,默认:0, 0 为自适应内容高度]
-
[menuWidth]
Number optional[菜单总宽度,默认:100]
-
[menuHeight]
Number optional[ 菜单的高度 默认:0 自适应内容高度 ]
-
[position]
String optional[ 菜单侧滑的方向 right | left ]
-
[zoom]
Boolean optional[ since 1.3.0 是否采用缩放宽高的方式 默认 false | true ]
-
[mask]
Boolean optional[ 遮罩 true ]
-
[distance]
Number optional[ 默认80, 拖拽大于distance才会生效,配合delay可以防止listview又有上下其它事件 ]
-
[callback]
Function optional[ 点击的回调 ]
-
Example:
html:
<ul id="listview" class="bui-listview">
<li>
<div class="bui-btn">
菜单
</div>
</li>
</ul>
js:
// 初始化
var uiListview = bui.listview({
id: "#listview",
data: [{ "text": "修改", "classname":"btn-blue"},
{ "text": "删除", "classname":"btn-red"}],
callback: function (e,ui) {
var index = $(this).text();
if( index == "修改" ){
//do something
}
ui.close();
}
});
Methods
active
()
Object
获取激活对象
Returns:
Object:
[ swipe对象 ]
Example:
//是否打开
var activeUI = uiListview.active();
close
()
chainable
关闭菜单
Example:
//关闭菜单
uiListview.close();
destroy
(
-
[bool]
[销毁控件]
Parameters:
-
[bool]
Boolean optional[ 默认: false 销毁部分 | true 销毁全部 ]
Example:
//销毁
uiListview.destroy();
init
(
chainable
-
[option]
初始化方法,用于重新初始化结构,事件只初始化一次
Parameters:
-
[option]
Object optional[参数控件本身]
lock
()
chainable
不允许滑动
Example:
//关闭菜单
uiListview.lock();
option
(
chainable
-
[key]
-
[value]
获取设置参数
Parameters:
-
[key]
String | object optional[ 不传则获取所有参数, 类型为string,没有第2个参数则获取某个参数 ]
-
[value]
String | number | boolean | function optional[ 设置参数的时候要传,设置多个参数不用传,获取参数的时候也不用传 ]
Example:
//获取所有参数
//获取所有参数
var option = uiListview.option();
//获取某个参数
var id = uiListview.option( "id" );
//修改一个参数
uiListview.option( "width",120 );
//修改多个参数
uiListview.option( {"width":120} );
unlock
()
chainable
允许滑动
Example:
//关闭菜单
uiListview.unlock();
widget
(
-
[name]
获取依赖的控件
Parameters:
-
[name]
String optional[ 依赖控件名 ]
Example:
//获取依赖控件
var uiListviewWidget = uiListview.widget();
Events
off
为控件取消绑定事件
Event Payload:
-
[type]
String optional[ 事件类型: "open" | "close" ]
-
[callback]
Function optional[ 绑定的事件, this 为当前点击的菜单 ]
Example:
uiListview.off("lock");
on
为控件绑定事件
Event Payload:
-
[type]
String optional[ 事件类型: "open" | "close" ]
-
[callback]
Function optional[ 绑定的事件, this 为当前点击的菜单 ]
Example:
uiListview.on("lock",function () {
// 点击的菜单
console.log(this);
});