document.getElementById()

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

 

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

  • Document reference 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)

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

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