This page was translated from English by the community.Learn more and join the MDN Web Docs community.
document.getElementById()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..
Возвращает ссылку на элемент по его идентификатору (ID); идентификатор является строкой, которая может быть использована для идентификации элемента; она может быть определена при помощи атрибутаid в HTML или из скрипта.
Синтаксис
element = document.getElementById(id);
Параметры
idчувствительная к регистру строка, являющаяся уникальным идентификатором искомого элемента.
Возвращаемое значение
ссылка на объект типаElement соответствующий указанному ID илиnull, если элемент с указанным 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>Some text here</p> <button>blue</button> <button>red</button> </body></html>Замечания
Начинающим следует знать, что верхний регистр в части имени метода 'Id'должен быть точным для корректного вызова функции; "getElementByID" будетне корректно, как бы естественно это ни казалось.
Если элементы с указанным id отсутствуют, функция вернёт null. Заметьте, что параметр id чувствителен к регистру, такdocument.getElementById("Main") вернётnull вместо элемента<div>, потому что "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 |
|---|
| DOM # ref-for-dom-nonelementparentnode-getelementbyid② |
Совместимость с браузерами
Смотрите также
Documentссылка для иных методов и свойств которые вы можете использовать для получения ссылок на иные элементы.Document.querySelector()для выборки по таким запросам, как'div.myclass'- xml:id - имеет метод, позволяющий getElementById() получать «xml: id» в XML-документах (например, возвращаемые вызовами Ajax)