0

0

DataTables基于JavaScript数组实现列搜索功能教程

花韻仙語

花韻仙語

发布时间:2025-08-25 20:50:28

|

909人浏览过

|

来源于php中文网

原创

DataTables基于JavaScript数组实现列搜索功能教程

本教程详细指导如何在DataTables中使用JavaScript数组数据源,实现强大的每列搜索过滤功能。我们将从数据与表头配置的兼容性入手,逐步讲解如何动态生成表头(如果缺失),并集成DataTables的initComplete回调函数,为每一列添加可交互的搜索输入框,从而提升数据表格的用户体验和查询效率。

1. DataTables基础初始化与数据兼容性

在使用datatables时,如果数据源是javascript的数组,并且希望为每列添加搜索功能,首先需要确保datatables的基础初始化正确无误。一个常见的错误是数据列数与表头定义不匹配。

示例:正确的数据与表头配置

假设我们有以下数据和表头定义:

const dataSet = [
    ['a', 'b', 'x'],
    ['c', 'd', 'y'],
    ['e', 'f', 'z']
];
const headers = [
    { 'title': 'A' },
    { 'title': 'B' },
    { 'title': 'C' }
];

这里,dataSet中的每个子数组代表一行数据,包含三个元素。headers数组定义了三个列标题。两者数量一致,这是DataTables正常工作的基本前提。

基础的DataTables初始化代码如下:

立即学习Java免费学习笔记(深入)”;

$(document).ready(function () {
    $('#example').DataTable({
        data: dataSet,
        columns: headers,
    });
});

此代码将dataSet作为表格数据,headers作为列定义,初始化一个基本的DataTables实例。

2. 动态生成表头(thead)

在实现列搜索功能时,DataTables的许多高级特性(尤其是涉及表头操作的,如列过滤)都依赖于HTML表格中存在一个元素。如果你的HTML表格仅包含一个空的

标签,例如:

那么你需要在使用DataTables初始化之前,动态地创建并插入元素。这是因为后续用于生成列过滤器的代码会克隆现有的表头行。

动态生成的JavaScript代码:

// 根据headers数组动态生成元素
var th = '';
headers.forEach(header => th = th + '' + header.title + '');
th = th + '';
$(th).appendTo('#example');

这段代码会遍历headers数组,为每个表头对象创建一个

crmeb电商系统
crmeb电商系统

CRMEB 是基于Thinkphp5基础开发的以会员为中心的电商系统,开源版微信公众号商城和小程序商城数据同步,带积分、优惠券、秒杀、砍价、分销等功能,更是一套方便二次开发的商城框架(后台封装了独有快速创建表单功能,无需写表单页面、快速创建数据搜索和数据列表页、导出表格、系统权限配置控制每一个控制器方法、系统参数配置、数据字典、组合数据等)

下载
标签,然后将所有 包裹在 和中,最后将其添加到id为example的表格中。

3. 实现每列搜索功能

DataTables提供了initComplete回调函数,允许我们在表格完全初始化后执行自定义操作。我们将利用此回调函数来为每列添加搜索输入框。

核心逻辑步骤:

  1. 克隆表头行并添加过滤器类: $('#example thead tr').clone(true).addClass('filters').appendTo('#example thead'); 这行代码克隆了现有的表头行,并将其添加回中,同时为其添加filters类,以便后续定位。
  2. 遍历每一列: 在initComplete回调中,通过api.columns().eq(0).each(function (colIdx) { ... }); 遍历表格的每一列。
  3. 创建搜索输入框: 对于每一列,获取其表头单元格,并用一个带有占位符的替换其内容。占位符通常是该列的标题。
  4. 绑定搜索事件: 为新创建的输入框绑定change和keyup事件。
    • change事件用于执行实际的列搜索。它获取输入框的值,并使用api.column(colIdx).search(...)方法对当前列进行过滤。
    • keyup事件用于在用户输入时即时触发change事件,实现实时搜索效果,并通过e.stopPropagation()阻止事件冒泡,避免干扰DataTables的其他事件。
  5. 完整JavaScript代码示例:

    $(document).ready(function() {
        const dataSet = [
            ['a', 'b', 'x'],
            ['c', 'd', 'y'],
            ['e', 'f', 'z']
        ];
        const headers = [
            { 'title': 'A' },
            { 'title': 'B' },
            { 'title': 'C' }
        ];
    
        // 1. 动态生成,如果HTML中没有定义
        var th = '';
        headers.forEach(header => th = th + '' + header.title + '');
        th = th + '';
        $(th).appendTo('#example');
    
        // 2. 克隆表头行并添加过滤器行
        $('#example thead tr')
            .clone(true)
            .addClass('filters')
            .appendTo('#example thead');
    
        var table = $('#example').DataTable({
            // 3. 配置DataTables数据源和列定义
            data: dataSet,
            columns: headers,
    
            // 4. 其他DataTables选项
            orderCellsTop: true, // 确保排序图标在顶部表头
            fixedHeader: true,   // 固定表头,如果需要
    
            // 5. initComplete回调,实现列搜索逻辑
            initComplete: function() {
                var api = this.api();
    
                // 遍历每一列
                api.columns().eq(0).each(function(colIdx) {
                    // 获取过滤器行中的对应单元格
                    var cell = $('.filters th').eq($(api.column(colIdx).header()).index());
                    var title = $(cell).text(); // 获取原始列标题作为placeholder
    
                    // 在单元格中插入搜索输入框
                    $(cell).html('');
    
                    // 为输入框绑定change和keyup事件
                    $('input', $('.filters th').eq($(api.column(colIdx).header()).index()))
                        .off('keyup change') // 先解绑,防止重复绑定
                        .on('change', function(e) {
                            $(this).attr('title', $(this).val()); // 将当前值设置为title属性
                            var regexr = '({search})'; // 用于构建正则表达式
    
                            // 执行列搜索
                            api.column(colIdx).search(
                                this.value != '' ?
                                regexr.replace('{search}', '(((' + this.value + ')))') :
                                '',
                                this.value != '',
                                this.value == ''
                            ).draw(); // 重新绘制表格以显示过滤结果
                        })
                        .on('keyup', function(e) {
                            e.stopPropagation(); // 阻止事件冒泡
    
                            $(this).trigger('change'); // 触发change事件进行搜索
                        });
                });
            },
        });
    });

    4. HTML结构与必要的库引入

    为了使上述JavaScript代码正常工作,你的HTML页面需要包含一个

    元素,并引入jQuery和DataTables的JS/CSS库。

    HTML结构:

    
    
    
      
      DataTables列搜索教程
      
      
      
      
      
      
      
    
    
      

5. 注意事项与总结

  • 数据与表头匹配: 始终确保dataSet中的每行数据元素数量与headers数组中定义的列数一致。
  • 的重要性: 如果HTML中没有显式定义,请务必在DataTables初始化前通过JavaScript动态生成。这是列过滤器能够正确附加的前提。
  • 事件处理: off('keyup change').on('change', ...).on('keyup', ...)的模式确保了事件的正确绑定和实时搜索效果。e.stopPropagation()在keyup中是关键,防止不必要的事件冒泡。
  • 搜索逻辑: api.column(colIdx).search(...)是DataTables提供的核心列搜索方法。示例中的regexr.replace('{search}', '(((' + this.value + ')))')用于构建一个正则表达式进行匹配,可以根据需求调整其匹配模式。
  • orderCellsTop和fixedHeader: 这两个选项不是实现列搜索的必需品,但它们在用户体验上有所帮助。orderCellsTop: true确保排序图标在顶部表头,fixedHeader: true则使表头在滚动时保持固定。
  • 通过以上步骤,你就可以成功地在DataTables中使用JavaScript数组作为数据源,并为每列实现强大的搜索过滤功能,极大地提升表格的交互性和可用性。

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

536

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

372

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

707

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

470

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

388

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

989

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

652

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

537

2023.09.20

虚拟号码教程汇总
虚拟号码教程汇总

本专题整合了虚拟号码接收验证码相关教程,阅读下面的文章了解更多详细操作。

25

2025.12.25

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

相关下载

更多

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 0.7万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.6万人学习

CSS教程
CSS教程

共754课时 | 16.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号