0

0

如何在使用 AJAX 的 DataTable 中正确清除所有筛选条件

霞舞

霞舞

发布时间:2026-03-05 19:51:11

|

487人浏览过

|

来源于php中文网

原创

如何在使用 AJAX 的 DataTable 中正确清除所有筛选条件

本文详解如何在基于 ajax 的 datatable 实例中,通过点击“clear all”按钮彻底重置自定义表单筛选(如多选下拉框)并刷新表格数据,避免仅清空表单却未触发服务端重新查询的常见问题。

本文详解如何在基于 ajax 的 datatable 实例中,通过点击“clear all”按钮彻底重置自定义表单筛选(如多选下拉框)并刷新表格数据,避免仅清空表单却未触发服务端重新查询的常见问题。

在使用 DataTable 配合 AJAX 进行服务端分页与筛选时,一个典型痛点是:用户点击

根本原因在于原代码中的错误写法:

$('#clear').table().search('').draw();

该语句存在两处关键错误:

易森网络企业版
易森网络企业版

如果您是新用户,请直接将本程序的所有文件上传在任一文件夹下,Rewrite 目录下放置了伪静态规则和筛选器,可将规则添加进IIS,即可正常使用,不用进行任何设置;(可修改图片等)默认的管理员用户名、密码和验证码都是:yeesen系统默认关闭,请上传后登陆后台点击“核心管理”里操作如下:进入“配置管理”中的&ld

下载
  • $('#clear') 选择的是按钮元素本身,它没有 .table() 方法(DataTable 实例绑定在 #table 上);
  • .search('') 是用于 DataTable 内置全局搜索框的 API,对自定义表单字段(如 .product 下拉框)完全无效。

✅ 正确解法是:监听清空按钮点击事件 → 手动重置表单字段 → 触发 DataTable 的 AJAX 重载(ajax.reload()),确保服务端接收到干净的请求参数。

完整修复代码示例

$(document).ready(function() {
    // 初始化 DataTable
    var table = $('#table').DataTable({
        ajax: {
            url: 'search.php',
            method: 'POST',
            data: function(d) {
                // 将表单当前值注入 AJAX 请求参数
                d.busca_product = $('.product').val() || [];
            }
        },
        processing: true,
        serverSide: true,
        dom: 'Plfrtip',
        columns: [
            { data: 'product_id' },
            { data: 'product_name' },
            { data: 'status' }
        ],
        deferRender: true
    });

    // 监听下拉框变更,实时刷新表格
    $('.product').on('change', function() {
        table.draw(); // 触发重绘,自动携带最新 form 值
    });

    // ✅ 关键修复:为 Clear All 按钮绑定自定义清空逻辑
    $('#clear').on('click', function(e) {
        e.preventDefault(); // 阻止默认 reset 行为(可选,保留亦可)

        // 1. 清空表单字段(重置 select)
        $('.product').val(null).trigger('change');

        // 2. 强制重载 AJAX 数据(发送空/默认参数)
        table.ajax.reload(null, false); // 第二个参数 false 表示不重置分页(保持当前页)
    });
});

注意事项与最佳实践

  • 不要依赖 type="reset" 的默认行为:HTML 表单重置不会触发 JavaScript 事件监听,也无法同步 DataTable 状态。
  • 显式调用 trigger('change'):清空
  • ajax.reload() vs draw()
    • table.draw() 仅重新执行当前 ajax.data 函数并发起请求,适合表单值已更新的场景;
    • table.ajax.reload() 更明确、更安全,尤其在需要强制丢弃缓存参数时推荐使用。
  • 服务端兼容性:确保 search.php 能正确处理 busca_product 为空数组或 null 的情况(例如 SQL 中生成 WHERE product_id IN (...) 时做空值判断)。

通过以上方案,点击“Clear All”将真正实现:表单控件归零 + DataTable 服务端请求刷新 + 表格展示全量数据,达成符合用户预期的一站式清空体验。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

1090

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

340

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

380

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2028

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

379

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

1580

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

585

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

438

2024.04.29

Rust内存安全机制与所有权模型深度实践
Rust内存安全机制与所有权模型深度实践

本专题围绕 Rust 语言核心特性展开,深入讲解所有权机制、借用规则、生命周期管理以及智能指针等关键概念。通过系统级开发案例,分析内存安全保障原理与零成本抽象优势,并结合并发场景讲解 Send 与 Sync 特性实现机制。帮助开发者真正理解 Rust 的设计哲学,掌握在高性能与安全性并重场景中的工程实践能力。

4

2026.03.05

热门下载

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

精品课程

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

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