转载请注明作者(think8848)和出处(http://think8848.cnblogs.com)。未经作者同意,请勿擅自修改本文内容。

这两天项目中要用到类似于ListBox的功能了,本以为有很多jQuery插件,没有想到的是,居然没有搜到好用的,咋办呢,自已动手丰衣足食吧,于是花了一个晚上的时间做出来一个,上效果图:

该ListBox插件支持拖放,多选。

应用说明:

HTML:

<ul id="left"></ul>

Javascript:

            $('#left').listbox({
                data: '/Data/Index?' + new Date().getTime(),
                width: 200,
                height: 300
            });

默认选项说明:

Options:

  dnd: 是否支持拖放,默认false

  dndscope: 支持拖放时相关的作用域,举例来说,即,A ListBox和B ListBox的dndscope相同,则这两个ListBox中的元素是可以相互拖放的

  height: 地球人都知道,默认'auto'

  width: 火星人也知道了,默认'auto'

  data: 数据源,即可以是url也可以是对象数组,默认为[];

    无论是远程还是本地数据均有两种格式:

    1. {value: '', text: ''}

    2. ['', ''],在这种情况下,请将value置于第一个元素

  multiselect: 是否允许多选,默认false

  ajaxsettings: 如果需要从远程获取数据,这里定义了$.ajax的默认选项

    默认:

    type: 'GET'

    dataType: 'json'

    success: funtion(data){}

Events:

  2011.9.30 1.1版删除

  itemselected: ListBox中的元素选中的被触发;

    定义:function(data){},参数data为选中的元素数组

  2011.9.30 1.1版新增

  selectchange: ListBox中的元素选中项发生变化时被触发;

    定义:function(data){},参数data为选中的元素数组

Methods:

  addItem: 添加一个元素;

    定义:function(data){},其中data类型为{value: '', text: ''}或['', '']

    示例:    

            $('#btnAddItem').click(function () {
                $('#left').listbox().addItem({ value: 3, text: 'c' });
            });

  addRange: 添加元素数组;

    定义:function(data){},其中data类型为由{value: '', text: ''}或['', '']组成的数组

    示例:  

            $('#btnAddRange').click(function () {
                $('#left').listbox().addRange([{ value: 4, text: 'd' }, ['5', 'e']]);
            });

  clear: 清除所有元素

    定义: function(){}

    示例:

            $('#btnClear').click(function () {
                $('#left').listbox().clear();
            });

  getData: 获取与指定jQuery对象关联的数据

    定义:function(a){},参数a为ListBox元素的a标签,ListBox元素的DOM结构为<li><a></a></li>

    示例:

            $('#btnGetData').click(function () {
                var a = $('#left a:first');
                if (a.size() > 0) {
                    var data = $('#left').listbox().getData(a);
                    alert("{value: '" + data.value + "', text: '" + data.text + "'}");
                }
            });

  getDatas: 获取所有数据

    定义: function(){}

    示例:

            $('#btnGetDatas').click(function () {
                alert($('#left').listbox().getDatas().length);
            });

  getSelected: 获取所有选中的数据

    定义:function(){}

    示例:

            $('#btnGetSelected').click(function () {
                alert($('#left').listbox().getSelected().length);
            });

  2011.9.30 1.1版新增

  reload: 重新加载ListBox中的数据

    定义:function(data,ajaxsettings){},参数data,ajaxsettins定义同Options中同名属性data的定义

    示例:    

            $('#btnReload').click(function () {
                $('#left').listbox().reload({ data: '/Data/Index', ajaxsettings: {
                    data: { id: 'a' }
                }
                });
            });

  removeItem: 删除指定value值的元素

    定义:function(data){},参数data可以为单个值,也可以为{value:''}对象

    示例:

            $('#btnRemoveItem').click(function () {
                $('#left').listbox().removeItem({ value: 1 });
            });

  removeRange: 删除指定value值数组的元素

    定义:function(data){},参数data为单个值,或{value:''}对象的数组

    示例:

            $('#btnRemoveRange').click(function () {
                var datas = $('#left').listbox().getDatas();
                $('#left').listbox().removeRange(datas);
            });

  setSelection: 选中指定value值的元素

    定义: function(value){},参数value为单个值

    示例:

            $('#btnSetSelection').click(function () {
                $('#left').listbox().setSelection(1);
            });

调用方法时,可以也可以使用$('#selector').listbox('methodName',arguments)方式,例:

            $('#btnCallMethod').click(function () {
                var a = $('#left a:first');
                if (a.size() > 0) {
                    var data = $('#left').listbox('getData', a);
                    alert("{value: '" + data.value + "', text: '" + data.text + "'}");
                }
            });

  

OK,至此我的需求基本满足了,就先这样吧,欢迎在试用过程中提交bug或者改进建议,谢了

源代码与示例下载(VS2010 ASP.NET MVC 3)

  

  

  

posted on 2011-09-28 17:26  think8848  阅读(7814)  评论(6编辑  收藏  举报