HTML属性操作需区分attribute与property:id、src等可直接点语法赋值,data-、aria-等必须用setAttribute或dataset;value、checked等表单属性应操作property;innerHTML会清空属性,推荐textContent或insertAdjacentHTML。

HTML 元素属性的赋值分静态和动态两类,静态写死在标签里没问题,但真正在 JS 里操作时,setAttribute 和直接点语法赋值(如 el.src)行为不等价,用错会导致 DOM 更新失败或属性丢失。
哪些属性能直接点语法赋值,哪些必须用 setAttribute
不是所有 HTML 属性都能用 el.xxx = value 设置。只有对应 DOM property 的属性才支持,比如 id、className、src、href、disabled、checked、value 等。而像 data-* 、aria-* 、自定义属性(如 my-id)、或者某些只存在于 HTML attribute 层面的属性(如 colspan 在某些旧浏览器中),必须走 setAttribute。
常见误用:el.class = "active" 无效(应为 el.className);el.dataId = "123" 不会写入 data-id 属性(应为 el.setAttribute("data-id", "123") 或 el.dataset.id = "123")。
-
value对<input>有效,但对<select></select>只设初始值,不触发选中(需配合selectedIndex或遍历options) -
disabled = true是布尔赋值,不是字符串"true";el.setAttribute("disabled", "")也合法,但语义不同 -
style推荐用el.style.color = "red",而非setAttribute("style", "color:red"),后者会覆盖全部内联样式
data-* 属性该用 dataset 还是 setAttribute
dataset 是专为 data-* 设计的 API,自动驼峰化键名(data-user-id → el.dataset.userId),读写更安全、语义更清晰。但注意:它只映射 data- 开头的属性,不包含其他 attribute;且不能删除属性(delete el.dataset.userId 无效),得用 removeAttribute("data-user-id")。
立即学习“前端免费学习笔记(深入)”;
如果需要兼容 IE10 及更早版本,dataset 不可用,只能退回到 setAttribute / getAttribute。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 写法:
el.dataset.userId = "abc"→ 渲染为data-user-id="abc" - 读法:
el.dataset.userId返回字符串"abc",即使原始值是数字或布尔 - 含下划线的 key:
data-first_name→el.dataset.firstName(下划线后首字母大写,其余下划线被忽略)
input、select、textarea 的 value 赋值陷阱
表单控件的 value 属性在 JS 中是可写的 DOM property,但它的行为和 HTML value attribute 不完全同步。设置 el.value = "xxx" 只影响当前输入值,不会修改 HTML 源码中的 value="..." attribute;反之,改 attribute(setAttribute("value", "..."))只影响初始值,对已渲染的 input 无即时效果。
对于 <select></select>,单纯设 value 不保证 UI 更新——尤其当选项是动态插入或 value 不存在时。必须确保目标 option 存在且其 value 匹配,或手动设 selectedIndex。
-
<input type="checkbox">:用el.checked = true,别用setAttribute("checked", "checked")(后者只影响初始状态) -
<textarea></textarea>:赋值同input,用el.value = "text",不是innerHTML -
<select multiple></select>:需遍历options,逐个设option.selected = true,不能只靠value
避免 innerHTML 赋值引发的属性丢失
用 el.innerHTML = "..." 替换内容时,原元素的所有 attribute(包括 id、class、data-*、事件监听器)都会被清空重置。这不是“赋值”,而是销毁重建。
如果只是想更新文本内容,优先用 textContent(安全,防 XSS)或 innerText(带样式感知,但性能略差);若必须插 HTML,且要保留原有属性,得先提取关键 attribute,再拼进新字符串,或用 insertAdjacentHTML 局部替换。
- 错误示范:
div.innerHTML = "<p>hello</p>"→ 原div上的data-id、onclick全丢 - 安全替代:
div.textContent = "hello"或div.querySelector("p").textContent = "hello" - 若真要插 HTML 并保留属性,建议:
div.insertAdjacentHTML("beforeend", "<span class="new">text</span>")
真正容易被忽略的是 attribute 和 property 的双层模型——浏览器渲染依赖两者协同,但 JS 操作时它们并不总同步。写代码前先确认你要改的是“初始声明值”(attribute)还是“当前运行时状态”(property),选错方法,值就“设了但没生效”。


















