JQuery DataTables 服务端自定义查询(最新版本介绍)

在使用JQuery DataTables 做查询的走了很多弯路,搜了一下 “JQuery DataTables 自定义查询”相关博文不是太老,就是胡说八道,只能去翻了一下英文的官方文档,而后才得到答案。

JQuery DataTables 的自定义查询 是通过 JQuery DataTables API 中的 Search() 方法实现的。

使用search API 一定在 配置 searching 配置 为 true

下面,我们就以 ASP.NET MVC为例,实现 JQuery DataTables 自定义查询。

JQuery DataTables 自定义及多条件查询 有两种实现方式 : 全局搜索列搜索

JQuery DataTables 查询

检索数据是表概念的核心,该方法允许用户轻松访问数据。该方法提供通过API控制表的全局搜索的能力。全局搜索在所有可搜索的列中执行(参考 columns.searchableOption 禁止搜索某些列)。 如果发现数据在任何列中匹配,则整行匹配并显示在结果集中。可以使用 columns().search()API 和 column().search()API 方法来执行各个列的搜索。

JQuery DataTables 服务端自定义查询(最新版本介绍)_第1张图片

中文文档(推荐): http://www.datatables.club/reference/api/search().html

官网API 文档: http://www.datatables.club/reference/api/

从官网文档中,我们可以看到 插件提供了三种搜索方式,其实就是 全局搜索 和 列搜索,全局搜索和列搜索的区别,我们下面介绍。 我们现在需要知道的是,任何一种API 都可以帮我们实现 自定义查询。

JQuery DataTables 多条件查询

现在我们详细介绍一下,API提供的三种查询方法—— search,column().search(),columns().search()。

其实这三种方法,也就是所谓的全局搜索 和 列搜索, 他们的本质区别在于 : 生成的请求表单不同,也是说请求的时候参数不同。

这里,可以参考一下 我的上一篇 博文:

http://blog.csdn.net/shuai_wy/article/details/78214419(JQuery DataTables 请求表单)

  • search( input [, regex[ , smart[ , caseInsen ]]] )
    • input :搜索内容
    • regex: true or false ,是否作为正则表单查询
    • smart 执行内置搜索算法(默认为true)或者不执行(false)。在使用此参数前,确保第二个参数是false,不然两个正则表达式可能冲突导致意想不到的结果。 如果你不想使用内置算法搜索,置为false,第二个参数为true,即可自定义正则表达式搜索。
    • caseInsen 不区分大小写匹配

后面几个参数,对于服务端查询来说,作用不是很大。

全局搜索

全局查询search 在服务端查询应用中,实质就是把我们设置的几个 参数,赋给了 search参数。 我们服务端 就可以根据search 传递的参数,来进行查询,就可以了。

JQuery DataTables 请求表单

JQuery DataTables 服务端自定义查询(最新版本介绍)_第2张图片

全局搜索实现代码如下:

var table = $('#example').DataTable();

$('#myInput').on( 'keyup', function () {
    table.search( this.value ).draw();//发起查询请求,并重绘表格
} );
// 此处我是用的是全局查询,下面中我们将介绍他们的区别

// 这里有一个需要大家注意的地方,在使用 search 的时候,记得一定在 配置中 将 searching 设置 为true. 不然将不起作用

列搜索

  • columns().search() 和 column().search 都属于列查询,也就是说把查询条件放到 每一列的 search 参数中,传递给后台,后台可以根据列名,分拣处每个字段的查询条件。

    列查询

实例:
官网实例:https://datatables.net/reference/api/columns().search()

$('#column3_search').on( 'keyup', function () {
    table
        .columns( 3 )
        .search( this.value )
        .draw();
} );

//这里也简单介绍一下: column(),可以通过 索引 如column(1) 或 name值 column("XXX") 或者 every遍历找到某一列。 column 也是一个API,作用就是 定位某一列 

列搜索实例:

  var table = $.fn.dataTables;
        table.columns().every(function () {//遍历列
            switch (this.index()) {
               case 1:
                    this.search($.trim($('#IDNum').val()));
                    break;
               case 2:
                    this.search($.trim($('#Name').val()));
                    break;
            }
        });
        table.columns().search().draw();//执行查询
    });

总结

总结一下,JQuery DataTables 查询作为插件的核心,依赖的就是 API 中的 Search () 方法对于我们服务端实现自定义查询的时候,我们需要的就是把 查询条件传递给后端, 而 全局查询 和 列查询 真正操作的就是我们的请求表单,所以 全局查询也好还是列查询也好,对我们服务端查询来说,无关紧要,我们随便选择一种方式,把我么要查询的参数传递给后台即可。

补充

  1. 我们在上一小节中,提到一个 data参数,data参数可以作为表单里的一个独立参数,传递给后台,我们能不能通过 data实现查询呐?

答案:不能,因为data 参数在datatables 初始化后就无法修改了,而 datatables插件本身也不允许重复初始化,所以无法实现。

  1. 还有一点大家一定不要忽视,一定要在配置时: searching 设置为 true, 设置为false之后,是无法生效的。 searching 设置true后,会有过滤框显示出来,如果我们不想显示过滤框,我们可以通过 dom 配置,隐藏过滤框
            dom:'lBrtip'

你可能感兴趣的:(web开发,JQuery,JQuery,DataTables,插件实例详解)