讲师中心 微信公众号
AI工具推荐 视频效率加速

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

雨丽大大_5575

雨丽大大_5575

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

|

949人浏览过

|

来源于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正常工作的基本前提。

CSS工具箱(专业版)
CSS工具箱(专业版)

全功能 CSS 工程手册,覆盖性能优化、无障碍、设计系统与跨浏览器兼容。

下载

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

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

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

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

2. 动态生成表头(thead)

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

标签,例如:
<table id="example" class="display dataTable cell-border" style="width:100%">
</table>

那么你需要在使用DataTables初始化之前,动态地创建并插入

元素。这是因为后续用于生成列过滤器的代码会克隆现有的表头行。

动态生成

的JavaScript代码:
// 根据headers数组动态生成<thead>元素
var th = '<thead><tr>';
headers.forEach(header => th = th + '<th>' + header.title + '</th>');
th = th + '</tr></thead>';
$(th).appendTo('#example');

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

和中,最后将其添加到id为example的表格中。

3. 实现每列搜索功能

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

核心逻辑步骤:

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

    $(document).ready(function() {
        const dataSet = [
            ['a', 'b', 'x'],
            ['c', 'd', 'y'],
            ['e', 'f', 'z']
        ];
        const headers = [
            { 'title': 'A' },
            { 'title': 'B' },
            { 'title': 'C' }
        ];
    
        // 1. 动态生成<thead>,如果HTML中没有定义
        var th = '<thead><tr>';
        headers.forEach(header => th = th + '<th>' + header.title + '</th>');
        th = th + '</tr></thead>';
        $(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('<input type="text" placeholder="' + title + '" />');
    
                    // 为输入框绑定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结构:

    <!doctype html>
    <html>
    <head>
      <meta charset="UTF-8">
      <title>DataTables列搜索教程</title>
      <!-- 引入jQuery库 -->
      <script src="https://code.jquery.com/jquery-3.5.1.js"></script>
      <!-- 引入DataTables JS和CSS -->
      <script src="https://cdn.datatables.net/1.10.22/js/jquery.dataTables.js"></script>
      <link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/1.10.22/css/jquery.dataTables.css">
      <!-- 示例样式,非必需 -->
      <link rel="stylesheet" type="text/css" href="https://datatables.net/media/css/site-examples.css">
    </head>
    <body>
      <div style="margin: 20px;">
        <!-- 你的表格容器 -->
        <table id="example" class="display dataTable cell-border" style="width:100%">
        </table>
      </div>
    </body>
    </html>

    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工具

    更多
    WorkBuddy

    一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

    Laper
    Laper Hot

    Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

    立刻MV
    立刻MV Hot

    立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

    切问学术

    切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

    创客贴AI

    创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

    蛙蛙写作

    一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

    Lovart
    Lovart Hot

    一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

    豆包大模型

    豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

    DeepSeek

    DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

    相关专题

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

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

    601

    2023.09.12

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

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

    1196

    2023.10.13

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

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

    2282

    2023.11.10

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

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

    2168

    2023.12.04

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

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

    493

    2023.12.06

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

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

    337

    2024.02.23

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

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

    806

    2024.02.23

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

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

    309

    2026.01.13

    Vite 项目如何打包和部署
    Vite 项目如何打包和部署

    Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

    100

    2026.10.28

    热门下载

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

    精品课程

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

    共14课时 | 1.6万人学习

    Bootstrap 5教程
    Bootstrap 5教程

    共46课时 | 6.1万人学习

    CSS教程
    CSS教程

    共754课时 | 99.7万人学习

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

    Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn