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 接口中。