Объектная модель HTML-документа - Программирование от RIN.RU

HTML-документ: интерфейс HTMLDocument

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Интерфейс HTMLDocument является корнем в иерархии HTML-элементов. Он наследует все свойства и методы интерфейса Document и, кроме того, содержит несколько дополнительных свойств и методов, призванных облегчить написание сценариев для управления динамическими страницами.

Свойства интерфейса HTMLDocument
Свойство	Изменяемое	Модель	Описание
`anchors`	Нет	DOM 1	Коллекция закладок, определенных в документе.
`applets`	Нет	DOM 1	Коллекция аплетов, определенных в документе.
`body`	Да	DOM 1	Указатель на тело документа.
`cookie`	Да	DOM 1	Куки, ассоциированные с документом.
`domain`	Нет	DOM 1	Доменное имя сервера.
`forms`	Нет	DOM 1	Коллекция форм, определенных в документе.
`images`	Нет	DOM 1	Коллекция графических образов, определенных в документе.
`links`	Нет	DOM 1	Коллекция гиперссылок, определенных в документе.
`referrer`	Нет	DOM 1	URI документа, ссылающегося на данный.
`title`	Да	DOM 1	Титул документа.
`URL`	Нет	DOM 1	Полный URI документа.

Методы интерфейса HTMLDocument
Метод	Модель	Описание
`close`	DOM 1	Завершает редактирование документа.
`getElementsByName`	DOM 1	Возвращает коллекцию элементов, имеющих заданное имя.
`open`	DOM 1	Открывает документ для редактирования.
`write`	DOM 1	Записывает в документ заданную строку.
`writeln`	DOM 1	Записывает в документ заданную строку и символ перевода строки.

Свойство anchors

Поддержка :		Нестандартная.
		Соответствует стандарту.

Свойство anchors возвращает коллекцию всех закладок, определенных в документе. Под закладкой здесь понимается элемент A, имеющий атрибут name. Согласно стандарту, закладки, определенные атрибутом id, а не name, не должны включаться в эту коллекцию, однако Internet Explorer их включает. Пример:

<A name="a1"></A>
<A id="a2"></A>
<SCRIPT>
alert(document.anchors.length);
</SCRIPT>

Оператор alert выведет в Gecko число 1, а в Internet Explorer число 2.

Свойство applets

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Свойство applets возвращает коллекцию всех аплетов, определенных в документе. Аплеты определяются либо элементом OBJECT, либо морально устаревшим элементом APPLET. Пример:

for (var i = 0; i < document.applets.length; i++)
  alert(document.applets[i].code);

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Свойство body задает или возвращает указатель на тело документа, т. е. либо на элемент BODY, либо, во фреймовых документах, на элемент FRAMESET. Пример:

alert(document.body.tagName);

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Свойство cookie задает или возвращает строку, содержащую куки данного документа. Куки - это небольшой текстовый файл, который сохраняется обозревателем на компьютере-клиенте и содержит определенную информацию о данном Веб-документе. Содержимое куки передается в виде набора пар имя=значение, разделенных точкой с запятой. Число таких пар не должно превышать 20. Следующие имена в куки имеют специальное значение:

`expires=дата`	Задает дату и время удаления куки. Если этот параметр не задан, то куки существует до закрытия окна обозревателя (т. н. сеансовый куки). Дата должна иметь тот же формат, что и результат метода `Date.toUTCString`.
`domain=имя_домена`	Задает имя домена. Это позволяет нескольким серверам, входящим в один домен, совместно пользоваться информацией из куки.
`path=путь`	Задает путь на сервере. Это позволяет всем страницам данного домена, хранящимся в данном каталоге и его подкаталогах, совместно пользоваться информацией из куки.
`secure`	Этот параметр означает, что информация из куки должна быть доступна только в безопасном контексте.

При чтении этого свойства всегда возвращается строка, содержащая все куки данного документа. При этом следует учитывать, что Gecko добавляет после точки с запятой пробел, а Internet Explorer нет. Поэтому обрабатывать куки следует так, как показано в следующем примере, который возвращает дату и время удаления куки (или null для сенсового куки):

function trimLeft(s) {
  while(s[0] == " ")
 s = s.substr(1);
  return s;
}
function getCookie(sName) {
  var aCookie = document.cookie.split(";");
  for (var i = 0; i < aCookie.length; i++) {
 var aCrumb = trimLeft(aCookie[i]).split("=");
 if (sName == aCrumb[0]) 
return unescape(aCrumb[1]);
  }
  return null;
}
alert(getCookie("expires"));

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Свойство domain возвращает строку, содержащую доменное имя сервера, с которого загружена данная страница, или null, если сервер не может быть идентифицирован. Пример:

alert(document.domain);

Примечание. В Internet Explorer значение этого свойства можно изменять, присвоив ему суффикс доменного имени сервера. Дело в том, что доступ из одного фрейма MSIE к объектной модели другого допускается только в тех случаях, когда эти фреймы загружены из одного доменного имени. Пусть, например, один фрейм был загружен с сервера allo.usaaa.ru, а второй - с сервера home.usaaa.ru. Эти два фрейма не смогут общаться друг с другом; для разрешения доступа таких фреймов друг к другу мы должны присвоить их document.domain строку "usaaa.ru".

Свойство forms

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Свойство forms возвращает коллекцию всех форм, определенных в документе, т. е. всех элементов FORM. Пример:

alert(document.forms.length);

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Свойство images возвращает коллекцию всех графических образов, определенных в документе, т. е. всех элементов IMG. Пример:

alert(document.images.length);

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Свойство links возвращает коллекцию всех гиперссылок, определенных в документе. Гиперссылки определяются либо элементом A, имеющим атрибут href, либо элементом <AREA, имеющим атрибут href. Пример:

for (var i = 0; i < document.links.length; i++)
  alert(document.links[i].href);

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Свойство referrer возвращает строку, содержащую имя документа, из которого по гиперссылке был загружен данный документ. Если такого документа нет (например, когда имя документа было введено в поле адреса обозревателя), то возвращается пустая строка. Пример:

alert(document.referrer);

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Свойство title возвращает или задает строку, содержащую титул данного документа, т. е. содержимое его элемента TITLE. Пример:

if (document.title == "")
  document.title = "Без заголовка";

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Свойство URL возвращает строку, содержащую полный URI данного документа. Например, для страницы, которую вы сейчас читаете, оператор alert(document.URL) выведет на экран строку http://allo.usaaa.ru/wdh/dhtml06.htm.

Хотя стандарт считает это свойство неизменяемым, оба обозревателя позволяют задавать его значение. При этом Gecko просто игнорирует такой оператор присваивания, а Internet Explorer загружает в текущее окно документ с новым URL. Ср. описание window.location.href и window.location.replace.

Метод close

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Метод close закрывает документ, открытый методом open, и вызывает отображение этого документа. См. пример и комментарии в описании метода open.

Метод getElementsByName

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Метод getElementsByName возвращает коллекцию, состоящую из всех элементов, имеющих значение атрибута name, равное elementName. Если таких элементов нет, то возвращается пустая коллекция. В результирующую коллекцию включаются только те элементы, наличие у которых атрибута name допускается стандартом HTML. Пример:

var imgList = document.getElementsByName("MyImage");
alert(imgList.length);

Поддержка :		Нестандартная.
		Соответствует стандарту.

Метод open открывает документ для редактирования методами write и writeln. Методы open, write, writeln и close введены в DOM HTML для совместимости со старыми версиями Netscape Navigator, который требовал специальных процедур открытия и закрытия слоя перед изменением его содержания. Современные обозреватели в этом не нуждаются, и, по всей вероятности, из следующих версий DOM перечисленные методы будут исключены.

Поэтому Gecko поддерживает методы open и close, но попросту их игнорирует. Internet Explorer точно так же игнорирует метод close, а метод open имеет два варианта: без параметров он игнорируется, а с параметрами он является синонимом метода window.open. Пример:

document.open();
document.writeln("<P>Новый абзац 1.</P><P>Новый абзац 2.</P>");
document.close();

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Метод write вставляет в текущую позицию документа HTML-текст, заданный аргументом text. См. пример и комментарии в описании метода open.

Метод writeln

Поддержка :		Соответствует стандарту.
		Соответствует стандарту.

Метод writeln вставляет в текущую позицию документа HTML-текст, заданный аргументом text. К HTML-тексту добавляется символ перевода строки. См. пример и комментарии в описании метода open.