0

0

jQuery 数据筛选与动态分页的事件绑定最佳实践

霞舞

霞舞

发布时间:2026-02-25 09:01:17

|

556人浏览过

|

来源于php中文网

原创

jQuery 数据筛选与动态分页的事件绑定最佳实践

本文详解如何在 jQuery(或原生 JavaScript)中正确实现 data-filter 属性驱动的动态内容筛选,并解决因内联 onclick 导致的事件失效问题,推荐使用事件委托或动态监听替代硬编码调用。

本文详解如何在 jquery(或原生 javascript)中正确实现 `data-filter` 属性驱动的动态内容筛选,并解决因内联 `onclick` 导致的事件失效问题,推荐使用事件委托或动态监听替代硬编码调用。

在构建响应式作品集、图库或分类列表时,常需结合 data-filter 属性与前端筛选逻辑(如 Isotope、MixItUp 或自定义过滤),同时配合分页导航实现按“页码”切换内容区块(例如 .pagi-1、.pagi-2)。但开发者常遇到一个典型陷阱:通过 JavaScript 动态生成带 onclick="test(...)" 的分页链接后,首次点击有效,后续点击却不再触发筛选——根本原因在于:每次调用 test() 会重新 innerHTML = pagicode,导致已绑定的事件监听器被销毁,而新插入的 DOM 元素未重新绑定事件。

✅ 正确解法:避免内联事件,改用事件委托或动态监听

内联 onclick 不仅破坏 HTML 与 JS 关注点分离原则,更在 DOM 重写后完全失效。推荐以下两种健壮方案:

方案一:使用事件委托(推荐,尤其适用于动态内容)

利用父容器监听冒泡事件,无需为每个链接单独绑定,天然支持未来新增元素:

HIX.AI
HIX.AI

HIX.AI是一个多功能的一体化AI写作助手,集成了120多种AI写作工具,支持50多种语言,能够满足各种写作需求。

下载
// 假设分页容器具有 class="portfolio__filter__pagi"
document.querySelector('.portfolio__filter__pagi').addEventListener('click', function (e) {
  if (e.target.tagName === 'A' && e.target.hasAttribute('data-filter')) {
    e.preventDefault();
    const filterValue = e.target.getAttribute('data-filter');

    // 执行筛选逻辑(示例:显示对应 pagi-* 类的内容,隐藏其余)
    document.querySelectorAll('.portfolio__gallery .mix').forEach(el => {
      el.style.display = el.classList.contains(filterValue.replace('.', '')) ? 'block' : 'none';
    });

    // 可选:高亮当前激活项
    this.querySelectorAll('a').forEach(a => a.classList.remove('active'));
    e.target.classList.add('active');
  }
});

方案二:生成后统一绑定(适配原有结构)

若需保留 test() 函数生成 HTML 的逻辑,应在 innerHTML 赋值后,立即遍历并为新节点添加事件监听器(而非依赖 onclick):

const pagiselector = document.querySelector(".portfolio__filter__pagi");

function test(totalPages, page) {
  let pagicode = "";

  // 构建分页 HTML(此处简化,实际可扩展 prev/next/ellipsis 等逻辑)
  for (let i = 1; i <= totalPages; i++) {
    const isActive = i === page ? ' active' : '';
    pagicode += `<a href="#" class="number__pagination filter${isActive}" 
                    data-filter=".pagi-${i}" 
                    data-page="${i}">
                  <li>${i}</li>
                </a>`;
  }

  // ⚠️ 关键:先写入 DOM,再绑定事件
  pagiselector.innerHTML = pagicode;

  // 为所有新生成的分页链接绑定点击事件
  pagiselector.querySelectorAll('a[data-filter]').forEach(link => {
    link.addEventListener('click', function (e) {
      e.preventDefault();
      const targetFilter = this.getAttribute('data-filter');
      const targetPage = parseInt(this.getAttribute('data-page'));

      // 执行筛选(示例:显示目标页内容)
      document.querySelectorAll('.portfolio__gallery .mix').forEach(item => {
        item.style.display = item.matches(targetFilter) ? 'block' : 'none';
      });

      // 更新 UI 状态(如高亮当前页)
      pagiselector.querySelectorAll('a').forEach(a => a.classList.remove('active'));
      this.classList.add('active');

      // 可选:触发自定义事件,便于解耦
      document.dispatchEvent(new CustomEvent('pageChanged', {
        detail: { page: targetPage, filter: targetFilter }
      }));
    });
  });
}

// 初始化第 1 页
test(6, 1);

? 注意事项与最佳实践

  • 不要混用 onclick 与 addEventListener:内联事件会覆盖或干扰现代事件处理逻辑,应彻底移除。
  • data-filter 值需与目标元素 class 严格匹配:如 data-filter=".pagi-2" 对应
    ,注意点号 . 在 CSS 选择器中表示 class,但在 matches() 或 querySelector 中需去掉(或使用 classList.contains() 更安全)。
  • 性能优化:对大量项目筛选时,避免频繁操作 style.display,建议切换 CSS 类(如 .hidden { display: none; })或使用 DocumentFragment 批量更新。
  • jQuery 用户提示:若项目已引入 jQuery,可更简洁地使用事件委托:
    $('.portfolio__filter__pagi').on('click', 'a[data-filter]', function(e) {
      e.preventDefault();
      const filter = $(this).data('filter');
      $('.portfolio__gallery .mix').hide().filter(filter).show();
    });
  • ✅ 总结

    动态分页 + data-filter 的核心在于 事件绑定时机与方式。放弃内联 onclick,转向事件委托或生成后批量监听,不仅能解决“点击一次失效”问题,更能提升代码可维护性与扩展性。无论是否使用 jQuery,遵循“HTML 定义数据、JS 处理逻辑、CSS 控制样式”的分离原则,是构建健壮前端交互的基础。

热门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插件相关的文章、下载、课程内容,供大家免费下载体验。

155

2023.09.12

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

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

323

2023.10.13

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

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

404

2023.11.10

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

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

513

2023.12.04

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

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

291

2023.12.06

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

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

126

2024.02.23

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

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

180

2024.02.23

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

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

50

2026.01.13

Golang 生态工具与框架:扩展开发能力
Golang 生态工具与框架:扩展开发能力

《Golang 生态工具与框架》系统梳理 Go 语言在实际工程中的主流工具链与框架选型思路,涵盖 Web 框架、RPC 通信、依赖管理、测试工具、代码生成与项目结构设计等内容。通过真实项目场景解析不同工具的适用边界与组合方式,帮助开发者构建高效、可维护的 Go 工程体系,并提升团队协作与交付效率。

1

2026.02.24

热门下载

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

精品课程

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

共42课时 | 6.6万人学习

HTML+CSS基础与实战
HTML+CSS基础与实战

共132课时 | 11.6万人学习

tp6+adminlte搭建通用后台
tp6+adminlte搭建通用后台

共39课时 | 5.8万人学习

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

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