XML DOM getElementById() 方法

Document 对象参考手册

定义和用法

getElementById() 方法查找具有指定的唯一 ID 的元素。

语法:

getElementById(elementid)
参数 描述
elementid 想获取的元素的 id 属性的值。

返回值

表示具有指定的 id 属性的文档元素的 Element 节点。如果没有找到这样的元素,则返回 null。

说明

该方法将检索 id 属性的值为 elementid 的元素节点,并返回它。如果没有找到这样的元素,则返回 null。id 属性的值在文档中是唯一的,如果该方法找到更多具有指定 elementid 的元素节点,它将随机返回一个这样的元素节点,或者返回 null。

这是一个重要的常用方法,因为它为获取表示指定的文档元素的 Element 对象提供了简便的方法。

注意:该方法的名称以 Id 结尾,不是 ID,不要拼错了。

在 HTML 文档中,该方法总是检索具有指定 id 的属性。可以使用 HTMLDocument.getElementByName() 方法,根据它们的 name 属性中的值来查找 HTML 元素。

在 XML 文档中,这个方法则是使用类型为 id 的任一属性来查找,而不管这个属性的名称是什么。如果 XML 属性的类型是未知的(比如 XML 解析器忽略了或不能定位文档的 DTD),该方法总是返回 null。在客户端 JavaScript 中,这个方法并不经常和 XML 文档一起使用。实际上,getElementById() 最初被定义为 HTMLDocument 接口的一个成员,但是在后来的 2 级 DOM 中移入到 Document 接口中。

参阅

Document.getElementsByTagName()

Element.getElementsByTagName()

HTMLDocument.getElementByName()

Document 对象参考手册