HTML 属性参考 - HTML（超文本标记语言） 编辑

HTML中的元素拥有属性（attribute）；这些额外的属性值可以配置元素或者以各种方式来调整元素的行为，进而满足用户所需的标准。

属性列表

内容属性和 IDL属性

在 HTML 中，大多数属性都有两副面孔：内容属性和 IDL（接口描述语言）属性。

内容属性需要你在内容（HTML 代码）中设置，而且可以通过 {{domxref("element.setAttribute()")}} 或 {{domxref("element.getAttribute()")}}来设置。内容属性常常是一个字符串，即使里面的值是一个证书。例如，要将 {{HTMLElement("input")}} 元素的 maxlength 设置为 42，你需要在元素中调用 setAttribute("maxlength", "42") 。

IDL 属性（attribute）也就是一个 JavaScript 属性（property）。你可以使用 JavaScript 属性如 element.foo 来设置这些属性。当你需要获取 IDL 属性的值时，IDL 属性总会使用隐含的内容属性的值（可能先经过转换）来返回一个值。同样地，当你设置这个值时，这个值会保存在内容属性中。换句话说，IDL 属性本质上反映了内容属性。

大多数时候，IDL 属性会返回元素确实在用的值。例如，{{HTMLElement("input")}} 的默认 type 是 "text"，所以如果你设置 input.type="foobar"，<input> 元素仍然会是文本类型（在外观上和表现上），但 "type" 内容属性的值是 "foobar"。然而，type IDL 属性依旧会返回字符串 "text"。

IDL attributes 并不总是字符串；例如 input.maxlength 是一个数字（一个有符号的 long 类型）。使用 IDL 属性时，你读取或设置值的类型都是要求的类型。所以 input.maxlength 总会返回一个数字，而如果你要设置 input.maxlength，也需要使用数字。如果你传入了别的类型，则会根据标准 JavaScript 的类型转换规则被转换为数字。

IDL 属性可以 反映其他类型，如 unsigned long, URLs, booleans 等。不幸的是，并没有清晰的规则规定一个属性的 IDL 属性与相关的内容属性如何关联。大多数时候，这会遵守 规范中列出的规则，但有时并不遵守。HTML 规范尝试将这件事尽可能变得对开发者友好，但由于很多原因（大多是历史原因），一些属性表现得很奇怪（例如 select.size），你就需要阅读规范以理解它们实际上到底如何表现。

布尔值属性

一些内容属性（例如 required, readonly, disabled）是布尔值属性。如果一个布尔值属性存在，则其值是 true，如果不存在，其值是  false。

HTML5 定义了布尔值属性允许的取值：如果属性存在，其值必须是一个空字符串（即该属性的值未分配），或者是一个大小写无关的 ASCII 字符串，该字符串与属性名严格相同，前后都没有空格。下述例子是为一个布尔值属性取值的几个有效方式。

<div itemscope> This is valid HTML but invalid XML. </div>
<div itemscope=itemscope> This is also valid HTML but invalid XML. </div>
<div itemscope=""> This is valid HTML and also valid XML. </div>
<div itemscope="itemscope"> This is also valid HTML and XML, but perhaps a bit verbose. </div>

再明确一点，布尔值属性不能取值为 "true" 和 "false"。如果需要表示 false 值，布尔值属性需要整个忽略不写。这个限制澄清了一些常见误会：比如在元素中设置 checked="false" ，元素的 checked 属性会被解读为 true，因为这个属性出现了。

参见

• HTML elements