
本文介绍一种健壮、递归式的 jquery 方法,用于获取任意 dom 元素及其子元素的全部可见文本内容,**同时自动包含 ``、`
在实现前端搜索过滤功能时,常见误区是仅依赖 $(elem).text() 获取文本——该方法忽略所有表单元素的 value 属性,导致用户在 中输入的内容无法被搜索匹配。例如,一个包含
的表格行,.text() 仅返回 “姓名:”, 而丢失 “张三”。
为彻底解决此问题,推荐使用原生 DOM 递归遍历 + 智能内容提取的方式,替代简单拼接 .text() 与手动 .val() 的“补丁式”方案。核心逻辑如下:
以下是生产就绪的实现代码:
function getText(elem) { let result = ''; // 遍历所有子节点(包括文本节点、元素节点、注释节点等) for (let i = 0; i < elem.childNodes.length; i++) { const node = elem.childNodes[i]; if (node.nodeType === Node.ELEMENT_NODE) { // 元素节点:优先取 value(适用于 input/select/textarea),否则取 textContent if ('value' in node && typeof node.value === 'string') { result += node.value; } else { result += node.textContent || ''; } // 递归处理子元素(如嵌套 div、span 等) result += getText(node); } else if (node.nodeType === Node.TEXT_NODE) { // 文本节点:直接添加内容(已去空格,可选 trim) result += node.nodeValue.trim(); } // 忽略注释节点(Node.COMMENT_NODE)、CDATA 等非内容节点 } return result; } // 搜索过滤主函数(jquery 封装) function searchFilter(root, selector, regex) { root.find(selector).each(function () { const fullText = getText(this); // ✅ 包含 input.value 和所有文本 $(this).toggle(regex.test(fullText)); }); } // 使用示例:监听搜索框 $('#search-input').on('input', function() { const keyword = $(this).val().trim(); if (!keyword) return; const re = new RegExp(keyword.replace(/[.*+?^${}()|[]\]/g, '\$&'), 'i'); // 转义正则特殊字符 searchFilter($('#content'), '.searchable-item', re); });
✅ 关键优势:
立即学习“前端免费学习笔记(深入)”;
- ✅ 真正递归:支持任意嵌套结构(如 div > form > table > tr > td > input);
- ✅ 类型安全:通过 node.nodeType 判断节点类型,避免对 NULL 或非元素调用 .value;
- ✅ 兼容主流表单控件:自动识别 input、textarea、select 的 value;
- ✅ 无 jQuery 依赖(核心逻辑):getText 为纯 js 函数,轻量且高效;
- ✅ 支持实时搜索:因读取的是 value 属性,而非 defaultValue,可响应用户实时输入。
⚠️ 注意事项:
- 避免在大型 DOM 树上高频调用(如每毫秒触发),建议加防抖(debounce);
- 如需排除特定子元素(如隐藏的 .no-search 区域),可在 getText 中增加 node.classlist.contains('no-search') 判断;
- 对于富文本编辑器(如 contenteditable 元素),需额外处理 innerText 或 textContent 行为差异。
该方案已验证兼容 chrome、firefox、edge 及 safari,是构建高可用前端搜索过滤功能的推荐实践。