Эта статья нуждается в редакционном обзоре. Как вы можете помочь.
Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.
Возвращает ссылку на элемент по его идентификатору (ID); идентификатор является строкой которая может быть использована для идентификации элемента; она может быть определена при помощи атрибута id в HTML или из скрипта.
Синтакс
element = document.getElementById(id);
Параметры
element- ссылка на объект типа
Elementилиnullесли элемент с указанным ID не найден в документе. idчувствительная к регистру строка, являющаяся уникальным идентификатором искомого элемента.
Пример
<!DOCTYPE html>
<html>
<head>
<title>getElementById example</title>
<script>
function changeColor(newColor) {
var elem = document.getElementById("para1");
elem.style.color = newColor;
}
</script>
</head>
<body>
<p id="para1">Some text here</p>
<button onclick="changeColor('blue');">blue</button>
<button onclick="changeColor('red');">red</button>
</body>
</html>
Замечания
Начинающим следует знать что верхний регистр в части имени метода 'Id' должен быть точным для корректного вызова функции; "getElementByID" будет не корректно, как бы естественно это ни казалось.
Если элементы с указанным id отсутствуют, функция вернёт null. Заметьте, что параметр id чувствителен к регистру, так document.getElementById("Main") вернёт null вместо элемента <div id="main"> потому что "M" и "m" различны для этого метода.
Элементы вне документа не ищутся getElementById(). При создании элемента и назначении ему ID, вам следует всавить элемент в дерево документа с помощью Node.insertBefore() или подобным методом, до того как вы сможете получить к нему доступ при помощи getElementById():
var element = document.createElement("div");
element.id = 'testqq';
var el = document.getElementById('testqq'); // el will be null!
Не-HTML документы. Релизация DOM должна содержать информацию сообщающую о том какие атрибуты являются идентификаторами. Атрибуты с именем "id" не являются идентификаторами только если это не указано в описании типа документа (DTD). Атрибут "id" определён в качестве идентификатора в общих случаях XHTML, XUL, и других. От реализация, которая не знает какой атрибут является идентификатором, ожидается возврат null.
Спецификация
| Specification | Status | Comment |
|---|---|---|
| Document Object Model (DOM) Level 1 Specification Определение 'getElementById' в этой спецификации. |
Рекомендация | Initial definition for the interface |
| Document Object Model (DOM) Level 2 Core Specification Определение 'getElementById' в этой спецификации. |
Рекомендация | Supersede DOM 1 |
| Document Object Model (DOM) Level 3 Core Specification Определение 'getElementById' в этой спецификации. |
Рекомендация | Supersede DOM 2 |
| DOM Определение 'getElementById' в этой спецификации. |
Живой стандарт | Intend to supersede DOM 3 |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | 1.0 | 1.0 (1.7 или ранее) | 5.5 | 7.0 | 1.0 |
| Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | 1.0 | 1.0 (1.0) | 6.0 | 6.0 | 1.0 |
See also
Documentreference for other methods and properties you can use to get references to elements in the document.Document.querySelector()for selectors via queries like'div.myclass'- xml:id - has a utility method for allowing
getElementById()to obtain 'xml:id' in XML documents (such as returned by Ajax calls)