XML DOM HTMLElement 对象

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

HTMLElement 对象的属性

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

  • 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 对象继承了 NodeElement 对象的标准方法。某些类型的元素实现了特定于标记的方法,在 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()