遍历HTML元素所有属性的JavaScript实现方法

作者:微光时间:2026-11-20 09:15:55浏览:340

详细讲解在JavaScript中遍历HTML元素所有属性的四种实现方法,深入剖析NamedNodeMap底层对象模型、迭代器特性、动态集合避坑技巧以及数据对象序列化实战。

前端开发 / DOM 核心规范
在 JavaScript 中,遍历 HTML 元素全部特性的核心路径是获取该元素的 attributes 集合或调用 getAttributeNames() 原生方法。通过现代 for...of 语法可以直接解构提取属性键值,借助 Array.from() 能够生成便于函数式处理的不可变快照,而通过 Object.fromEntries() 则能一行代码将全部属性整理为标准键值对象。理解 DOM 的 NamedNodeMap 类数组特性及其动态集合行为,是安全高效操作属性的关键前提。
遍历HTML元素所有属性的JavaScript实现方法
图 1:HTML 元素标记源码解析至 DOM Attr 属性节点集合的映射流水线

一、DOM 属性的底层载体:认识 NamedNodeMap 与 Attr 节点

在 HTML 文档中,任何写在标签起始部位的键值标记(例如 id="app"、class="container"、data-role="dialog" 以及 disabled)在被浏览器解析后,都会作为该元素节点的属性存储。当我们在 JavaScript 中获取到一个 DOM 元素实例后,访问其 element.attributes 属性,便能获得该元素上定义的所有属性。

需要明确的是,element.attributes 既不是 JavaScript 原生的普通数组(Array),也不是一个纯键值对象(Object),而是一个 NamedNodeMap(命名节点映射表)。

遍历HTML元素所有属性的JavaScript实现方法
图 2:HTMLElement 属性访问模型:NamedNodeMap 集合路线与 getAttributeNames 原生数组路线

NamedNodeMap 具备以下三个关键的技术特征:

  • 类数组对象(Array-like Object):它具有 length 属性,并且支持通过从 0 到 length - 1 的数字索引直接读取元素,或者调用 item(index) 方法。
  • 每个单元为 Attr 节点:集合中的每一项都是一个独立的 DOM Attr 节点对象,核心包含 name(属性名字符串,如 "class")和 value(属性值字符串,如 "btn primary")。
  • 实现了迭代协议(Symbol.iterator):在现代 ECMAScript 规范中,NamedNodeMap 原生内置了可迭代协议,这意味着开发者可以直接对它使用 for...of 循环,或通过扩展运算符与 Array.from() 展开。
核心概念边界:HTML Attribute 与 DOM Property
HTML 属性(Attribute)是指写在 HTML 标记中的字符串键值,由 attributes 集合及 getAttribute() 访问;而 DOM 属性(Property)是挂载在 JavaScript 内存中 DOM 对象实例上的普通属性(例如 element.innerHTML、element.onclick、element.style)。遍历 HTML 标记属性时必须使用针对 Attribute 的专用 API,切忌使用 for...in 遍历 DOM 元素实例。

二、遍历 HTML 元素属性的四种实现方法与代码演示

围绕 NamedNodeMap 与现代 DOM 规范,前端开发中共有四种实用、可靠的遍历实现方案。以下我们以一个包含多种代表性属性的 HTML 元素作为统一示例进行详细演示:

<!-- 示例目标 DOM 结构 -->
<input 
  id="search-input" 
  class="form-control active" 
  type="search" 
  placeholder="请输入搜索关键词..." 
  data-module="header-search" 
  data-limit="20" 
  autocomplete="off" 
  required
>
遍历HTML元素所有属性的JavaScript实现方法
图 3:JavaScript 遍历提取 HTML 属性的标准四步执行逻辑

方法 1:使用 for...of 循环直接迭代 attributes(现代开发首选)

这是目前最直观、可读性最高的写法。由于 NamedNodeMap 原生实现了可迭代接口,我们可以直接使用 for...of 循环逐项获取 Attr 节点,并利用对象解构直接提取 name 和 value。

const inputEl = document.querySelector('#search-input');

// 直接利用 for...of 迭代元素属性集合
for (const { name, value } of inputEl.attributes) {
  console.log(`属性名: ${name} | 属性值: ${value}`);
}

控制台示例输出:

属性名: id           | 属性值: search-input
属性名: class        | 属性值: form-control active
属性名: type         | 属性值: search
属性名: placeholder  | 属性值: 请输入搜索关键词...
属性名: data-module  | 属性值: header-search
属性名: data-limit   | 属性值: 20
属性名: autocomplete | 属性值: off
属性名: required     | 属性值: 

方法 2:使用 Array.from() 转为普通数组(数据处理利器)

element.attributes 作为一个类数组集合,并不具备原生数组的 map、filter、reduce 等高阶方法。如果我们希望对属性进行过滤筛选、模式匹配,或者将整个元素的所有属性打包成一个标准的 JavaScript 键值对象,先使用 Array.from() 进行浅拷贝是最佳方案。

const inputEl = document.querySelector('#search-input');

// 1. 借助 Array.from 转换为静态数组后使用 forEach
const attrArray = Array.from(inputEl.attributes);
attrArray.forEach(attr => {
  console.log(attr.name, attr.value);
});

// 2. 筛选所有 data-* 自定义数据属性
const dataAttrs = attrArray
  .filter(a => a.name.startsWith('data-'))
  .map(a => ({ key: a.name, val: a.value }));

// 3. 一行代码将全部属性转为纯对象
const attrObject = Object.fromEntries(
  Array.from(inputEl.attributes, a => [a.name, a.value])
);
console.log('属性对象映射:', attrObject);

方法 3:调用原生的 element.getAttributeNames()(字符串数组直接获取)

在较新的 DOM Living Standard 规范中,浏览器为 Element 接口新增了 getAttributeNames() 方法。调用此方法会直接返回一个由当前元素所有属性名称构成的标准 JavaScript 字符串数组(Array<string>)。

const inputEl = document.querySelector('#search-input');

// 直接获取属性名数组并遍历
const names = inputEl.getAttributeNames();

names.forEach(name => {
  const value = inputEl.getAttribute(name);
  console.log(`${name} => ${value}`);
});

此方法的显著优势在于:当业务逻辑只需要检查、收集元素拥有哪些属性名称时,无需实例化或接触 Attr 节点,直接获得了纯字符串数组;在需要值的时候配合标准的 getAttribute(name) 提取即可。

方法 4:传统数字索引 for 循环(经典向下兼容)

对于需要向下兼容非常早期浏览器版本(例如早于 ES6 的旧运行环境),或者在极致追求基础循环指令效率的底层类库中,可以通过 attributes.length 搭配传统 for 循环按索引下标访问。

var inputEl = document.getElementById('search-input');
var attrs = inputEl.attributes;

for (var i = 0; i < attrs.length; i++) {
  var attrNode = attrs[i]; // 亦可写为 attrs.item(i)
  console.log(attrNode.name, attrNode.value);
}
遍历HTML元素所有属性的JavaScript实现方法
图 4:四种属性遍历方式的语法表现、适用场景与横向选型对比
遍历方案 返回数据形态 代码可读性 安全性(防修改漂移) 推荐应用场景
for...of 循环 逐项产出 Attr 节点 极高 (ES6解构) 需避免循环内删除 日常业务只读遍历、属性审查首选
Array.from() 数组化 转换为标准 Attr[] 高 (函数式链式) 极高 (静态快照) 需 filter/map、修改删除、对象序列化
getAttributeNames() 直接产出 string[] 极高 (简洁语义) 极高 (返回静态数组) 现代标准环境、仅需提取属性名集合
传统 for (let i) 按索引下标读取 中 (需维护指针) 易因实时删改导致跳项 极深老旧兼容性要求、超高性能敏感循环

三、实战进阶与核心避坑指南

在实际工程实践中,遍历 DOM 属性看似简单,但在处理动态元素修改、布尔属性状态判定以及元素克隆同步时,有几个极为关键的陷阱需要特别关注。

遍历HTML元素所有属性的JavaScript实现方法
图 5:遍历 HTML 属性时的三大核心陷阱与防御型编码决策树

1. 警惕 Live Collection(动态集合)导致的“索引漏项”

element.attributes 属于 DOM 规范中的 实时动态集合(Live Collection)。这意味着一旦你在遍历过程中通过 element.removeAttribute() 移除了某个属性,attributes 内部的长度会立刻减 1,而后方所有的属性节点会自动向前平移一位。

如果使用传统的正向索引 for (let i = 0; i < attrs.length; i++) 边遍历边删除,就会发生灾难性的“漏删”跳项:

动态删除错误示范(产生跳项):
当 i = 0 时删除了第 0 项属性,原本处于索引 1 的属性立即往前递补成为了新的索引 0。但在下一轮循环中 i 递增到了 1,导致原本位于第 1 项的属性被直接跳过,未执行删除!

避坑解决方案:

  • 推荐:使用 Array.from() 制作静态快照后操作:
    // 先通过 Array.from 将动态集合拷贝成不可变的普通数组
    Array.from(element.attributes).forEach(attr => {
      if (attr.name.startsWith('data-')) {
        element.removeAttribute(attr.name); // 安全,绝不会影响外层数组迭代
      }
    });
  • 备选:使用倒序循环:从 length - 1 递减到 0 遍历,删除末尾项不会影响前方尚未访问的元素索引。

2. 布尔属性(Boolean Attributes)的特殊值判定

HTML 规范中有许多布尔属性,如 disabled、checked、readonly、hidden 等。按照 HTML5 规范,只要标签中出现了该属性名,就代表该功能处于开启状态,哪怕其属性值写为 disabled=""、disabled="disabled" 甚至是 disabled="false"。

当遍历 <button disabled> 时,读取出的 attr.value 是空字符串 "",而不是布尔值 true。

// 错误判定:attr.value 为 "",Boolean("") 为 false!
const isDisabled = Boolean(attr.value); // 得到 false,逻辑错误!

// 正确判定:检查元素是否具有该属性
const isDisabledCorrect = el.hasAttribute('disabled'); // 得到 true

3. 自定义数据属性(data-*)的双重遍历机制

所有形如 data-user-id="123" 的属性都会完整出现在 element.attributes 中,其 attr.name 保持原始短横线形式 "data-user-id"。与此对应,现代 DOM 提供了 element.dataset 专门读取这些属性,但它返回的是驼峰命名的键(例如 userId)。

如果你的目标是处理所有 HTML 标记属性,直接使用 attributes 是最全面的;如果只需要处理 data-* 数据,使用 dataset 则更为专一。

四、通用工具函数:将元素所有属性提取为标准化数据对象

在实际项目封装、DOM 序列化、组件克隆或自动化埋点上报中,我们经常需要把一个 HTML 元素的所有属性提取为一个便于序列化或网络传输的纯 JSON 兼容对象。以下提供一个健壮且考虑周全的通用解析函数:

/**
 * 遍历并解析 HTML 元素的所有属性
 * @param {Element} element - 目标 DOM 节点
 * @param {Object} options - 解析选项配置
 * @param {boolean} [options.lowercaseNames=true] - 是否将属性名规范为全小写
 * @param {Array<string>} [options.exclude=[]] - 需要排除忽略的属性黑名单
 * @returns {Record<string, string>} 标准键值对象
 */
function extractElementAttributes(element, options = {}) {
  if (!(element instanceof Element)) {
    throw new TypeError('参数必须是有效的 DOM Element 实例');
  }

  const {
    lowercaseNames = true,
    exclude = []
  } = options;

  const excludeSet = new Set(exclude.map(k => k.toLowerCase()));
  const result = {};

  // 使用 Array.from 建立静态快照遍历,防止潜在的原型污染或动态影响
  for (const { name, value } of Array.from(element.attributes)) {
    const normalizedName = lowercaseNames ? name.toLowerCase() : name;

    // 过滤黑名单属性
    if (excludeSet.has(normalizedName)) {
      continue;
    }

    result[normalizedName] = value;
  }

  return result;
}

// 示例调用:
const btn = document.querySelector('#submit-btn');
const data = extractElementAttributes(btn, {
  exclude: ['style'] // 忽略内联样式属性
});
console.log('提取结果:', JSON.stringify(data, null, 2));

五、技术总结与最佳选型建议

遍历 HTML 元素的属性是前端 DOM 审查与元数据操作的基石技能。在实际技术选型时,可以根据业务侧重快速决策:

  • 日常只读打印与调试:直接使用 for (const { name, value } of el.attributes),语法最凝练,直观易懂。
  • 需要函数式处理或动态增删:使用 Array.from(el.attributes) 转化为标准数组快照,兼具链式操作便利与对 Live 集合的安全性。
  • 只需检查拥有哪些属性名:优先使用 el.getAttributeNames(),直接得到纯字符串数组,开销最小。
  • 转为 JSON 键值字典:搭配 Object.fromEntries(Array.from(el.attributes, a => [a.name, a.value])),清晰且符合现代 ECMAScript 范式。
作者最新文章
相关文章
更多