大网数据广告活动
Web 标准与前端开发

Element:setAttribute() 方法

· 52CE 我爱测

Element 接口的 **`setAttribute()`** 方法用于设置指定元素上的某个属性值。如果属性已经存在,则更新该值;否则,使用指定的名称和值添加一个新的属性。

DOM

Element 接口的 setAttribute() 方法用于设置指定元素上的某个属性值。如果属性已经存在,则更新该值;否则,使用指定的名称和值添加一个新的属性。

要获取某个属性当前的值,请使用 Element.getAttribute;要删除某个属性,请使用 Element.removeAttribute。

如果你想要在添加时使用 Attr 节点(例如,从另一个元素克隆),你可以改用 Element.setAttributeNode 方法。

语法

setAttribute(name, value)

参数

  • name
    • : 一个用于指定要设置的属性的名称的字符串。当在 HTML 文档中的 HTML 元素上调用 setAttribute() 方法时,该方法会将其属性名称自动转换为全小写形式。
  • value
    • : 一个包含要赋给属性的值的字符串。任何指定的非字符串值都会自动转换为字符串。

对于布尔属性,只要它们出现在元素中,就会被视为是 true。你应该将 value 设置为空字符串("")或属性的名称(不带前导或尾随空格)。请参阅下面的示例以获得实际演示。

由于指定的值(value)会被转换为字符串,所以指定 null 不一定能达到你预期的效果。请将属性的值设置为字符串 "null",而不是删除属性或将其值设置为 null。如果要删除属性,请调用 Element.removeAttribute。

返回值

无(undefined)。

异常

  • InvalidCharacterError DOMException
    • : 如果 name 值不是有效的 XML 名称,则抛出此异常;例如,它以数字、连字符或句点开头,或包含除字母数字字符、下划线、连字符或句点之外的字符。

示例

在下面的示例中,setAttribute() 被用于设置 button 上的属性。

HTML

<button>你好,世界</button>
button {
  height: 30px;
  width: 100px;
  margin: 1em;
}

JavaScript

const button = document.querySelector("button");

button.setAttribute("name", "helloButton");
button.setAttribute("disabled", "");

示例

这说明了两件事:

  • 上面对 setAttribute() 的第一次调用显示了将 name 属性的值更改为“helloButton”。你可以使用浏览器的页面检查器(Chrome、Edge、Firefox、Safari)查看此内容。
  • 要设置布尔属性的值(例如 disabled),可以指定任何值。建议使用空字符串或属性名称。重要的是,如果属性确实存在,则不管其实际值如何,都将视其值为 true。该属性的缺失表示其值是 false。我们通过把 disabled 属性的值设置为空字符串(""),以将 disable 设置为 true,这将导致按钮被禁用。

规范

浏览器兼容性

参见

  • Element.hasAttribute()
  • Element.getAttribute()
  • Element.removeAttribute()
  • Element.toggleAttribute()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。