本教程详细介绍了如何在google apps script项目中，利用javascript为html表格实现多列数据筛选功能。通过迭代表格的每一行和每个单元格，实现用户输入文本在所有列中进行匹配，从而动态显示或隐藏符合条件的行，显著提升数据检索的灵活性和用户体验。
在Google Apps Script中开发Web应用时，将Google Sheets的数据展示到HTML表格中是一个常见需求。为了提升用户体验，通常会集成一个搜索或筛选功能，允许用户根据特定条件查找数据。然而，默认或简单实现的筛选功能可能仅限于某一列，这在面对需要全局搜索的场景时显得不足。本教程将指导您如何修改JavaScript代码，实现一个可以在HTML表格所有列中进行匹配的动态筛选功能。
原始筛选逻辑的局限性
在最初的实现中，筛选逻辑通常会针对表格的特定列进行文本匹配。例如，以下代码片段展示了仅在第二列（索引为1）进行搜索的情况：
function onInputChange(){
let inputText = document.getElementById("input-search").value.toString().toLowerCase();
let tableBody = document.getElementById("cursos");
let tableRows = tableBody.getElementsByTagName("tr");
for(let i = 0; i < tableRows.length; i++){
// 仅在第二列进行文本匹配
let textoConsulta = tableRows[i].cells[1].textContent.toString().toLowerCase();
if( textoConsulta.indexOf(inputText) === -1 ) {
tableRows[i].style.visibility = "collapse";
} else {
tableRows[i].style.visibility = "";
}
}
}这段代码通过tableRows[i].cells[1]明确指定了要搜索的单元格是当前行的第二个单元格。当用户希望在所有列中搜索时，这种单一列的匹配方式显然无法满足需求。简单地将cells[1]修改为cells[1,2,3...]并不能达到预期效果，因为cells属性返回的是一个HTMLCollection，需要通过循环来访问其中的每个元素。
实现多列筛选的逻辑
要实现多列筛选，核心思路是：对于表格中的每一行，我们需要遍历该行中的所有单元格（<td>元素），检查用户输入的文本是否存在于其中任何一个单元格内。只要在一个单元格中找到匹配项，该行就应该显示；如果遍历完所有单元格都没有找到匹配项，则该行应该被隐藏。
立即学习“前端免费学习笔记（深入）”；
代码实现
以下是经过优化和修改的JavaScript代码，实现了HTML表格的多列筛选功能：
function onInputChange() {
// 1. 获取用户输入的筛选文本，并转换为小写
let inputText = document.getElementById("input-search").value.toString().toLowerCase();
// 2. 获取表格的tbody元素和所有行
let tableBody = document.getElementById("cursos"); // 确保此ID与您的HTML表格ID匹配
let tableRows = tableBody.getElementsByTagName("tr");
// 3. 遍历表格的每一行
for (let i = 0; i < tableRows.length; i++) {
// 获取当前行的所有单元格（td元素）
let rowCells = tableRows[i].getElementsByTagName("td");
let foundMatch = false; // 标记当前行是否找到匹配项
// 4. 遍历当前行的所有单元格
for (let j = 0; j < rowCells.length; j++) {
// 获取单元格的文本内容，并转换为小写
let cellText = rowCells[j].textContent.toString().toLowerCase();
// 检查单元格文本是否包含用户输入的文本
if (cellText.indexOf(inputText) !== -1) {
foundMatch = true; // 找到匹配项
break; // 只要找到一个匹配项，就可以停止遍历当前行的其他单元格
}
}
// 5. 根据是否找到匹配项来设置行的可见性
if (foundMatch) {
tableRows[i].style.visibility = ""; // 显示行
} else {
tableRows[i].style.visibility = "collapse"; // 隐藏行
}
}
}关键点解析
-
获取输入文本和表格元素:
- document.getElementById("input-search").value.toString().toLowerCase()：获取搜索输入框的值，并将其转换为小写，以便进行不区分大小写的匹配。
- document.getElementById("cursos")：获取表格的tbody元素（或直接是<table>元素，取决于您的HTML结构），其ID必须与您的HTML中的实际ID相匹配。
- tableBody.getElementsByTagName("tr")：获取表格中所有的行。
-
外层循环遍历行:
- for (let i = 0; i < tableRows.length; i++)：这个循环负责逐行处理表格数据。
-
内层循环遍历单元格:
- let rowCells = tableRows[i].getElementsByTagName("td");：在每一行的内部，获取该行所有的<td>单元格。
- for (let j = 0; j < rowCells.length; j++)：这个内层循环负责遍历当前行的每一个单元格。
- let cellText = rowCells[j].textContent.toString().toLowerCase();：获取当前单元格的文本内容，同样转换为小写。
- if (cellText.indexOf(inputText) !== -1)：使用indexOf()方法检查单元格文本是否包含用户输入的文本。如果包含，indexOf()会返回匹配项的起始索引（非-1），表示找到匹配。
-
匹配标志位 foundMatch:
- let foundMatch = false;：在处理每一行之前，初始化一个布尔变量foundMatch为false。
- foundMatch = true; break;：一旦在当前行的任何一个单元格中找到匹配，就将foundMatch设置为true，并通过break语句立即跳出内层循环，因为我们已经确定这一行应该显示，无需再检查其他单元格。
-
设置行可见性:
- tableRows[i].style.visibility = "";：如果foundMatch为true，则将行的visibility样式设置为空字符串（等同于visible），使其显示。
- tableRows[i].style.visibility = "collapse";：如果foundMatch为false（即当前行所有单元格都未找到匹配），则将行的visibility样式设置为collapse，使其隐藏。collapse与display: none的区别在于，collapse通常用于表格行，可以更好地保持表格布局，但行的高度会被折叠为0。
注意事项
- HTML结构匹配: 确保您的HTML中搜索输入框的ID是input-search，并且表格（或其tbody）的ID是cursos。如果不匹配，请相应地修改JavaScript代码中的ID。
- 大小写敏感性: 代码中通过.toLowerCase()确保了搜索是不区分大小写的，这通常是用户期望的行为。
- 性能考量: 对于包含成千上万行的超大型表格，纯客户端JavaScript筛选可能会有性能瓶颈。在这种情况下，可以考虑结合Apps Script的服务器端功能，在后端对数据进行预筛选后再发送到前端显示。然而，对于大多数常见规模的表格，此客户端实现是高效且响应迅速的。
- 用户体验: 您可以添加一个加载指示器，或者在用户输入停止一段时间后（例如，使用debounce函数）再执行筛选，以避免在用户快速输入时频繁触发筛选操作，进一步优化用户体验。
总结
通过上述修改，您已经成功地将HTML表格的筛选功能从单一列扩展到所有列。这种多列搜索功能极大地提高了数据检索的灵活性和用户体验，使得用户能够更高效地在Google Apps Script Web应用中查找所需信息。此方法通用且易于集成，是构建功能丰富的Apps Script应用的重要组成部分。
