17370845950

新闻动态

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

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

1. 引言

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

2. 核心原理

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

3. HTML 结构准备

首先，我们需要一个搜索输入框和一个用于展示数据的HTML表格。表格的结构应包含表头（）和表体（

），这有助于更好地组织内容和提高可访问性。




  
  实时表格搜索过滤
   



  
  

  
  
    
      
        Id
        Bin
        Tür
        Banka Adı
        Type
        Name
        Oluşturma Tarihi
        Güncelleme Tarihi
      
    
    
      
      
        1
        123456
        类型A
        银行X
        Category1
        产品名称A
        2025-01-01
        2025-01-02
      
      
        2
        654321
        类型B
        银行Y
        Category2
        服务项目B
        2025-01-03
        2025-01-04
      
      
        3
        987654
        类型A
        银行Z
        Category1
        解决方案C
        2025-01-05
        2025-01-06

Id	Bin	Tür	Banka Adı	Type	Name	Oluşturma Tarihi	Güncelleme Tarihi
1	123456	类型A	银行X	Category1	产品名称A	2025-01-01	2025-01-02
2	654321	类型B	银行Y	Category2	服务项目B	2025-01-03	2025-01-04
3	987654	类型A	银行Z	Category1	解决方案C	2025-01-05	2025-01-06

关于数据填充： 在实际应用中，表格数据通常来自后端API（例如通过PHP获取JSON数据）。您可以使用PHP或其他后端语言将数据动态地填充到

标签中。例如，原始问题中的PHP代码片段展示了如何从JSON URL获取数据并将其渲染为表格行。这里我们使用静态示例数据来演示JavaScript过滤逻辑。

";
echo "";
echo "";
echo "IdBinTürBanka AdıTypeNameOluşturma TarihiGüncelleme Tarihi";
echo "";
echo "";
echo "";

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

4. CSS 样式（可选但推荐）

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

/* 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实现方法。

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个单元格（）。在HTML表格中，cells属性返回一个HTMLCollection，包含tr元素的所有或子元素。索引从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()"
//

代码解释：

onkeyup="myFunction()": 直接在HTML元素上绑定事件处理器，当用户释放键盘按键时触发myFunction。
tr = table.getElementsByTagName("tr"): 获取表格中的所有tr元素，包括中的表头行。
for (i = 1; i
tr[i].style.display = "": 将行的display样式设置为空字符串，使其恢复默认显示（通常是table-row）。
tr[i].style.display = "none": 隐藏行。

6. 注意事项与最佳实践

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

7. 总结

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