详解 HTML attribute 和 DOM property
在大多数的文章中,attribute 一般被翻译为“特性”,property 被译为“属性”。
结论
把结论写在最前面,如果你全都懂,后面就不用看了。
HTML attribute | DOM property |
值永远是字符串或 null | 值可以是任意合法 js 类型 |
大小写不敏感 | 大小写敏感 |
不存在时返回 null | 不存在时返回 undefined |
对于 href, 返回 html 设置的值 | 对于 href 返回解析后的完整 url |
更新 value, 属性也更新 | 更新 value, 特性不更新 |
概述
当我们书写 HTML 代码的时候,我们为 HTML 元素设置特性 ,例如:
<input id="name" value="justjavac" />
我们写了一个 input 标签,并给他定义了 2 个特性 (id 和 value)。当浏览器解析这段代码的时候,会把 html 源码解析为 DOM 对象,确切的说是解析为 HTMLInputElement 对象。HTMLInputElement 的继承关系是:
HTMLInputElement
↓
HTMLElement
↓
Element
↓
Node
↓
EventTarget
↓
Object
通过查看文档会发现,HTMLInputElement 的原型上定义了很多属性和方法,例如 form, name, type, alt, checked, src, value 等等,还有从 HTMLElement 继承来的 id, title, clientTop 等等。
如果仔细找找,就不难发现其中就有我们为 input 标签定义的特性:id 和 value。当浏览器解析网页时,将 HTML 特性映射为了 DOM 属性。
而 Element 类还有一个 attributes 属性,里面包含了所有的特性。
但是,HTML attribute 和 DOM property 并不总是一对一的关系。
1. DOM 属性
当浏览器解析完 HTML 后,生成的 DOM 是一个继承自 Object 的常规 JavaScript 对象,因此我们可以像操作任何 JS 对象那样来操作 DOM 对象。
const el = document.getElementById('name')
el.foo = 'bar'
el.user = { name: 'jjc', age: '18'}
也可以为其添加方法。如果你想给每个 html 元素都添加属性或方法,甚至可以直接修改 Element.prototype,不过我们不推荐这么做。
2. HTML 特性
和 DOM 属性类似,除了那些规范里定义的标准特性外,HTML 也可以添加非标准的属性,例如:
<input id="name" value="justjavac" foo="bar" />
当 HTML 特性映射为 DOM 属性时,只映射标准属性,访问非标准属性将得到 undefined。
const el = document.getElementById('name')
el.foo === undefined
好在 DOM 对象也提供了操作特性的 API:
- Element.hasAttribute(name) – 判断某个特性是否存在
- elem.getAttribute(name) – 获取指定特性的值
- elem.setAttribute(name, value) – 设置指定特性的值
- elem.removeAttribute(name) – 移除指定特性
以上 API 定义在 Element 上。
根据 HTML 规范,标签以及特性名是不区分大小写的,因此以下代码是一样的:
el.getAttribute('id')
el.getAttribute('ID')
el.getAttribute('iD')
并且,特性永远都是字符串或 null。如果我们为特性设置非字符串的值,则引擎会将此值转换为字符串。属性是具有类型的:
el.getAttribute('checked') === '' // 特性是字符串
el.checked === false // 属性是 boolean 类型的值
el.getAttribute('style') === 'color:blue' // 特性是字符串
typeof el.style === 'object' // 属性是 CSSStyleDeclaration 对象
即使都是字符串,属性和特性也可能不同,有一个例外就是 href:
el.getAttribute('href') === '#tag' // 特性原样返回 html 设置的值
el.href === 'http://jjc.fun#tag' // 属性返回解析后的完整 uri
3. 特性和属性的同步
当标准的特性更新时,对应的属性也会更新;反之亦然。
但是 input.value 的同步是单向的,只是 attribute --> property。当修改特性时,属性也会更新;但是修改属性后,特性却还是原值。
el.setAttribute('value', 'jjc'); // 修改特性
el.value === 'jjc' // 属性也更新了
el.value = 'newValue'; // 修改属性
el.getAttribute('value')) === 'jjc' // 特性没有更新
4. 非标准特性
非标准 HTML 特性并不会自动映射为 DOM 属性。当我们使用 data- 开头的特性时,会映射到 DOM 的 dataset 属性。中划线格式会变成驼峰格式:
el.setAttribute('data-my-name', 'jjc');
el.dataset.myName === 'jjc'
el.setAttribute('data-my-AGE', 18);
el.dataset.myAge === '18'
自定义特性 VS 非规范特性
HTML 允许我们自定义标签,也可以扩展标签的特性,但是我们推荐使用已经进入 HTML5 规范的自定义特性 data-*。比如我们想为div 标签增加一个 age 特性,我们可以有 2 种选择:
<div age="18">justjavac</div>
<div data-age="18">justjavac</div>
虽然第一种代码更短,但是却有一个潜在的风险。因为 HTML 规范是一直发展变化的,也许在未来的某个版本中,age 被添加进了标准特性里面,这将会引起潜在的 bug。
作者:justjavac