Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

 

Возвращает ссылку на элемент по его идентификатору (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.

Спецификация

Спецификация Статус Комментарий
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

Совместимось в браузерах

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Базовая поддержка 1.0 1.0 (1.7 или ранее) 5.5 7.0 1.0
Возможность Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Базовая поддержка 1.0 1.0 (1.0) 6.0 6.0 1.0

Смотрите также

  • Document ссылка для иных методов и свойств которые вы можете использовать для получения ссылок на иные элементы.
  • Document.querySelector() для выборки по таким запросам, как 'div.myclass'
  • xml:id - имеет метод, позволяющий getElementById() получать «xml: id» в XML-документах (например, возвращаемые вызовами Ajax)

Метки документа и участники

Внесли вклад в эту страницу: s3rgp4r0dy, SergeyM, ZZPot
Обновлялась последний раз: s3rgp4r0dy,