浏览器与 Web API / 系统课时
标准属性与 DOM 属性
标准属性与 DOM 属性
本课解决一个常见误区:HTML 标签上的属性与 JavaScript 中元素对象的属性并非始终等价。你将通过映射关系和可运行示例,判断哪些值会同步、哪些值会分离,以及操作表单状态时应选择哪一种入口。
学习目标
- 区分 HTML 属性与 DOM 对象属性的职责
- 识别常见的名称映射与同步行为
- 正确处理
value、checked等运行时状态
两套访问入口
HTML 属性写在标签中,例如 class="field"、value="Alice"。浏览器解析标签后,会创建对应的 DOM 元素对象,并为许多标准属性提供对象属性,例如 className、value。前者通过 getAttribute 等方法访问,后者通过点语法访问。

所谓“反射”是指修改一侧时,浏览器按规则更新另一侧。但反射只适用于特定标准属性,而且转换规则由属性类型决定,因此不能把两套入口理解为完全相同的字符串存储。
常见映射与差异
| HTML 属性 | DOM 属性 | 关键行为 |
|---|---|---|
class |
className |
通常双向同步,名称不同 |
for |
htmlFor |
通常双向同步,避免与语言关键字混淆 |
data-user-id |
dataset.userId |
名称转换为驼峰形式,值仍是字符串 |
value |
value |
初始时相关,用户输入或赋值后,当前值可能与标签属性分离 |
checked |
checked |
HTML 属性表示默认存在状态,DOM 属性表示当前勾选状态 |
布尔属性只看是否存在。例如 disabled="false" 仍表示禁用,因为 false 只是属性字符串,并不会抵消属性的存在。
主示例:观察同步与分离
下面的完整页面先修改输入框的 value DOM 属性,再修改 className。运行后可以直接比较标签属性值和对象当前值。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>属性与 DOM 属性</title>
</head>
<body>
<input id="nickname" class="field" value="Alice">
<pre id="output"></pre>
<script>
const input = document.querySelector("#nickname");
const output = document.querySelector("#output");
// value 表示当前值,修改后不会改写原始 value 属性
input.value = "Bob";
// className 是 class 属性的反射属性,会同步到标签属性
input.className = "field active";
const result = {
attributeValue: input.getAttribute("value"),
propertyValue: input.value,
attributeClass: input.getAttribute("class"),
propertyClassName: input.className
};
output.textContent = JSON.stringify(result, null, 2);
</script>
</body>
</html>预期结果
{
"attributeValue": "Alice",
"propertyValue": "Bob",
"attributeClass": "field active",
"propertyClassName": "field active"
}结果表明:className 与 class 保持同步,而输入框的当前 value 已与初始 HTML 属性分离。若用户继续输入,变化仍体现在 input.value,不是 getAttribute("value")。
选择合适的访问方式
读取或修改元素的当前运行状态时,优先使用 DOM 属性,例如 input.value、checkbox.checked 和 button.disabled。需要保留属性字符串、处理 data-*、aria-* 或未知属性名时,使用属性方法更直接。
判断代码是否正确时,不要只看属性名称是否相同,还要确认它表示“初始配置”还是“当前状态”。表单控件最容易暴露这一区别。