From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../zh-cn/web/api/element/setattribute/index.html | 97 ++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 files/zh-cn/web/api/element/setattribute/index.html (limited to 'files/zh-cn/web/api/element/setattribute') diff --git a/files/zh-cn/web/api/element/setattribute/index.html b/files/zh-cn/web/api/element/setattribute/index.html new file mode 100644 index 0000000000..0855bc31f6 --- /dev/null +++ b/files/zh-cn/web/api/element/setattribute/index.html @@ -0,0 +1,97 @@ +--- +title: Element.setAttribute() +slug: Web/API/Element/setAttribute +tags: + - API + - DOM + - NeedsSpecTable + - 元素 + - 参考 + - 属性 + - 方法 +translation_of: Web/API/Element/setAttribute +--- +
{{APIRef("DOM")}}
+ +

设置指定元素上的某个属性值。如果属性已经存在，则更新该值；否则，使用指定的名称和值添加一个新的属性。

+ +

要获取某个属性当前的值，可使用 {{domxref("Element.getAttribute", "getAttribute()")}}；要删除某个属性，可使用 {{domxref("Element.removeAttribute", "removeAttribute()")}}。

+ +

语法

+ +
element.setAttribute(name, value);
+
+ +

参数

+ +
+
name
+
表示属性名称的字符串。A {{domxref("DOMString")}} specifying the name of the attribute whose value is to be set. The attribute name is automatically converted to all lower-case when setAttribute() is called on an HTML element in an HTML document.
+
value
+
属性的值/新值。A {{domxref("DOMString")}} 包含了分配给这个属性的值. 任何非字符串的值都会被自动转换为字符串.
+
+ +

当在 HTML 文档中的 HTML 元素上调用 setAttribute() 方法时，该方法会将其属性名称（attribute name）参数小写化。

+ +

如果指定的属性已经存在，则其值变为传递的值。如果不存在，则创建指定的属性。

+ +

尽管对于不存在的属性，getAttribute() 返回 null，你还是应该使用 removeAttribute() 代替 elt.setAttribute(attr, null) 来删除属性。

+ +

布尔属性（原文是Boolean attributes）只要出现在元素上就会被认为是 true ，无论它的值是什么; 一般来说, 你应该将 value 设置为空字符串 ("") 。(一些人使用这个属性的名称作为值; 这不会出现什么问题，但这是不规范的). See the {{anch("Example", "example")}} below for a practical demonstration.

+ +

由于将指定的值转换为字符串，因此指定null不一定能达到您的期望。 而不是删除属性或将其值设置为{{jsxref（“ null”）}}，而是将属性的值设置为字符串“ null”。 如果要删除属性，请调用{{domxref（“ Element.removeAttribute”，“ removeAttribute（）”）}}}。

+ +

返回值

+ +

{{jsxref("undefined")}}

+ +

例外

+ +
+
无效字符错误
+
指定的属性名称包含一个或多个在属性名称中无效的字符。
+
+ +

例子

+ +

在下面的例子中，setAttribute() 被用于设置 {{HTMLElement("button")}} 上的属性。

+ +

HTML

+ +
<button>Hello World</button>
+ +

JavaScript

+ +
var b = document.querySelector("button");
+
+b.setAttribute("name", "helloButton");
+b.setAttribute("disabled", "");
+
+ +

这说明了两件事：

+ + + +

{{ EmbedLiveSample('Example', '300', '50') }}

+ +

{{DOMAttributeMethods}}

+ +

规范

+ + + +

浏览器兼容性

+ + + +

{{Compat("api.Element.setAttribute")}}

+ +

Gecko 备注

+ +

使用 setAttribute() 修改某些属性值时，尤其是 XUL 中的 value，可能得不到期望结果。这是由于 attribute 指定的是默认值。要访问或修改当前值，应该使用 property 属性。例如，使用 Element.value 代替 Element.setAttribute()。

-- cgit v1.2.3-54-g00ecf