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数组作为数据源,并为每列实现强大的搜索过滤功能,极大地提升表格的交互性和可用性。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
jquery插件有哪些
jquery插件有哪些

jquery插件有jQuery UI、jQuery Validate、jQuery DataTables、jQuery Slick、jQuery LazyLoad、jQuery Countdown、jQuery Lightbox、jQuery FullCalendar、jQuery Chosen和jQuery EasyUI等。本专题为大家提供jquery插件相关的文章、下载、课程内容,供大家免费下载体验。

151

2023.09.12

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

313

2023.10.13

jquery删除元素的方法
jquery删除元素的方法

jquery可以通过.remove() 方法、 .detach() 方法、.empty() 方法、.unwrap() 方法、.replaceWith() 方法、.html('') 方法和.hide() 方法来删除元素。更多关于jquery相关的问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

396

2023.11.10

jQuery hover()方法的使用
jQuery hover()方法的使用

hover()是jQuery中一个常用的方法,它用于绑定两个事件处理函数,这两个函数将在鼠标指针进入和离开匹配的元素时执行。想了解更多hover()的相关内容,可以阅读本专题下面的文章。

504

2023.12.04

jquery实现分页方法
jquery实现分页方法

在jQuery中实现分页可以使用插件或者自定义实现。想了解更多jquery分页的相关内容,可以阅读本专题下面的文章。

187

2023.12.06

jquery中隐藏元素是什么
jquery中隐藏元素是什么

jquery中隐藏元素是非常重要的一个概念,在使用jquery隐藏元素之前,需要先了解css样式中关于元素隐藏的属性,比如display、visibility、opacity等属性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

120

2024.02.23

jquery中什么是高亮显示
jquery中什么是高亮显示

jquery中高亮显示是指对页面搜索关键词时进行高亮显示,其实现办法:1、先获取要高亮显示的行,获取搜索的内容,再遍历整行内容,最后添加高亮颜色;2、使用“jquery highlight”高亮插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

176

2024.02.23

jQuery 正则表达式相关教程
jQuery 正则表达式相关教程

本专题整合了jQuery正则表达式相关教程大全,阅读专题下面的文章了解更多详细内容。

40

2026.01.13

go语言 注释编码
go语言 注释编码

本专题整合了go语言注释、注释规范等等内容,阅读专题下面的文章了解更多详细内容。

30

2026.01.31

热门下载

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

相关下载

更多

精品课程

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

共14课时 | 0.8万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.1万人学习

CSS教程
CSS教程

共754课时 | 26.1万人学习

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

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