基于Metronic的Bootstrap开发框架经验总结(2)--列表分页处理和插件JSTree的使用

在上篇《基于Metronic的Bootstrap开发框架经验总结(1)-框架总览及菜单模块的处理》介绍了Bootstrap开发框架的一些基础性概括,包括总体界面效果,以及布局、菜单等内容,本篇继续这一主题,介绍页面内容常用到的数据分页处理,以及Bootstrap插件JSTree的使用。在数据的界面显示当中,表格数据的展示以及分页是非常常见的处理操作,利用Bootstrap的样式布局,以及JQuery的Ajax数据处理,就能很好实现数据的动态展示和分页处理。

1、列表展示和分页处理

1)数据的列表展示

在很多页面里面,我们一般都需要对数据库记录进行列表展示并进行分页。

左侧的树列表下面小节介绍,右边就是我们一般的数据查询显示区域,分为查询内容和数据列表两部分,查询内容,我们一般放在一个表单里面进行处理,用户触发查询的时候,我们对事件进行处理,并从MVC后台的控制器里面请求对应的数据返回给页面前端,对数据进行显示和分页处理即可。

如菜单页面的查询代码如下所示。

	<form class="form-horizontal" id="ffSearch">
		<div class="col-md-3 col-sm-3 col-xs-6">
			<div class="form-group">
				<label class="control-label col-md-4">显示名称</label>
				<div class="col-md-8">
					<input name="WHC_Name" type="text" class="form-control">
				</div>
			</div>
		</div>
		<div class="col-md-3 col-sm-3 col-xs-6">
			<div class="form-group">
				<label class="control-label col-md-4">功能ID</label>
				<div class="col-md-8">
					<input name="WHC_FunctionId" type="text" class="form-control">
				</div>
			</div>
		</div>
		<div class="col-md-3 col-sm-3 col-xs-6">
			<div class="form-group">
				<label class="control-label col-md-4">Web连接地址</label>
				<div class="col-md-8">
					<input name="WHC_Url" type="text" class="form-control">
				</div>
			</div>
		</div>
		<div class="col-md-3 col-sm-3 col-xs-6">
			<div class="form-group">
				<label class="control-label col-md-4">Web菜单图标</label>
				<div class="col-md-8">
					<input name="WHC_WebIcon" type="text" class="form-control">
				</div>
			</div>
		</div>
	</form>

我们在页面的JS代码里面,处理页面初始化后,对数据进行查询的处理操作,如下脚本所示。

	//页面初始化
	$(function () {
		initJsTree(); //初始化树
		BindEvent();        //绑定事件处理
		Search(currentPage);//初始化第一页数据
		InitDictItem();     //初始化字典信息
	});

而数据的显示部分,HTML代码如下所示。主要就是显示了表头内容,表格的主体内容grid_body则有脚本动态构建并显示

	<table id="grid" class="table table-striped table-bordered table-hover" cellpadding="0" cellspacing="0" border="0" class="display" width="100%">
		<thead id="grid_head">
			<tr>
				<th class="table-checkbox" style="width:40px"><input class="group-checkable" type="checkbox" onclick="selectAll(this)"></th>
				<th>显示名称</th>
				<th>排序</th>
				<th>功能ID</th>
				<th>菜单可见</th>
				<th>Web连接地址</th>
				<th>Web菜单图标</th>
				<th>系统编号</th>
				<th style="width:90px">操作</th>
			</tr>
		</thead>
		<tbody id="grid_body"></tbody>
	</table>
	<div class="paging-toolbar">
		<ul id=‘grid_paging‘></ul>
	</div>

而数据的显示,是在页面准备完成后,通过Search脚本函数进行处理,处理的时候,先序列号表单的条件和分页的条件信息,传入MVC控制器,获取对应的列表数据,在界面上进行动态绑定即可完成整个处理过程了。具体代码截图如下所示。

而其中的代码

tr += getActionHtml(item.ID);

则是通过脚本生成一些操作按钮,界面如下所示。

2)数据分页处理

我们页面显示的数据一般不是固定的记录,因此分页也是很必要的处理,可以提高性能,也可以提高用户的友好体验,其中的数据分页是采用了Bootstrap的插件Bootstrap Paginator 进行处理的。这个控件用的很多,是一个很强大的分页插件。

Bootstrap Paginator 它的GitHub代码地址为:https://github.com/lyonlai/bootstrap-paginator

它的使用例子介绍,可以参考:http://lyonlai.github.io/bootstrap-paginator/

该控件使用的时候,引入Jquery和Bootstrap样式和类库后,通过下面的代码行即可添加使用。

<script src="/js/bootstrap-paginator.min.js"></script>

该控件分页可以通过处理page-clicked和page-changed事件进行实现。

分页展示内容,我们通过在HTML代码里面添加一个DIV进行,声明一个ID为grid_paging的UL元素,代码如下所示。

  <div class="paging-toolbar">
         <ul id=‘grid_paging‘></ul>
    </div>

然后具体的JS里面处理代码如下所示。

在MVC的后台,我们需要获取用户在前端页面传入的分页条件和表单数据条件,这样我们就可以根据这些参数,获取到对应的数据返回给客户端了。

由于这些处理都是很通用的,因此我们可以放到基类控制器进行处理,如果需要特殊化处理,再在子类控制器里面重写分页函数 FindWithPager 即可。

        /// <summary>
        /// 根据条件查询数据库,并返回对象集合(用于分页数据显示)
        /// </summary>
        /// <returns>指定对象的集合</returns>
        public virtual ActionResult FindWithPager()
        {
            //检查用户是否有权限,否则抛出MyDenyAccessException异常
            base.CheckAuthorized(AuthorizeKey.ListKey);

            string where = GetPagerCondition();
            PagerInfo pagerInfo = GetPagerInfo();
            List<T> list = baseBLL.FindWithPager(where, pagerInfo);

            //Json格式的要求{total:22,rows:{}}
            //构造成Json的格式传递
            var result = new { total = pagerInfo.RecordCount, rows = list };
            return ToJsonContentDate(result);
        }

其中GetPagerInfo就是获取用户传入进来的分页参数,还记得我们上面前端页面处理的URL参数吗,如下所示。

url = "/Menu/FindWithPager?page=" + page + "&rows=" + rows;

具体MVC控制器GetPagerInfo函数的实现代码如下所示。

/// <summary>
/// 根据Request参数获取分页对象数据
/// </summary>
/// <returns></returns>
protected virtual PagerInfo GetPagerInfo()
{
	int pageIndex = Request["page"] == null ? 1 : int.Parse(Request["page"]);
	int pageSize = Request["rows"] == null ? 10 : int.Parse(Request["rows"]);

	PagerInfo pagerInfo = new PagerInfo();
	pagerInfo.CurrenetPageIndex = pageIndex;
	pagerInfo.PageSize = pageSize;

	return pagerInfo;
}

然后获取到表单条件和分页条件后,传入给框架的业务逻辑类处理就可以了,这里已经是框架底层的支持范畴了,不在继续展开。

List<T> list = baseBLL.FindWithPager(where, pagerInfo);

最后的界面效果如下所示

2、插件JSTree

前面小节也提高的树列表的展示,在一般情况下,如果数据有层次的,那么通过树列表展示,可以很直观的显示出它们的结构,因此树列表在很多情况下,可以辅助我们对数据的分类展示。

如对于用户数据来说,我们可以根据用户的组织机构或者角色进行分类,他们两者可以通过树列表进行直观的展示,这样我们在寻找不同类型的用户列表的时候,就很好找了。

或者对于字典数据或者省份城市的数据,一样更可以通过树列表进行展示

   

JSTree 控件的官方地址为https://www.jstree.com/

网站对JSTree控件的使用说明及案例讲解的已经很清晰了,一般情况下,我们直接参考例子就可以使用了。

简单的JSTree使用代码如下所示

$(function () { $(‘#jstree_demo_div‘).jstree(); });

对于JSTree的事件,我们一般可以通过下面代码进行绑定事件。

$(‘#jstree_demo_div‘).on("changed.jstree", function (e, data) {
  console.log(data.selected);
});

如果我们需要获取JStree控件选中节点的内容,然后进行相关的处理操作,那么它的处理代码如下所示。

	//绑定双击事件
	$("#jstree_div").bind("dblclick.jstree", function (e, data) {
		EditDept();
	});
	$("#jstree_tag").bind("dblclick.jstree", function (e, data) {
		EditTag();
	});

双击事件,其实是连续的单击事件处理,一般情况下,或先选中当前节点,我们也可以在双击的时候,获取对应的节点ID,如下代码所示。

	bindJsTree("jstree_div", "/Menu/GetMenuJsTreeJson");
	$("#jstree_div").bind("dblclick.jstree", function (e, data) {
		var id = $(e.target).parents(‘li‘).attr(‘id‘);
		EditViewById(id);
	});

也就是可以通过

var id = $(e.target).parents(‘li‘).attr(‘id‘);

获取双击的节点ID,获取选择节点的名称则可以通过代码获取:

var eventNodeName = e.target.nodeName;

JSTree一般我们会通过JSON数据进行动态绑定,这个JSON的数据格式定义如下所示。

{
  id          : "string" // required
  parent      : "string" // required
  text        : "string" // node text
  icon        : "string" // string for custom
  state       : {
    opened    : boolean  // is the node open
    disabled  : boolean  // is the node disabled
    selected  : boolean  // is the node selected
  },
  li_attr     : {}  // attributes for the generated LI node
  a_attr      : {}  // attributes for the generated A node
}

一般情况下,我们通过下面的脚本进行数据的清空和绑定操作

$(‘#jstree_demo_div‘).data(‘jstree‘, false);//清空数据,必须

//异步进行JSON数据的绑定
$.getJSON(url, function (data) {
    $(‘#jstree_demo_div‘).jstree({
        ‘core‘: {
            ‘data‘: data,
            "themes": {
                "responsive": false
            }
        }
    }).bind(‘loaded.jstree‘, loadedfunction);
});

如果我们需要给用户提供复选框,设置JSTree的选中状态,界面效果如下所示。

那么一般的初始化函数就需要变化一下,如下代码所示

        //带复选框的JSTree的初始化代码
        $.getJSON(url, function (data) {
            control.jstree({ 
            ‘plugins‘ : [ "checkbox" ], //出现选择框
                ‘checkbox‘: { cascade: "", three_state: false }, //不级联
                ‘core‘: {                    
                ‘data‘: data,                    
                "themes": {                        
                "responsive": false 
                  }
                }
            }).bind(‘loaded.jstree‘, loadedfunction);
        });

综合两者,我们可以进一步把JSTree控件的初始化绑定提炼为一个JS的公共函数bindJsTree即可。

//以指定的Json数据,初始化JStree控件
//treeName为树div名称,url为数据源地址,checkbox为是否显示复选框,loadedfunction为加载完毕的回调函数
function bindJsTree(treeName, url, checkbox, loadedfunction) {
    var control = $(‘#‘ + treeName)
    control.data(‘jstree‘, false);//清空数据,必须

    var isCheck = arguments[2] || false; //设置checkbox默认值为false
    if(isCheck) {
        //复选框树的初始化
        $.getJSON(url, function (data) {
            control.jstree({
                ‘plugins‘ : [ "checkbox" ], //出现选择框
                ‘checkbox‘: { cascade: "", three_state: false }, //不级联
                ‘core‘: {
                    ‘data‘: data,
                    "themes": {
                        "responsive": false
                    }
                }
            }).bind(‘loaded.jstree‘, loadedfunction);
        });
    }
    else {
        //普通树列表的初始化
        $.getJSON(url, function (data) {
            control.jstree({
                ‘core‘: {
                    ‘data‘: data,
                    "themes": {
                        "responsive": false
                    }
                }
            }).bind(‘loaded.jstree‘, loadedfunction);
        });        
    }
}

因此在页面的绑定JSTree的时候,代码可以简化一下

        //初始化组织机构列表
        function initDeptTreeview() {            
        var treeUrl = ‘/User/[email protected]["UserId"]‘;
            bindJsTree("jstree_div", treeUrl);           
            //树控件的变化事件处理
            $(‘#jstree_div‘).on("changed.jstree", function (e, data) {               
            var icon = data.node.icon;               
               loadDataByOu(data.selected);
            });
        }

对于复选框的列表,初始化代码如下所示。

            //初始化所有该用户的所有功能集合
            var treeUrl = ‘/Function/[email protected]["UserId"]‘;
            bindJsTree("tree_function", treeUrl, true);            
            //角色数据权限,先初始化所有部门
            treeUrl = ‘/User/[email protected]["UserId"]‘;
            bindJsTree("tree_roledata", treeUrl, true);

对于复选框,我们一般是初始化数据,然后在根据需要设置树列表的选中状态,这种不用频繁初始化树,可以有效提高性能和响应体验。

那么我们在初始化树列表后,就需要清空选择项,然后设置我们所需要的选择项即可,具体代码如下所示,注意其中的uncheck_all和check_node事件的处理。

        //初始化角色数据权限集合(组织机构)
        function initRoleData(id) {            
        if (id != "") {                
        var treeMenu = "tree_roledata";
                $(‘#‘ + treeMenu).jstree("uncheck_all");//取消所有选中
                
                //勾选指定内容
                $.getJSON("/RoleData/GetRoleDataList?r=" + Math.random() + "&roleId=" + id, function (json) {
                    $.each(json, function (i, item) {
                         $(‘#‘ + treeMenu).jstree(‘check_node‘, item);//将节点选中            
                                  
                    });
                });
            }
        }

数据保存的时候,我们获得JSTree的节点选中列表就可以进行数据的保存了,具体代码如下所示。

        //保存角色数据权限
        function saveRoleData(roleid) {           
         var ouList = $(‘#tree_roledata‘).jstree(‘get_selected‘);            
         var url = ‘/RoleData/UpdateData?r=‘ + Math.random();            
         var postData = { roleId: roleid, ouList: ouList.join(‘,‘)};

            $.post(url, postData, function (json) {
                initRoleData(roleid);
            }).error(function () {
                showTips("您未被授权使用该功能,请联系管理员进行处理。");
            });
        }

好了,介绍到这里,基本上也把常规的数据展示,数据分页;JSTree的绑定、事件处理,数据保存等操作介绍的相对完整了,希望得到大家的继续支持,我会继续详细介绍Bootstrap开发里面涉及到的要点和各个插件的使用,以便把学习更加具体化,实用化,能够给我们实价开发项目做有用的参考。

时间: 2024-07-28 22:10:22

基于Metronic的Bootstrap开发框架经验总结(2)--列表分页处理和插件JSTree的使用的相关文章

基于Metronic的Bootstrap开发框架经验总结(17)-- 使用 summernote插件实现HTML文档的编辑和图片插入操作

在很多场合,我们需要在线编辑HTML内容,然后在页面上或者其他终端上(如小程序.APP应用等)显示,编辑HTML内容的插件有很多,本篇介绍基于Bootstrap的 summernote插件实现HTML文档的编辑和图片插入操作,这个控件的使用非常方便,并且用户群也很大. Summernote 是一个简单灵活,所见即所得(WYSIWYG)的编辑器,Summernote是一个轻量级.灵活基于Bootstrap和jQuery的HTML文本编辑器,拥有强大的API配置功能,多国语言支持支持Bootstra

基于Metronic的Bootstrap开发框架经验总结(3)--下拉列表Select2插件的使用

在上篇<基于Metronic的Bootstrap开发框架经验总结(2)--列表分页处理和插件JSTree的使用>介绍了数据的分页处理,使用了Bootstrap Paginator插件,另外对树形列表,采用了JSTree插件,本篇继续介绍在编辑页面中常用到的控件Select2,这个控件可以更加丰富传统的Select下拉列表控件,提供更多的功能和更好的用户体验. 1.Select2控件介绍 这个插件是基于Select的扩展插件,能够提供更加丰富的功能和用户体验,它的github官网地址为:http

基于Metronic的Bootstrap开发框架经验总结(9)--实现Web页面内容的打印预览和保存操作

在前面介绍了很多篇相关的<Bootstrap开发框架>的系列文章,这些内容基本上覆盖到了我这个Bootstrap框架的各个主要方面的内容,总体来说基本达到了一个稳定的状态,随着时间的推移可以会引入一些更好更新的内容进行完善,本篇继续这个系列,主要介绍如何实现Web页面内容的打印预览和保存操作. 1.Web页面打印的问题 在此之前,我一般使用比较好用的LODOP来执行打印的操作,这个在我之前有很多文章都有涉及,这个控件是一个ActiveX的控件,需要下载安装后就可以在页面是进行打印的排版设计,预

基于Metronic的Bootstrap开发框架经验总结(5)--Bootstrap文件上传插件File Input的使用

Bootstrap文件上传插件File Input是一个不错的文件上传控件,但是搜索使用到的案例不多,使用的时候,也是一步一个脚印一样摸着石头过河,这个控件在界面呈现上,叫我之前使用过的Uploadify 好看一些,功能也强大些,本文主要基于我自己的框架代码案例,介绍其中文件上传插件File Input的使用.关于Uploadify的控件介绍,可以参考我之前的随笔介绍<基于MVC4+EasyUI的Web开发框架形成之旅--附件上传组件uploadify的使用>. 1.文件上传插件File In

基于Metronic的Bootstrap开发框架经验总结(15)-- 更新使用Metronic 4.75版本

在基于Metronic的Bootstrap开发框架中,一直都希望整合较新.较好的前端技术,结合MVC的后端技术进行项目的开发,随着时间的推移,目前Metronic也更新到了4.75版本,因此着手对这个版本的内容进行一次更新调整,以期达到与时俱进的目的.从最近这几个版本来看,Metronic本身的目录结构以及功能没有太多的变化,但增加了一些较为方便的功能,本篇随笔对比它们进行介绍. 1.Metronic版本更新 首先我们来对空白页面进行不同版本的对比,文件的对比首选Beyond Compare,两

基于Metronic的Bootstrap开发框架经验总结(8)--框架功能总体界面介绍

在前面介绍了一系列的<基于Metronic的Bootstrap开发框架经验总结>的随笔文章,随笔主要是介绍各个知识点的内容,对框架的总体性界面没有很好的阐述,本篇随笔主要介绍这个Bootstrap框架的总体性功能界面,介绍其中用到的知识点和整体性的界面.希望读者对框架有一个更加直观.真实的认识了解,界面设计以及相关思路可以借鉴提高,也可以对相关的内容进行相互探讨,共同提高. 1.<基于Metronic的Bootstrap开发框架>技术特点 1)采用最新最炫的Bootstrap响应式

基于Metronic的Bootstrap开发框架经验总结(13)--页面链接收藏夹功能的实现2

在上篇随笔<基于Metronic的Bootstrap开发框架经验总结(12)--页面链接收藏夹功能的实现>上,我介绍了链接收藏夹功能的实现,以及对收藏记录的排序处理.该篇随笔主要使用功能按钮的方式移动收藏记录,功能虽然实现的还算不错,不过文章出来后,有读者同行指出可以利用直接拖动的方式实现排序更方便,因此对其中列表记录的排序进行了研究,从而介绍了如何利用Sortable开源JS组件实现拖动排序的处理,本篇随笔介绍了该组件在连接收藏夹排序中的应用. 1.收藏记录的排序处理回顾 上篇随笔介绍的收藏

基于Metronic的Bootstrap开发框架经验总结(18)-- 在代码生成工具Database2Sharp中集成对Bootstrap-table插件的分页及排序支持

在我们开发系统界面,包括Web和Winform的都一样,主要的界面就是列表展示主界面,编辑查看界面,以及一些辅助性的如导入界面,选择界面等,其中列表展示主界面是综合性的数据展示界面,一般往往需要对记录进行合理的分页,集成各种增删改查的按钮等功能.随着开发项目的需求辩护,对数据记录分页展示.排序等功能都是常态的要求,因此在代码生成工具中调整了主列表界面的列表展示插件为Bootstrap-table插件,本篇随笔主要介绍在代码生成工具Database2Sharp中集成对Bootstrap-table

基于Metronic的Bootstrap开发框架经验总结(10)--优化Bootstrap图标管理

在基于Bootstrap开发的项目中,鲜艳颜色的按钮,以及丰富的图表是很吸引人的特点,为了将这个特点发挥到极致,可以利用Bootstrap图标抽取到数据库里面,并在界面中进行管理和使用,这样我们可以把这些图标方便应用在各个页面部件上,如菜单模块,按钮界面,表单输入等多个场合进行使用.在前面随笔<基于Metronic的Bootstrap开发框架经验总结(4)--Bootstrap图标的提取和利用>中,我对如何抽取Bootstrap图标,并单独开发一个页面进行图表的管理,本随笔介绍如何在这个基础上