Document:getElementById() 方法
>Document 接口的 getElementById() 方法返回一个表示 id 属性与指定字符串相匹配的元素的 Element 对象。由于元素的 ID 在指定时必须是独一无二的,因此这是快速访问特定元素的有效方法。
如果需要访问那些没有 ID 的元素,你可以考虑在 querySelector() 中使用选择器来查找这些元素。
备注:文档中的 ID 必须是唯一的。如果一个文档中有两个及以上的元素具有相同的 ID,那么该方法只会返回查找到的第一个元素。
语法
getElementById(id)
备注:方法名称中 "Id" 的大小写必须正确才能使代码正常运行;getElementByID() 是无效且无法正常运行的,无论它看起来是多么自然。
参数
id-
所要查找的元素的 ID。ID 是大小写敏感的字符串,且在文档中是唯一的;应只有一个元素具有任何给定的 ID。
返回值
返回一个表示与指定 ID 相匹配的 DOM 元素的 Element 对象。若在当前文档中没有找到匹配的元素,则返回 null。
示例
>HTML
<p id="para">这里有一些文本</p>
<button>蓝色</button>
<button>红色</button>
JavaScript
function changeColor(newColor) {
const elem = document.getElementById("para");
elem.style.color = newColor;
}
document.querySelectorAll("button").forEach((button) => {
const colors = {
蓝色: "blue",
红色: "red",
};
button.addEventListener("click", (event) => {
changeColor(colors[event.target.textContent]);
});
});
结果
使用说明
不同于其他元素查找方法(如 Document.querySelector() 以及 Document.querySelectorAll()),getElementById() 只有在作为全局 document 的方法时才能起作用,而在 DOM 中的其他元素上无法生效。这是因为 ID 值在整个网页中必须保持唯一。因此没有必要为这个方法创建所谓的“局部”版本。
示例
<div id="parent-id">
<p>你好世界 1</p>
<p id="test1">你好世界 2</p>
<p>你好世界 3</p>
<p>你好世界 4</p>
</div>
const parentDOM = document.getElementById("parent-id");
const test1 = parentDOM.getElementById("test1");
如果没有查找到给定 id 的元素,这个方法会返回 null。注意 id 参数是大小写敏感的,所以 document.getElementById("Main") 会返回 null 而不是元素 <div id="main">,因为“M”和“m”对于这个方法而言是不一样的。
getElementById() 方法不会搜索不在文档中的元素。当创建一个元素,并且分配 ID 后,你必须使用 Node.insertBefore() 或其他类似的方法把元素插入到文档树中,之后才能使用 getElementById() 访问到:
const element = document.createElement("div");
element.id = "test";
const el = document.getElementById("test"); // el 会是 null!
对于非 HTML 文档,DOM 的实现必须说明哪个属性是 ID 类型。只有文档的 DTD 定义了这个属性名是“id”时,“id”才会被认为是 ID 类型。在 XHTML、XUL 或者其他文档中,“id”通常被定义为 ID 类型的属性。不知道哪个属性是 ID 类型的实现中,这预期会返回 null。
规范
| 规范 |
|---|
| DOM> # ref-for-dom-nonelementparentnode-getelementbyid②> |
浏览器兼容性
参见
Document,有关其他方法和属性的参考,可用于获取文档中元素的引用。Document.querySelector()用于类似于'div.myclass'这样的查询的选择器Document.evaluate()——有一个可以在 XML 文档中通过xml:id来查询的实用方法。