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

实现基于JavaScript的实时表格搜索过滤功能教程

夜婷大大_3456

夜婷大大_3456

发布时间:2025-11-14 13:01:12

|

722人浏览过

|

来源于php中文网

原创

实现基于JavaScript的实时表格搜索过滤功能教程

本教程详细介绍了如何利用javascript实现网页表格的实时搜索过滤功能,无需用户按下回车键即可动态更新显示结果。文章涵盖了html结构、css样式以及两种javascript实现方案:一种是现代简洁的事件监听方法,另一种是传统的`onkeyup`函数方法,并提供了代码示例和关键注意事项,帮助开发者构建高效的用户界面。

1. 引言

在现代Web应用中,用户经常需要从大量数据中快速查找特定信息。对于以表格形式展示的数据,提供一个实时搜索过滤功能可以极大地提升用户体验。本文将指导您如何使用纯JavaScript在客户端实现这一功能,当用户在搜索框中输入内容时,表格数据会即时根据输入进行筛选,而无需点击任何按钮或按下回车键。

2. 核心原理

实时搜索过滤的核心原理是监听搜索输入框的输入事件,每当输入框内容发生变化时,就遍历表格中的每一行数据。对于每一行,检查其特定列的内容是否包含搜索关键词。如果包含,则显示该行;如果不包含,则隐藏该行。

3. HTML 结构准备

首先,我们需要一个搜索输入框和一个用于展示数据的HTML表格。表格的结构应包含表头(<thead>)和表体(<tbody>),这有助于更好地组织内容和提高可访问性。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>实时表格搜索过滤</title>
  <link rel="stylesheet" href="style.css"> <!-- 引入CSS样式 -->
</head>
<body>

  <!-- 搜索输入框 -->
  <input type="text" id="myInput" placeholder="在此搜索..." title="输入关键词进行搜索" autocomplete="off" />

  <!-- 数据表格 -->
  <table id="myTable">
    <thead>
      <tr class="header">
        <th>Id</th>
        <th>Bin</th>
        <th>Tür</th>
        <th>Banka Adı</th>
        <th>Type</th>
        <th>Name</th>
        <th>Oluşturma Tarihi</th>
        <th>Güncelleme Tarihi</th>
      </tr>
    </thead>
    <tbody>
      <!-- 以下是示例数据行,实际数据可以通过后端PHP或JS动态加载 -->
      <tr>
        <td>1</td>
        <td>123456</td>
        <td>类型A</td>
        <td>银行X</td>
        <td>Category1</td>
        <td>产品名称A</td>
        <td>2023-01-01</td>
        <td>2023-01-02</td>
      </tr>
      <tr>
        <td>2</td>
        <td>654321</td>
        <td>类型B</td>
        <td>银行Y</td>
        <td>Category2</td>
        <td>服务项目B</td>
        <td>2023-01-03</td>
        <td>2023-01-04</td>
      </tr>
      <tr>
        <td>3</td>
        <td>987654</td>
        <td>类型A</td>
        <td>银行Z</td>
        <td>Category1</td>
        <td>解决方案C</td>
        <td>2023-01-05</td>
        <td>2023-01-06</td>
      </tr>
      <!-- 更多数据行... -->
    </tbody>
  </table>

  <script src="script.js"></script> <!-- 引入JavaScript文件 -->
</body>
</html>

关于数据填充: 在实际应用中,表格数据通常来自后端API(例如通过PHP获取JSON数据)。您可以使用PHP或其他后端语言将数据动态地填充到<tbody>标签中。例如,原始问题中的PHP代码片段展示了如何从JSON URL获取数据并将其渲染为表格行。这里我们使用静态示例数据来演示JavaScript过滤逻辑。

<?php
// 假设这是您的PHP代码,用于从API获取数据并渲染表格
$json_url = "websitename"; // 替换为您的API地址
$json = file_get_contents($json_url);
$data = json_decode($json, TRUE);

echo "<table id='myTable'>";
echo "<thead>";
echo "<tr class='header'>";
echo "<th>Id</th><th>Bin</th><th>Tür</th><th>Banka Adı</th><th>Type</th><th>Name</th><th>Oluşturma Tarihi</th><th>Güncelleme Tarihi</th>";
echo "</tr>";
echo "</thead>";
echo "<tbody>";

foreach($data as $record) {
 echo "<tr>";
 echo "<td>" . htmlspecialchars($record["id"]) . "</td>";
 echo "<td>" . htmlspecialchars($record["bin"]) . "</td>";
 echo "<td>" . htmlspecialchars($record["tur"]) . "</td>";
 echo "<td>" . htmlspecialchars($record["banka_adi"]) . "</td>";
 echo "<td>" . htmlspecialchars($record["type"]) . "</td>";
 echo "<td>" . htmlspecialchars($record["name"]) . "</td>";
 echo "<td>" . htmlspecialchars($record["created_at"]) . "</td>";
 echo "<td>" . htmlspecialchars($record["updated_at"]) . "</td>";
 echo "</tr>";
}
echo "</tbody>";
echo "</table>";
?>

4. CSS 样式(可选但推荐)

为了使表格和搜索框具有更好的视觉效果,可以添加一些基本的CSS样式。

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

/* style.css */
* {
  box-sizing: border-box;
}

#myInput {
  background-image: url('/css/searchicon.png'); /* 搜索图标,根据实际路径调整 */
  background-position: 10px 10px;
  background-repeat: no-repeat;
  width: 100%;
  font-size: 16px;
  padding: 12px 20px 12px 40px; /* 留出空间给图标 */
  border: 1px solid #ddd;
  margin-bottom: 12px;
}

#myTable {
  border-collapse: collapse; /* 合并边框 */
  width: 100%;
  border: 1px solid #ddd;
  font-size: 18px;
}

#myTable th,
#myTable td {
  text-align: left;
  padding: 12px;
}

#myTable tr {
  border-bottom: 1px solid #ddd;
}

#myTable tr.header,
#myTable tbody tr:hover { /* 表头和鼠标悬停行背景色 */
  background-color: #f1f1f1;
}

5. JavaScript 实现实时过滤

我们将介绍两种JavaScript实现方法。

OpenJDK 24
OpenJDK 24

OpenJDK 24 Windows x64 官方参考实现(24+36),适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。

下载

5.1 方法一:使用现代事件监听器(推荐)

这种方法使用addEventListener('input')来监听输入框的实时变化,并利用row.hidden属性来控制行的显示与隐藏,代码更加简洁和现代化。

// script.js
window.addEventListener("load", () => {
  const searchInput = document.getElementById("myInput");
  const tableBodyRows = document.querySelectorAll("#myTable tbody tr"); // 选择tbody下的所有行

  searchInput.addEventListener("input", (e) => {
    const filter = e.target.value.toUpperCase(); // 获取输入值并转为大写,用于不区分大小写的搜索

    tableBodyRows.forEach(row => {
      // 假设我们要在表格的第6列(索引为5)进行搜索
      // 注意:row.cells 是一个 HTMLCollection,包含当前行的所有 td 元素
      const targetCell = row.cells[5]; // 获取第6个单元格 (索引从0开始)

      if (targetCell) {
        const cellText = targetCell.textContent || targetCell.innerText;
        // 如果有过滤条件且单元格内容不包含过滤条件,则隐藏该行
        row.hidden = filter && !cellText.toUpperCase().includes(filter);
      }
    });
  });
});

代码解释:

  • window.addEventListener("load", ...): 确保DOM完全加载后再执行JavaScript,避免因元素未加载而导致的错误。
  • searchInput.addEventListener("input", ...): 监听myInput输入框的input事件。这个事件在输入框的值发生任何变化时都会触发,包括粘贴、剪切、拖放等,比keyup更全面。
  • e.target.value.toUpperCase(): 获取当前输入框的值,并将其转换为大写,以便进行不区分大小写的搜索。
  • document.querySelectorAll("#myTable tbody tr"): 选中id为myTable的表格中tbody下的所有tr元素。
  • forEach(row => { ... }): 遍历所有表格行。
  • row.cells[5]: 获取当前行的第6个单元格(<td>)。在HTML表格中,cells属性返回一个HTMLCollection,包含tr元素的所有<td>或<th>子元素。索引从0开始,所以第6列是索引5。
  • cellText.toUpperCase().includes(filter): 检查单元格的文本内容(转换为大写后)是否包含过滤关键词。
  • row.hidden = ...: 这是控制行显示/隐藏的关键。当row.hidden设置为true时,元素会被隐藏;设置为false时,元素会显示。这种方法比直接修改style.display更简洁。

5.2 方法二:使用传统的 onkeyup 函数

这种方法与原始问题中尝试的方法类似,通过onkeyup事件调用一个全局函数来执行过滤。

// script.js
function myFunction() {
  var input, filter, table, tr, td, i, txtValue;
  input = document.getElementById("myInput");
  filter = input.value.toUpperCase();
  table = document.getElementById("myTable");
  tr = table.getElementsByTagName("tr"); // 获取所有行,包括表头

  // 遍历所有表格行,从索引1开始,跳过表头行
  for (i = 1; i < tr.length; i++) {
    // 假设我们要在表格的第6列(索引为5)进行搜索
    td = tr[i].getElementsByTagName("td")[5]; 
    if (td) {
      txtValue = td.textContent || td.innerText; // 获取单元格文本内容
      if (txtValue.toUpperCase().indexOf(filter) > -1) {
        tr[i].style.display = ""; // 如果匹配,则显示该行
      } else {
        tr[i].style.display = "none"; // 如果不匹配,则隐藏该行
      }
    }
  }
}

// 在HTML中,需要在input标签上添加 onkeyup="myFunction()"
// <input type="text" id="myInput" onkeyup="myFunction()" placeholder="在此搜索..." title="输入关键词进行搜索" autocomplete="off" />

代码解释:

  • onkeyup="myFunction()": 直接在HTML元素上绑定事件处理器,当用户释放键盘按键时触发myFunction。
  • tr = table.getElementsByTagName("tr"): 获取表格中的所有tr元素,包括<thead>中的表头行。
  • for (i = 1; i < tr.length; i++): 循环从索引1开始,跳过第一个tr元素(通常是表头)。
  • tr[i].style.display = "": 将行的display样式设置为空字符串,使其恢复默认显示(通常是table-row)。
  • tr[i].style.display = "none": 隐藏行。

6. 注意事项与最佳实践

  1. ID 匹配: 确保JavaScript中引用的元素ID(如myInput, myTable)与HTML中的ID完全一致,包括大小写。这是常见的错误来源。
  2. 搜索列选择: row.cells[index]中的index决定了您要搜索哪一列的数据。请根据您的表格结构和需求调整此索引。
  3. 性能优化: 对于包含成千上万行数据的大型表格,客户端JavaScript过滤可能会导致性能问题。在这种情况下,考虑将过滤逻辑放在服务器端实现,每次输入时向服务器发送请求并返回过滤后的数据。
  4. 事件选择:
    • input事件(推荐):在输入框值改变时立即触发,提供最实时的体验。
    • keyup事件:在键盘按键释放时触发。可能无法捕获所有值变化(例如通过鼠标粘贴)。
  5. 语义化HTML: 使用<thead>和<tbody>标签可以使表格结构更清晰,也方便JavaScript精确选择要操作的行(例如,#myTable tbody tr)。
  6. 可访问性:
    • 为input标签添加placeholder和title属性,提供清晰的提示。
    • autocomplete="off"可以防止浏览器自动填充搜索框,这在某些实时搜索场景下是希望的。
  7. 错误处理: 在实际项目中,可能需要添加更多的错误处理,例如检查td是否存在,以防止在某些行没有足够列时脚本出错。

7. 总结

通过本教程,您应该已经掌握了两种在网页表格中实现实时搜索过滤的方法。推荐使用现代的addEventListener('input')配合row.hidden属性的方法,因为它更简洁、更高效且能捕获所有输入变化。选择适合您项目需求的方法,并结合最佳实践,可以为用户提供一个流畅、高效的数据查找体验。

热门AI工具

更多
DeepSeek

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

WorkBuddy

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

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

PixTV
PixTV Hot

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

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

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

立刻MV
立刻MV Hot

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

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2115

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3182

2023.08.23

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

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

1076

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3619

2025.09.10

php中foreach用法
php中foreach用法

本专题整合了php中foreach用法的相关介绍,阅读专题下面的文章了解更多详细教程。

758

2025.12.04

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1718

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2624

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6024

2023.10.24

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

0

2026.10.16

热门下载

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

精品课程

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

共14课时 | 1.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 5.9万人学习

CSS教程
CSS教程

共754课时 | 97.4万人学习

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

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