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 對象參考手冊