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

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

老婷君_7952

老婷君_7952

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

|

616人浏览过

|

来源于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 重写后完全失效。推荐以下两种健壮方案:

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

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

jQuery 1.12.4
jQuery 1.12.4

jQuery 1.12.4是jQuery 1.x系列的最后一个正式稳定版本,由jQuery团队于2016年发布。该版本主要面向需要兼容旧版浏览器环境的网站和Web应用,尤其适用于仍需支持Internet Explorer 6、Internet Explorer 7、Internet Explorer 8等老旧浏览器的项目。

下载
// 假设分页容器具有 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工具

更多
WorkBuddy

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

豆包大模型

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

蛙蛙写作

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

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

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

切问学术

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

立刻MV
立刻MV Hot

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

墨刀AI
墨刀AI Hot

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

621

2023.09.12

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

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

1236

2023.10.13

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

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

2322

2023.11.10

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

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

2168

2023.12.04

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

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

513

2023.12.06

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

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

337

2024.02.23

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

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

886

2024.02.23

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

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

309

2026.01.13

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
jQuery官方API文档
jQuery官方API文档

共0课时 | 0人学习

jQuery 教程
jQuery 教程

共42课时 | 16.7万人学习

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

共132课时 | 19.6万人学习

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

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