HTML 属性参考

属性列表

内容属性与 IDL 属性

在 HTML 中，大多数属性都有两个方面：内容属性和 IDL（接口定义语言）属性。

内容属性是您从内容（HTML 代码）设置的属性，您可以通过 element.setAttribute() 或 element.getAttribute() 来设置或获取它。即使预期值应为整数，内容属性也始终是字符串。例如，要使用内容属性将 <input> 元素的 maxlength 设置为 42，您必须在该元素上调用 setAttribute("maxlength", "42")。

IDL 属性也称为 JavaScript 属性。这些是您可以使用 JavaScript 属性（例如 element.foo）读取或设置的属性。IDL 属性在获取值时总是使用（但可能会转换）底层内容属性来返回值，并在设置值时将内容保存到内容属性中。换句话说，IDL 属性本质上反映了内容属性。

大多数情况下，IDL 属性将按其实际使用方式返回值。例如，<input> 元素的默认 type 是“text”，因此如果您设置 input.type="foobar"，<input> 元素的类型将是文本（在外观和行为上），但“type”内容属性的值将是“foobar”。但是，type IDL 属性将返回字符串“text”。

IDL 属性并不总是字符串；例如，input.maxlength 是一个数字（带符号的长整型）。使用 IDL 属性时，您会读取或设置所需类型的值，因此 input.maxlength 总是会返回一个数字，并且当您设置 input.maxlength 时，它需要一个数字。如果您传递另一种类型，它将根据标准 JavaScript 类型转换规则自动转换为数字。

IDL 属性可以反映其他类型，例如无符号长整型、URL、布尔值等。不幸的是，没有明确的规则，IDL 属性与其相应内容属性的交互方式取决于属性本身。大多数情况下，它会遵循规范中规定的规则，但有时并非如此。HTML 规范试图使其尽可能对开发人员友好，但由于各种原因（主要是历史原因），某些属性的行为很奇怪（例如 select.size），您应该阅读规范以确切了解它们的行为方式。

布尔属性

某些内容属性（例如 required、readonly、disabled）被称为布尔属性。如果布尔属性存在，其值为 true，如果不存在，其值为 false。

HTML 对布尔属性的允许值定义了限制：如果属性存在，其值必须为空字符串（等效地，属性可以没有赋值），或者一个与属性规范名称 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，因为该属性存在。

事件处理程序属性

除了上表中列出的属性外，全局事件处理程序（例如 onclick）也可以作为内容属性在所有元素上指定。

所有事件处理程序属性都接受一个字符串。该字符串将用于合成一个 JavaScript 函数，例如 function name(/*args*/) {body}，其中 name 是属性的名称，body 是属性的值。处理程序接收的参数与其 JavaScript 事件处理程序对应项相同——大多数处理程序只接收一个 event 参数，而 onerror 接收五个：event、source、lineno、colno、error。这意味着您通常可以在属性中使用 event 变量。

<div onclick="console.log(event)">Click me!</div>
<!-- The synthesized handler has a name; you can reference itself -->
<div onclick="console.log(onclick)">Click me!</div>

另见

• HTML 元素