如何获取 HTML 元素的完整文本内容(含 input 输入值)

9次阅读

如何获取 HTML 元素的完整文本内容(含 input 输入值)

本文介绍一种健壮、递归式的 jquery 方法,用于获取任意 dom 元素及其子元素的全部可见文本内容,**同时自动包含 ``、`

在实现前端搜索过滤功能时,常见误区是仅依赖 $(elem).text() 获取文本——该方法忽略所有表单元素的 value 属性,导致用户在 中输入的内容无法被搜索匹配。例如,一个包含

姓名:

的表格行,.text() 仅返回 “姓名:”, 而丢失 “张三”。

为彻底解决此问题,推荐使用原生 DOM 递归遍历 + 智能内容提取的方式,替代简单拼接 .text() 与手动 .val() 的“补丁式”方案。核心逻辑如下:

  • 遍历目标元素的所有 childnodes(包括文本节点、元素节点等);
  • 对每个子节点:
    • 若为表单控件(如 input、textarea、select),取其 value 属性(支持实时输入);
    • 若为普通元素节点且有 textContent,取其 textContent;
    • 若为纯文本节点,直接取 nodeValue;
  • 递归处理所有子树,最终拼接为完整字符串

以下是生产就绪的实现代码:

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 行为差异。

该方案已验证兼容 chromefirefoxedgesafari,是构建高可用前端搜索过滤功能的推荐实践。

text=ZqhQzanResources