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

 

Возвращает ссылку на элемент по его идентификатору (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 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' в этой спецификации.
Устаревшая Исходное определение интерфейса
Document Object Model (DOM) Level 2 Core Specification
Определение 'getElementById' в этой спецификации.
Устаревшая Заменяет DOM 1
Document Object Model (DOM) Level 3 Core Specification
Определение 'getElementById' в этой спецификации.
Устаревшая Заменяет DOM 2
DOM
Определение 'getElementById' в этой спецификации.
Живой стандарт Должен заменить 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)

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

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