XML DOM HTMLElement 对象

HTMLElement 对象表示 HTML 中的一个元素。

HTMLElement 对象的属性

一个 HTML 文档中的每个元素都有和元素的 HTML 属性对应的属性。这里列出了所有 HTML 标记都支持的属性。其他的属性，都特定于某种具体的 HTML 标记。HTMLElement 对象继承了 Node 和 Element 对象的标准属性，也实现了下面所描述的几个非标准属性：

  • className

    规定元素的 class 属性。注意：该属性名不是 "class"，因为 "class" 是 JavaScript 中的保留字。

    类型：String。状态：可写。

  • currentStyle

    这一特定于 IE 的属性应用于元素的所有 CSS 属性的级联组。它是 Window.getComputedStyle() 的仅用于 IE 的替代。

    类型：String。状态：可写。

  • dir

    规定元素的 dir 属性，声明了文档文本的方向。

    类型：String。状态：可写。

  • id

    规定元素的 id 属性。在一个文档中，没有两个元素具有相同的 id 值。

    类型：String。状态：可写。

  • innerHTML

    规定了元素所包含的字符串，不包括元素自身的开始标记和结束标记。查询这一属性会将元素的内容作为一个 HTML 文本串返回。将这个属性设置为一个 HTML 文本串，则可以用 HTML 的解析表示来替换元素的内容。在文档载入的时候，不能设置这个属性。这个一个源自于 IE4 的非标准属性，已经得到所有现代浏览器的支持。

    类型：String。状态：可写。

  • lang

    规定元素的 lang 属性，声明了元素内容的语言代码。

    类型：String。状态：可写。

  • offsetHeight, offsetWidth

    返回元素的高度和宽度，以像素为单位。这是非标准的但却得到很好支持的属性。

    类型：int。状态：只读。

  • offsetLeft

    返回当前元素的左边界到它的包含元素的左边界的偏移量，以像素为单位。

    类型：int。状态：只读。

  • offsetTop

    返回当前元素的上边界到它的包含元素的上边界的偏移量，以像素为单位。

    类型：int。状态：只读。

  • offsetParent

    返回对最近的动态定位的包含元素的引用，所有的偏移量都根据该元素来决定。如果元素的 style.display 设置为 none，则该属性返回 null。这是非标准的但却得到很好支持的属性。

    类型：Node。状态：只读。

  • scrollHeight, scrollWidth

    返回元素的完整的高度和宽度，以像素为单位。当一个元素拥有滚动条时（比如由于 CSS 的 overflow 属性），这些属性和 offsetHeight 与 offsetWidth 不同，offsetHeight 和 offsetWidth 只是报告元素的可见部分的大小。这是非标准的但却得到很好支持的属性。

    类型：int。状态：只读。

  • scrollTop, scrollLeft

    设置或返回已经滚动到元素的左边界或上边界的像素数。只有在元素有滚动条的时候，例如，元素的 CSS overflow 属性设置为 auto 的时候，这些像素才有用。这些属性也只在文档的 <body> 或 <html> 标记上定义（这和浏览器有关），并且一起来制定滚动文档的位置。注意，这些属性并不会指定一个 <iframe> 标记的滚动量。这是非标准的但却得到很好支持的属性。

    类型：int。状态：可写。

  • style

    返回为当前元素设置内联 CSS 样式的 style 属性的值。注意，这个属性的值不是一个字符串。

    类型：CSS2Properties。状态：只读。

  • title

    规定元素的 title 属性。当鼠标悬停在元素上的时候，很多浏览器在元素的“工具提示”中显示这一属性的值。

    类型：String。状态：可写。

HTMLElement 对象的方法

HTMLElement 对象继承了 Node 和 Element 对象的标准方法。某些类型的元素实现了特定于标记的方法，在 HTML DOM 参考手册的各标记参考页中提供了这些方法的信息。

大部分现代浏览器也都实现了如下的非标准方法：

方法 描述
scrollIntoView() 滚动文档。使该元素出现在窗口的顶部或底部。

HTMLElement 对象的事件句柄

响应鼠标和键盘事件的所有 HTML 元素都可以触发这里列出的事件句柄。某些元素，如链接和按钮，当这些事件发生的时候执行默认操作。对于像这样的元素，更多细节可以在具体元素的参考页中找到。

请参阅 HTML 事件属性参考手册，了解更多有关 HTML 事件句柄的知识。

如何获得有关 HTMLElement 对象更详细的信息

在 HTML DOM 参考手册中，我们为 HTML 标记对应的 DOM 对象制作了专门的参考页：

HTML DOM 参考手册

相关页面

XML DOM 参考手册：Document 对象

XML DOM 参考手册：Document.getElementById()

XML DOM 参考手册：Document.getElementsByTagName()