document NN 2   IE 3   DOM 1

Объект document представляет собой содержание, показываемое в окне браузера или фрейме и остальное содержание файла HTML, загруженного в окно или фрейм. Таким образом, вся информация части HEAD - тоже часть объекта document. Все ссылки на внутренние элементы документа должны включать ссылку на объект document. Объект document не имеет никакого имени, отличного от его аппаратного имени объекта - document.

 
 
Объектно-ориентированная модель
NN [window.]document
IE [window.]document

Свойства:


activeElement NN n/a  IE 4   DOM n/a
 Только чтение
 

Ссылка на объект, который в настоящее время имеет фокус в документе. Чтобы узнать больше об объекте, Вы должны узнать имя объекта или другие его свойства. Поскольку кнопки и другие элементы не получают фокус на Macintosh, возвращаемое значение этого свойства может изменяться в зависимости от операционной системы.

 
Пример:

var currObj = document.activeElement

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: window

alinkColor NN 2   IE 3   DOM n/a
  Чтение/запись (в IE)
 

Цвет нажимаемой гипертекстовой ссылки. Цвет применяется к тексту ссылки, или границе вокруг изображения, или объекта, внедренного в элемент. См. также свойства linkColor и vlinkColor для непосещенных и посещенных ссылок. Internet Explorer 4 и DOM имеют параллельное свойство aLink объекта BODY. Динамически измененные значения для alinkColor не отражены на странице в Navigator.

 
Пример:

document.alinkColor = "green"

 
Возвращаемое значение:
Шестнадцатеричный триплет или одна из цветовых констант.
 
Значение по умолчанию: #0000FF

bgColor NN 2   IE 3   DOM n/a
 Чтение/Изменение
 

Цвет фона элемента.Даже если атрибут bgColor или свойство bgColor установлены с константным названием цвета, возвращенное значение - всегда шестнадцатеричный триплет.

Установка bgColor свойства document в Navigator 2 или 3 для Macintosh или Unix не перерисовывает окно должным образом..

 
Пример:

document.bgColor = "yellow"

 
Возвращаемое значение:
Шестнадцатеричный триплет или одна из цветовых констант.
 
Значение по умолчанию: В зависимости от браузера и операционной системы.

body NN 6  IE 4   DOM 1
 Только чтение
 

Возвращает ссылку на объект BODY, определенную элементом BODY в пределах документа. Это свойство используется как дверь к свойствам объекта BODY

 
Пример:

document.body.leftMargin = 15

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Текущий объект BODY.

charset NN n/a  IE 4   DOM n/a
  Чтение/Изменение
 

Кодировка документа. Это набор символов, используемых для компиляции текущего документа.

 
Пример:

if (document.charset == "csISO5427Cyrillic") { process for Cyrillic charset }

 
Возвращаемое значение:
Псевдоним системного набора символов без учета регистра (см. ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets).
 
Значение по умолчанию: Определенное браузером.

characterSet NN 6
  Чтение/Изменение
 

Кодировка документа. Эквивалентно совойству charset в IE.

 
Пример:

if (document.characterSet == "csISO5427Cyrillic") { process for Cyrillic charset }

 
Возвращаемое значение:
Псевдоним системного набора символов без учета регистра (см. ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets).
 
Значение по умолчанию: Определенное браузером.

cookie NN 2   IE 3   DOM 1
 Чтение/Изменение
 

HTTP cookie связан с доменом документа и сохраняет на клиентской машине в "файл cookie". Чтение и запись свойства cookie - не параллельные операции. Чтение свойства cookie возвращает разграниченный точкой с запятой список пар "имя/значение" в следующем формате:

name=value

Для 1 домена в свойстве cookie может быть сохранено до 20 пар (независимо от числа документов HTML, используемых в узле web). В cookie может быть сохранено общее количество - 4000 символов , но желательно сохранять каждую пара "имя/значение" длиной меньше чем 2000 символов.

Запись значений в cookie позволяет связывать дополнительные пары данных с отдельной парой "имя/значение". Формат следующий:

document.cookie = "name=value [; expires=timeInGMT] [; path=pathName] [; domain=domainName] [; secure]"

Каждая cookie-запись должна иметь имя и строковое значение. например, если пользователь собирается сохранить слово "Fred" в cookie-запись с именем UserName, то выражение JavaScript будет выглядеть так:

document.cookie = "UserName=Fred";

Если броузер не находит cookie-записи с таким названием в текущем домене, он создаёт её автоматически. Поиск document.cookie в этом пункте выдаст следующую строку:

UserName=Fred

Можно пренебречь другими параметрами cookie-записей, в этом случае броузер использует значения по-умолчанию.

Устанавливаемая дата годности записи должна соответствовать значению времени по Гринвичу. Чтобы вычислить дату истечения срока годности записи, основанную на сегодняшней дате необходимо использовать объект Date:

var exp = new Date();
var oneYearFromNow = exp.getTime() + (365*24*60*60*1000);
exp.setTime (oneYearFromNow);
// Теперь преобразуем дату в принятый строковый формат GMT и запишем cookie
document.cookie = "UserName=Fred; expires=" + exp.toGMTString()"

Отсутствие даты срока годности сообщает броузеру о том, что эта cookie-запись является временной. Таким образом, броузер не записывает её в файл.

Path - путь, заданный по умолчанию (в текущей директории). Можно создать дополнительную копию cookie в другой директории (для другого домена), таким образом одни и те же данные будут доступны документу, расположенному в другой области Web-узла или вообще сети.

Domain - Для синхронизации cokie-данных с определённым документом (или их группой) броузер определяет домен текущего документа и помещает в cookie-файл записи, соответствующие этому домену. Автоматическое определение домена текущего документа и занесение его в cookie-файл производится по-умолчанию. Необходимо знать, что формат представления домена должен представлять по крайней мере два периода. Например:

.mcom.com
.hotwired.corn

В противном случае нужно записать полный URL-адрес домена, включая протокол (http://).

Secure - если при сохранении записи этот параметр опущен, подразумевается, что cokie-данные доступны для любого другого документа или CGI-программы.

Независимо от того, сколько дополнительных подсвойств Вы устанавливаете в cookie, могут быть найдены только пары "имя/значение". Все данные cookie, записанные в свойство cookie находятся в памяти браузера до выхода из браузера. Если срок хранения cookie не был превышен, данные сохранятся в прежнем файле. В противном случае будет создан новый файл, т.к. старый считается удалённым.

При чтении cookie-записей нельзя обращаться к ним, как к объектам. Необходимо анализировать всю cookie-строку, извлекая данные из нужного набора. Для этого лучше создать функцию общего назначения, которая может управлять одной или несколькими cookie-записями. Далее представлена подобная функция (автор - Денни Гудман):

function getCookieData(LabelName) {
    var labelLen = labelName.length
    var cookieData = document.cookie
    var cLen = cookieData.length
    var i = 0
    var cEnd
    while ( i < cLen) {
        var j = i+labelLen
        if ( cookieData.substring( i , j ) == labelName) {
            cEnd = cookieData.indexOf( ";" , j )
            if (cEnd == -1) {
                cEnd = cookieData.length
            }
            return unescape(cookieData.substring( j+1 , cEnd ))
        i++
    }
    return ""
}

При обращении к этой функции имя нужной cookie-записи передаётся как параметр.

 
Пример:

Здесь представлен набор cookie-функций, написанных Биллом Дортчем (http://www.hIdaho.com/cookies/cookie.txt)

//"Внутренняя" функция для сохранения декодированного значения
function getCookieVal (offset) {
    var endstr = document.cookie.indexOf(";", offset);
    if (endstr == -1) endstr = document.cookie.length;
    return unescape(document.cookie.substring(offset, endstr));
}
/*Эта функция необходима для исправления ошибок в дате на Mac 2.x
 *Вызывайте её для проверки объекта даты перед отправкой данных в функцию SetCookie
 *Эта функция должна вызываться только 1 раз для каждого полученного объекта даты
 */
function FixCookieDate(date) {
    var base = new Date(0);
    var skew = base.getTime();
    if (skew > 0)date.setTime(date.getTime() - skew);
}
/*Эта функция предназначена для возвращения значения cookie
 *name - строковой объект, содержащий имя cookie
 *returns - строковой объект, содержащий либо значение cookie, либо 0, если запись не существует
 */
function GetCookie(name) {
    var arg = name + "=";
    var alen = arg.length;
    var clen = document.cookie.length;
    var i = 0;
    while (i < clen) {
        var j = i + alen;
        if (document.cookie.substring( i , j ) == arg) return getCookieVal(j);
        i = document.cookie.indexOf(" ", 1 ) + 1;
        if (i==0) break;
    }
    return null;
}
/*Эта функция предназначена для создания или обновления cookie
 *name - строковой объект, содержащий имя cookie
 *value - строковой объект, содержащий значение cookie
 *[expires] - объект Date, содержащий срок годности cookie
 *[path] - Строковой объект, указывающий путь нужной cookie-записи.
 *[domen] - Строковой объект, указывающий домен нужной cookie-записи.
 *[secure] - Булево значение, определяет необходимость безопасного соединения
 */
function SetCookie(name,value,expires,path,domain,secure) {
    document.cookie = name + "=" + escape(value) + ((expires) ? "; expires=" + expires.toGMTString() : "") + ((path) ? "; path=" + path : "") + ((domain) ? "; domain=" + domain : "") + ((secure) ? "; secure" : "");
}
/*Эта функция для удаления cookie
 *name - строковой объект, содержащий имя cookie
 *path - Строковой объект, содержащий путь cookie-записи.
 *domen - Строковой объект, содержащий домен cookie.
 */
function SetCookie(name,path,domain) {
    if(GetCookie(name)) {
        document.cookie = name + "=" + ((path) ? "; path=" + path : "") + ((domain) ? "; domain=" + domain : "") + "expires=Thu, 01-Jan-70 00:00:01 GMT";
    }
}

Пример использования:

var expDate = new Date;
FixCookieDate(expDate);
expDate.setTime (expDate.getTime + (24*60*60*1000));
SetCookie ( "name1", "value1", expdate);
SetCookie ( "name2", "value2", expdate);
SetCookie ( "tempVar", "Это временная cookie");
SetCookie ( "ubiquoitous", "Эта cookie будет работать в любом месте данного домена", null, "/");
SetCookie ( "paranoid", "Эта cookie обеспечивает безопасное соединение ", "/", null, true);

 
Возвращаемое значение:
Данные cookie.
 
Значение по умолчанию: Ничего.

defaultCharset NN n/a  IE 4   DOM n/a
  Чтение/Изменение
 

Кодировка документа по умолчанию.

 
Пример:

document.defaultCharset = "csISO5427Cyrillic"

 
Возвращаемое значение:
Псевдоним системного набора символов без учета регистра (см. ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets).
 
Значение по умолчанию: Определенное браузером.

designMode NN n/a  IE 5
  Чтение/Изменение
 

Свойство designMode используется только тогда, когда средства IE5 выступают в качестве компонента другого приложения. Это свойство указывает, будет ли модуль броузера использоваться для редактирования HTML-кода.

 
 
 
Возвращаемое значение:
Строковое
 
Значение по умолчанию: Ничего

doctype NN 6
  Только чтение
 

Свойство doctype позаимствовано из W3C DOM. С помощью этого свойства возвращается объект DocumentType - формат представления данных документов, представленный DTD. В IE5.5 и NN6 объект DocumentType является первым дочерним узлом корневого узла документа. В следующей таблице представлен список наиболее полезных свойств и их типичные значения для HTML-страницы.

Свойство Значение
entitles 0
internalSubset (нет)
name HTML
notations 0
publicid -//W3C//DTD HTML3.2 Final//EN
systemid (нет)
 
 
 
Возвращаемое значение:
Ссылка на объект DocumentType
 
Значение по умолчанию: объект DocumentType

documentElement NN 6  IE 5
  Только чтение
 

Свойство documentElement возвращает ссылку на объект HTML-элемента (или XML-элемента), который представляет содержимое всего текущего документа. Это свойство как бы "присуждает" звание "элемента" объекту document и узлу документа, связанного с текущей страницей, загруженной в броузере.

 
 
 
Возвращаемое значение:
Ссылка на объект DocumentType
 
Значение по умолчанию: объект DocumentType

domain NN 3   IE 4   DOM n/a
 Чтение/Изменение
 

Нostname сервера, который обслуживал документ. Если документы от различных серверов в одном и том же домене обмениваются содержанием друг с другом, свойство domain обоих документов должны быть установлены на один и тот же домен, чтобы избежать ограничений защиты. Обычно если главные компьютеры не согласовываны, JavaScript отменяет доступ к данным формы другого документа. Это свойство позволяет, например, странице от сервера WWW связываться со страницей, обслуживаемой secure сервером.

 
Пример:

document.domain = "megaCorp.com"

 
Возвращаемое значение:
Строка имени домена, которую два документа имеют одинаковую (исключительно из имени сервера).
 
Значение по умолчанию: Ничего.

expando NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

Позволяют ли сценарии в текущем документе создание и использование заказных свойств, назначенных на объект document. Расширяемый характер JavaScript позволяет скриптерам создавать новые свойства объекта, просто назначая значение этому свойству (типа document.stooge = "Curly"). Оно также даёт возможность ввода в документ некорректно записанных свойств, типа написание в нижнем регистре среднего символа верхнего регистра длинного названия свойства (marginLeftColor и т.п.). Такие допуски принимаются без вопросов, но нежелательных результатов не должно быть. Если Вы не намереваетесь создать заказные свойства, устанавливайте document.expando как false в инструкции сценария. Это может помочь предотвратить орфографические ошибки как порождение непредвиденных багов. Установка затрагивает только скрипты в текущем документе.

 
Пример:

document.expando = false

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: true

fgColor NN 2   IE 3   DOM n/a
  Чтение/Изменение
 

Приоритетный (для текста) цвет для документа. В то время как в NN Вы можете изменять это свойство , динамически текст не изменяется (по крайней мере в версии 4).

 
Пример:

document.fgColor = "darkred"

 
Возвращаемое значение:
Шестнадцатеричный триплет или одна из цветовых констант.
 
Значение по умолчанию: По умолчанию для броузера (обычно чёрный).

fileCreateDate, fileModifiedDate, fileSize NN n/a  IE 4
  Только чтение
 

Эти три свойства возвращают информацию о файле, содержащем текущий документ. Первые два (не поддерживаемые в IE5.Mac) определяют даты создания и изменения файла. Свойство fileSize возвращает объём файла в байтах.

Значения, возвращаемые в первых 2 свойствах, форматированы по-разному в IE4 и IE5. Функции предоставляют полную информацию о текущей дате, которая содержится в формате mm/dd/yy.

Нельзя получить информацию о файле, если:

  1. Сервер этого не поддерживает
  2. Сервер предоставляет информацию о файле в другом формате
  3. файл не загружен в броузер

IE 5.5 представляет на рассмотрение разработчиков свойство fileUpdatedDate, но оно не возвращает никаких значений.

 

 

 
Возвращаемое значение:
См. текст
 
Значение по умолчанию: Зависит от файла

height, width NN 4
  Только чтение
 

Эти свойства в NN4+ определяют в пикселах размер текущего окна или фрейма. Если размер документа меньше размера окна, свойства учитывают пустое пространство. Если больше - то и неотображаемую область документа. Соотвесствующие свойства IE - document.body.scrollHeight|scrollWidth.

 

 

 
Возвращаемое значение:
Целочисленное
 
Значение по умолчанию: Зависит от размеров

implementation NN 6
  Только чтение
 

Базовая W3C DOM использует данное свойство для нахождения сценарием средств (или элементов) DOM, которые поддерживаются в текущей среде. Объект, возвращённый данным свойством, (объект DOMImplementation), не имеет никаких свойств, но поддерживает метод hasFeature(), который позволяет сценариям определить, например, поддерживает ли данная среда HTML или только XML. Первым параметром метода hasFeature() является средство, представленное в виде строки. Второй параметр - строковое представление номера версии. Метод возвращает булево значение. Нумерация версий модулей DOM соответствует уровням W3C DOM. Таким образом, модуль XML DOM 2.0 соответствует DOM 2.0.

Довольно опасно использовать метод hasFeature() для определения поддерживаемых объектов в NN6, так как многие из них "пустые" и зарезервированы на будущее. На сегодняшний день можно воспринимать объявленное соответствие только как грубую индикацию поддержки возможностей.

Поддержка document.implementation.hasFeature() в NN 6
Модуль Версии
XML 1.0, 2.0
HTML 1.0, 2.0
Views 2.0
StyleSheets 2.0
CSS 2.0
Events 2.0
MouseEvents 2.0
HTMLEvents 2.0
Range 2.0
 

 

 
Возвращаемое значение:
Объект DOMImplementation
 
Значение по умолчанию: Объект DOMImplementation

lastModified NN 2   IE 3   DOM n/a
 Только чтение
 

Дата когда документ был последний раз изменён (как строка). Некоторые серверы не снабжают этой информацией вообще или снабжают неправильно.

 
Пример:

document.write(document.lastModified)

 
Возвращаемое значение:
Строковое представление даты
 
Значение по умолчанию: Ничего.

linkColor NN 2   IE 3   DOM n/a
 Чтение/Изменение
 

Цвет непосещённой гипертекстовой ссылки (то есть URL ссылки, не доступной в кэше броузера). Это - одно из состояний ссылки: непосещенная, активизированная, и посещенная. Цвет применяется к тексту ссылки или к границе вокруг изображения или другого элемента. Изменения этого свойства динамически не затрагивают цвет ссылки в Navigator 4 и старше. В Internet Explorer 4, это свойство имеет такой же эффект, как установка свойства ссылки объекта BODY.

 
Пример:

document.link Color= "#00FF00"

 
Возвращаемое значение:
Шестнадцатеричный триплет или одна из цветовых констант.
 
Значение по умолчанию: #0000FF

location NN 2   IE 3   DOM 1
  Чтение/Изменение
 

URL текущего документа. Нес стоит путать его со свойством window.location. Отличие между ними в соответствующих им типах данных. document.location (как, кстати, и document.URL) не имеет объектной природы. Это просто строка и её изменение никак не отражается на местоположении документа в сети. Это свойство осуждается в Navigator с Версии 3. Navigator предпочитает свойство document.URL, которое эквивалентно данному. Чтобы перейти к другой странице, Вы должны назначить свойству location.href её URL .

 
Пример:

document.location = "products/widget33.html"

 
Возвращаемое значение:
Любой URL как строка.
 
Значение по умолчанию: URL текущего документа.

media NN n/a  IE 5.5
  Чтение/Изменение
 

В IE5.5 это свойство может получать только одно значение (по умолчанию): print. Оно используется в сценарии для задания эквивалента правилу CSS 2 @media. Это правило таблицы стилей позволяет броузерам назначать отдельные стили для каждого типа устройства вывода, на котором представлена страница. Однако на практике это свойство не поддаётся изменению.

 
 
 
Возвращаемое значение:
строка.
 
Значение по умолчанию: print

mimeType NN n/a  IE 5
  Только чтение
 

Хотя это свойство и применяется в IE5+, его значение не соответствует типу MIME, или, по крайней мере, не его традиционному формату. Кроме того, в броузерах IE5 и IE5.5 значения свойства совершенно разные.

 
 
 
Возвращаемое значение:
строка.
 
Значение по умолчанию: HTML Document

namespaces NN n/a  IE 5.5
  Только чтение
 

Объект namespace (недавно появившийся в IE) может динамически импортировать основанное на XML поведение элемента IE. Свойство namespaces возвращает массив всех объектов namespace, определённых в текущем документе. Более подробная информация о пользовательском управлении HTML-страницами и сценариями приведена на http://msdn.microsoft.com/workshop/autor/benaviors/overview/identityb_ovw.asp

 
 
 
Возвращаемое значение:
Массив объектов namespaces
 
Значение по умолчанию: Ничего

parentWindow NN n/a  IE 4   DOM n/a
  Только чтение
 

Возвращает ссылку на объект window (который может быть фреймом в frameset) который содержит текущий документ. Вы можете использовать эту ссылку, чтобы обращаться к свойствам window и его методам непосредственно. Возвращенное значение такое же, как и ссылка окна из документа.

 
Пример:

var siblingCount = document.parentWindow.frames.length

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Объект Window.

protocol NN 2  IE 3  DOM 1
  Чтение/Изменение
 

Это свойство используется только в IE и определяет версию протокола, с помощью которого осуществился доступ к текущему документу. Данное свойство отличается от свойства location.protocol тем, что location.protocol возвращает часть URL-адреса (http:), а document.protocol - его полную строковую версию (Hypertext Transfer Protocol).

 
Пример:

with (document) { write(protocol); }

 
Возвращаемое значение:
строка
 
Значение по умолчанию: Зависит от протокола

readyState NN n/a  IE 4   DOM n/a
 Только чтение
 

Возвращает текущее состояние загрузки документа. Если сценарий (особенно инициализированный пользовательским событием) может исполнять некоторые действия в то время как документ все еще загружается, но должен избежать действий, пока страница не загрузилась полностью, это свойство обеспечивает промежуточную информацию о процессе загрузки. Вы можете использовать его значение в проверке на условие. Значение этого свойства изменяется в течение загрузки в соответствии с состоянием загрузки. Каждое изменение значения свойства вызывает событие onReadyStateChange.

 
Пример:

if (document.readyState == "loading") { statements for alternate handling

}

 
Возвращаемое значение:
Одно из следующих значений (как строки): complete | interactive | loading | uninitialized. Некоторые элементы могут позволять пользователю взаимодействовать с частичным содержанием, в некоторых случаях свойство может информировать пользователя о состоянии загрузки визуально. Обычно эти значения уже показываются в строке состояния браузера.
 
Значение по умолчанию: Ничего.

referrer NN 2   IE 3   DOM 1
  Только чтение
 

Возвращает как строку URL страницы, с которой обратились к текущей странице, если первоначальная страница имела ссылку на текущую страницу. Серверные логи также фиксируют эту информацию . Сценарии могут видеть, откуда посетитель обратился к текущему документу и, возможно, представлять слегка различное содержание на странице. Если посетитель прибыл другим способом, типа печатания URL документа в диалоговом окне браузера или выбирая закладку, свойство referrer возвращает пустую строку.

Данное свойство не применяется в броузерах IE 3 и 4, и вообще не возвращает никаких значений в IE 5++.

 
Пример:

if (document.referrer) { document.write("<P>Thanks for following the link to our web site.</P>") }

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: Ничего.

security NN n/a  IE 5.5
  Только чтение
 

Свойство предоставляет информацию о типе защиты, если таковая имеется в текущем документе. Оно формально не зарегистрировано в Microsoft и диапазон его возможностей пока не ясен.

 
Пример:

with (document) { write(security); }

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: This type of document does not have a security certificate. (Этот тип документов не имеет сертификата безопасности)

selection NN n/a  IE 4   DOM n/a
  Только чтение
 

Возвращает выбранный объект . Чтобы работать с текстом, который был выбран пользователем или сценарием, Вы должны преобразовать selection в объекту TextRange. Это возможно только в Internet Explorer для Win32.

 
Пример:

var range = document.selection.createRange( )

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Ничего.

title NN 2   IE 3   DOM n/a
 Чтение/Изменение
 

В отличие от свойства title для объектов, которые отражают элементы HTML свойство document.TITLE обращается к содержанию элемента TITLE, определенного в части HEAD. Содержание заголовка в заголовке браузера помогает идентифицировать документ. Это также содержание, которое входит в закладку для страницы.

 
Пример:

document.title = "Fred\'s Home Page"

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: Ничего.

URL NN 3   IE 4   DOM n/a
  Чтение/Изменение
 

URL текущего документа. Значение аналогично location.href. Netscape осуждает использование document.location свойства в пользу свойства document.URL, чтобы избежать потенциального беспорядка (между скриптерами имеханизмами JavaScript-интерпретатора) между объектом location и свойством document.location. Чтобы переместиться к другой странице, это самый безопасный способ (для перекрестной совместимости браузеров), чтобы назначить значение строки URL на свойство location.href.

 
Пример:

document.URL = "http://www.megacorp.com"

 
Возвращаемое значение:
Полный или относительный URL как строка.
 
Значение по умолчанию: URL текущего документа.

URLUnencoded NN n/a  IE 5.5
  Только чтение
 

Значение этого свойства эквивалентно инструкции

unescape(document.URL);

Оно возвращает декодированную URL-строку текущего документа

 
 
 
Возвращаемое значение:
Полный или относительный URL как строка.
 
Значение по умолчанию: URL текущего документа.

vlinkColor NN 2   IE 3   DOM n/a
 Read/Write (IE)
 

Цвет гипертекстовой ссылки, которая была недавно посещена . Цвет применяется к тексту ссылки, или границе вокруг изображения, или другого подобного объекта.Internet Explorer 4 и DOM имеют параллельное свойство vLink объекта BODY. в Navigator измененные значения не отражаются на странице.

 
Пример:

document.vlinkColor = "gold"

 
Возвращаемое значение:
Шестнадцатеричный триплет или одна из цветовых констант.
 
Значение по умолчанию: #551a8b (Navigator 4); #800080 (Internet Explorer 4 Windows); #006010 (Internet Explorer 4 Macintosh).

Методы:


captureEvents( ) только NN 4  

captureEvents(eventTypeList)

Инструктирует браузер перехватывать события определенного типа прежде, чем они достигают целевых объектов. То есть прежде чем событие достигнет своего объекта оно может быть перехвачено и обработано на верхнем уровне. Объекту, вызывающему этот метод должен быть определён обработчик события для данных типов событий. Такое поведение свойственно лишь броузеру NN 4.

 
Возвращаемое значение
None.
 
Параметры
eventTypeList Отделенный запятыми список типов событий с учетом регистра из доступных констант объекта Event: типа Event.CLICK или Event.MOUSEMOVE.

clear( ) NN 2   IE 3   DOM n/a

Удаляет текущий документ из окна или фрейма. Используется обычно в подготовке, чтобы открыть новый поток для записи содержания. Методы document.write() и document.writeln() автоматически вызывают этот метод. Много багов с методом document.clear() мучали браузеров ранних версий . Даже сегодня лучше позволить методам document.writeln () document.write () обрабатывать задание за Вас.

 
Возвращаемое значение
None.
 
Параметры
None.

close( ) NN 2   IE 3   DOM n/a

Закрывает пишущий поток к документу. Если сценарий использует методы document.write () или document.writeln () чтобы генерировать содержание для окна или фрейма, Вы должны добавить в конец метода document.close () проверку, что содержание документа отображено полностью. Этотго метод может оставлять некоторое содержание неотображённым. Этот метод также готовит окно или фрейм для нового потока содержания с "пишущим" методом следующего документа . Не используйте, однако, document.close(), если Вы используете document.write () или document.writeln () динамически..

 
Возвращаемое значение
None.
 
Параметры
None.

createAttribute( ) NN n/a  IE 4   DOM n/a

createAttribute("AttributeName")

Генерирует объект атрибута и возвращает ссылку на последний. После вызова метода ему назначается значение, а затем объект добавляется в существующий элемент. Порядок инструкций слудующий:

var newAttr = document.createAttribute("width");
newAttr.nodeValue = "80%";
document.getElementById("myTable").setAttributeNode(newAttr);

 
Возвращаемое значение
Ссылка на объект атрибута.
 
Параметры
AttributeName Строка с именем атрибута (только его название).

createElement( ) NN 6  IE 4   DOM n/a

createElement("tagName")

Генерирует в памяти образец объекта, связанного с тэгом, прошедшим как параметр для метода. Используйте этот метод, чтобы создать новые элементы AREA и OPTION. Тогда Вы можете указать значениям свойств заполнить атрибуты элемента, типа свойства src объекта image. Любой новый элемент этих типов тогда должен быть добавлен к их коллекциям (методом add() ).

Порядок инструкций при создании объекта следующий:

var newText = document.createTextNode("Строка текста...");
var newElem = document.createElement("P");
newElem.id = "newestP";
newElem.appendChild(newText);
document.body.appendChild(newElem);

 
Возвращаемое значение
Ссылка на объект.
 
Параметры
tagName Строка названия тэга нового элемента в верхнем регистре: document.createElement("OPTION").

createEventObject( ) NN n/a  IE 5.5

createEventObject([объектСобытия])

Метод createEventObject() используется только в IE и создаёт объект event, который можно использовать как параметр в любом объекте элемента в методе fireEvent(). Объект, созданный этим событием применяется подобно объекту event, созданному пользователем или системой.

 
Возвращаемое значение
объект события.
 
Параметры
объектСобытия Новое событие.

createStyleSheet( ) NN n/a  IE 4   DOM n/a

createStyleSheet(["url"[, index]])

Создает и добавляет в документ новую таблицу стилей. С помощью этого метода Вы можете динамически присоединить внешнюю таблицу стилей в загруженный документ. Чтобы делать так, внесите URL внешнего .css файла как первый параметр. Если Вы предпочли бы писать сценарий добавления индивидуальных правил CSS для каждого объекта, Вы можете это делать только в версии Win32 . Оставьте пустую строку вместо первого параметра и затем, используйте метод addRule() объекта styleSheet для каждого правила, которое Вы желаете динамически добавить к таблице стилей.

 
Возвращаемое значение
Ссылка на объект CSS (Но нуль в IE 4/Macintosh).
 
Параметры
url Строка URL внешнего файла .css, определяющего таблицу стилей.
index Дополнительное отсчитываемое от нуля целое число, которое указывает, куда должна быть вставлена эта новая таблица стилей (индекс в styleSheets[] коллекции). Без этого параметра стиль добавляется в конец коллекции.

createTextNode( ) NN 6  IE 5

createTextNode("текст")

Текстовый узел - объект W3C DOM, который содержит основной текст, не принадлежащий ни одному дескриптору HTML (или XML). Обычно он находится в элементе HTML (или XML) как дочерний элемент. В IE для этого также применяется свойство innerText.

Чтобы вставить текст в элемент HTML, необходимо создать этим методом текстовый узел, а затем вставить его в узел HTML-элемента.

 
Возвращаемое значение
Текстовый объект
 
Параметры
текст Строка, которая станет содержанием текстового объекта

elementFromPoint( ) NN n/a  IE 4   DOM n/a

elementFromPoint(x, y)

Возвращает ссылку на объект,находящийся непосредственно на координатах пиксела, указанных горизонтальными (x) и вертикальными (y) параметрами. Элемент, который будет возвращён, должен реагировать на события мыши. Также, если больше одного элемента находится в том месте, метод возвращает элемент с самым высоким значением zIndex , а если у них равные значения zIndex, возвращается элемент, который является последним в порядке исходного кода.

 
Возвращаемое значение
Element Ссылка на объект.
 
Параметры
x Расстояние по горизонтали в пикселах относительно левого края окна или фрейма.
y Расстояние по вертикали в пикселах относительно верхнего края окна или фрейма.

execCommand( ) NN n/a  IE 4 (кроме IE 5/Mac)  DOM n/a

execCommand("commandName"[, UIFlag[, value]])

В IE5 содержится большой набор команд, которые не входят в состав методов, определённых для объектов в объектной модели. Эти команды доступны для программистов, использующих элементы ActiveX в IE.

Метод execCommand (), доступный только в IE 4 для платформы Win32, выполняет указанную как параметр команду. Большинство команд требует, чтобы для точки ввода сначала был создан объект TextRange .

 
Возвращаемое значение
Булево значение: true , если команда была успешна выполнена; false, если неудачно.
 
Параметры
commandName

Имя команды (строковое значение без учета регистра) . В таблице приведены те немногие команды, которые применяются ко всему документу или к любому текстовому объекту, а не только к объекту TextRange.

Команды метода document.execCommand()
Команда Параметр Описание
Refresh Нет Перезагрузка страницы
SelectAll Нет Выделение всего содержимого на странице
Unselect Нет Отмена любого выделения на странице
BackColor Строковое значение цвета Заключение выделенного фрагмента в дескриптор FONT, с помощью атрибута STYLE которого задаётся параметр background-color
CreateBookMark Строковое значение якоря Заключение выделенного фрагмента (или текстового диапазона) в элемент якоря, атрибут NAME которого приобретает значение параметра.
CreateLink Строковое значение URL-адреса Заключение выделенного фрагмента (или текстового диапазона) в элемент якоря, атрибут HREF которого приобретает значение параметра.
FontName Название шрифта Заключение выделенного фрагмента (или текстового диапазона) в элемент FONT, атрибут FACE которого приобретает значение параметра.
FontSize Строковое значение размера шрифта Заключение выделенного фрагмента (или текстового диапазона) в элемент FONT, атрибут SIZE которого приобретает значение параметра.
FontColor Строковое значение цвета Заключение выделенного фрагмента (или текстового диапазона) в элемент FONT, атрибут COLOR которого приобретает значение параметра.
Indent Нет Занесение в буфер выделенного фрагмента
JustifyCenter Нет Выравнивание выделенного фрагмента по центру
JustifyFull Нет Выравнивание выделенного фрагмента по ширине
JustifyLeft Нет Выравнивание выделенного фрагмента по левому краю
JustifyRight Нет Выравнивание выделенного фрагмента по правому краю
Outdent Нет Удаление выделенного фрагмента
RemoveFormat Нет Удаление форматирования для выделенного фрагмента
SelectAll Нет Выделение всего текста на странице
UnBookmark Нет Удаление дескрипторов якорей, содержащихся в выделенном фрагменте.
Unlink Нет Удаление дескрипторов ссылок, содержащихся в выделенном фрагменте.
Unselect Нет Снятие выделения с любого фрагмента в документе.
UIFlag Дополнительное Булево значение: true - отображать любой интерфейс пользователя, вызванный командой; false - не отображать.
value Параметр для команды.

getElementById( ) NN 6  IE 5

getElementById("идентификатор")

Метод применяется для задания ссылки на любой элемент в документе, чей идентификатор прошёл как параметр для метода. В основном его рекомендуется использовать в NN6, т.к в IE5+ существует нормально упорядоченная коллеккция document.all.

 
Возвращаемое значение
Ссылка на объект
 
Параметры
идентификатор Уникальный идентификатор элемента

getElementsByName( ) NN 6  IE 5

getElementsByName("имя")

Метод возвращает массив ссылок на объекты, атрибут name которых определяет имя элемента и передаётся как параметр для метода. В NN6 используются атрибуты name даже для элементов, которые не имеют их по умолчанию. В IE такого не происходит. Поэтому рекомендуется использовать данный метод только для явно определённых имён. Если элементов с данным именем метод в докумете не находит, он возвращает массив нулевой длины.

Пример:

var RadioButtonGroup = document.getElementsByName("radioGroupName");

 
Возвращаемое значение
Массив объектов
 
Параметры
имя Имя, присвоенное в дескрипторе или сценарии

getSelection( ) NN 4   IE n/a  DOM n/a

Фиксирует выделенный пользователем. Для IE, читайте свойство instead.

 
Возвращаемое значение
Строка.
 
Параметры
None.

handleEvent( ) только NN 4

handleEvent(event)

Инструктирует объект обрабатывать событие, чья спецификация представлена как параметр для метода. Объект должен иметь обработчик события для типа события, чтобы обработать его. Метод используется для переадресации события при явном перехвате его объектом документа.

 
Возвращаемое значение
None.
 
Параметры
event Объекты событий Navigator 4

open( ) NN 2   IE 3   DOM n/a

open("MIMEType"[, "replace"])

Открывает поток для записи в текущее окну или фрейм (в отличие от window.open, открывающем новое окно). Если метод document.clear() ещё не был вызван, метод document.open() автоматически вызывает его. Баги ранних версий браузеров могут вывести Вас из себя и заставить использовать методы document.write() и document.writeln().

Не рекомендуется использовать этот метод для того документа, в котором находится сценарий, т.к. это уничтожит все определённые переменные.

 
Возвращаемое значение
None.
 
Параметры
MIMEType Уведомляет браузер о типах данных MIME, записанных в дальнейшем. Navigator поддерживает: "text/html" (по умолчанию)| "text/plain" | "image/gif" | "image/jpeg" | "image/xbm" | "plugIn" |"application/x-director" и т.д.. В Internet Explorer 4 поддерживается только "text/HTML".
replace Этот параметр инструктирует браузер поменять местами элемент в списке хронологии текущего документа с документом, собирающимся загрузиться.

queryCommandEnabled( ) NN n/a  IE 4   (кроме IE5/Mac)

queryCommandEnabled("commandName")

Может ли команда быть исполнена настоящее время. Доступно только в IE 4 для Win32 .

 
Возвращаемое значение
Булево значение: true , если да; false, если нет.
 
Параметры
commandName Название команды (строка без учета регистра).

queryCommandIndeterm( ) NN n/a  IE 4   (кроме IE5/Mac)

queryCommandIndeterm("commandName")

Находится ли команда в состоянии "не определена" . Доступно только в IE 4 для Win32 ..

 
Возвращаемое значение
Булево значение: true | false.
 
Параметры
commandName Название команды (строка без учета регистра)..

queryCommandState( ) NN n/a  IE 4   (кроме IE5/Mac)

queryCommandState("commandName")

Определяет текущее состояние названной команды. Доступно только в IE 4 для Win32 ..

 
Возвращаемое значение
true если команда уже выполнена; false если команда не выполнена; null если состояние не может быть точно определено.
 
Параметры
commandName Название команды (строка без учета регистра)..

queryCommandSupported( ) NN n/a  IE 4   (кроме IE5/Mac)

queryCommandSupported("commandName")

Определяет, поддерживается ли названная команда объектом document. Доступно только в IE 4 для Win32 ..

 
Возвращаемое значение
Булево значение: true | false.
 
Параметры
commandName Название команды (строка без учета регистра)..

queryCommandText( ) NN n/a  IE 4   (кроме IE5/Mac)

queryCommandText("commandName")

Возвращает текст, ассоциированный с командой. Доступно только в IE 4 для Win32 ..

 
Возвращаемое значение
Строка.
 
Параметры
commandName Название команды (строка без учета регистра)..

queryCommandValue( ) NN n/a  IE 4   (кроме IE5/Mac)

queryCommandValue("commandName")

Возвращает значение, ассоциированное с командой ( типа шрифта выбранного текста ). Доступно только в IE 4 для Win32 ..

 
Возвращаемое значение
Зависит от команды.
 
Параметры
commandName Название команды (строка без учета регистра)..

recalc( ) NN n/a  IE 5

recalc(flag)

В IE5 представлена концепция динамических свойств. С помощью метода setExpression() для всех элементов и значений таблицы стилей expression() можно устанавливать зависимости между свойствами объектов и потенциально динамическими свойствами, такими как размер окна или расположение перетаскиваемого элемента. После того, как установлены эти зависимости, метод document.recalc() заставляет обновлять зависимости в ответ на некоторое действие пользователя, например, изменение размеров окна или перемещение элемента.

 
Возвращаемое значение
Зависит от команды.
 
Параметры
flag Если false (по умолчанию), то обновление выполняется только для выражений, в которых броузер обнаружил изменения, произошедшие со времени последнего обновления. В противном случае обновляются все выражения, независимо от того, изменились они или нет.

releaseEvents( ) NN 4   IE n/a  DOM n/a

releaseEvents(eventTypeList)

Противоположность методу document.captureEvents(), этот метод выключает события на уровне document для 1 или более определенных событий, указанных в как параметра.

 
Возвращаемое значение
None.
 
Параметры
eventTypeList Разделенный запятыми список типов событий (с учетом регистра) - доступных констант объекта Event, типа Event.CLICK или Event.MOUSEMOVE

routeEvent( ) NN 4   IE n/a  DOM n/a

routeEvent(event)

Используется внутри функции, вызывающейся обработчиком события, этот метод инструктирует Navigator позволить событию пройти к цели.

 
Возвращаемое значение
None.
 
Параметры
event A Navigator 4 event object

write( ), writeln( ) NN 2   IE 3   DOM n/a

write("string")

writeln("string")

Когда эти методы вызваны во время загрузки, они могут динамически добавлять содержание к странице. Когда эти методы вызваны после того, как страница загрузилась, обращение к методу очищает текущий документ, открывает новый выходной поток и записывает содержание в окно или фрейм. Поскольку первое обращение к методам document.write() или document.writeln() уничтожает текущий документ, не используйте две или более инструкции записи для создания нового документа. Вместо этого загрузите содержание в переменную и пропустите её как параметр для единственного метода document.write() или document.writeln() .

Различие между этими двумя методами - то, что document.writeln() добавляет символ перевода каретки к исходному тексту, записываемого в документ.

 
Возвращаемое значение
None.
 
Параметры
string Любое строковое значение, включая тэги HTML.Для записи тега <SCRIPT> используйте для скобок их ISO-эквивалент: &lt; SCRIPT &gt;.

Динамические коллекции:


anchors[ ] NN 2   IE 3   DOM 1

Возвращает массив всех объектов anchor в текущем документе. Включает элементы "a", которые предназначены или как якоря, или как комбинированные якоря и ссылки. Элементы в этом массиве индексированы (с нуля) в порядке исходного текста.

 
Синтаксис

document.anchors[index].objectPropertyOrMethod


applets[ ] NN 2   IE 3   DOM 1

Возвращает массив всех Java APPLETов в текущем документе. Апплет должен уже выполняться, чтобы его посчитали за объект. Элементы в этом массиве индексированы (начиная с нуля) в порядке исходного текста.

 
Синтаксис

document.applets[index].objectPropertyOrMethod


classes[ ] NN 4   IE n/a  DOM n/a

Используется в соответствии с синтаксисом JavaScript для таблиц стилей. Коллекция classes[] - часть ссылки на отдельный класс или свойство CSS..

 
Синтаксис

[document.]classes.className.stylePropertyName


embeds[ ] NN n/a  IE 4   DOM n/a

Возвращает массив всех внедренных объектов (элементы EMBED) в текущем документе. Элементы в этом массиве индексированы (начиная с нуля) в порядке исходного текста.

 
Синтаксис

document.embeds(index).objectPropertyOrMethod


forms[ ] NN 2   IE 3   DOM 1

Возвращает массив всех форм (элементы FORM) в текущем документе. Элементы в этом массиве индексированы (начиная с нуля) в порядке исходного текста.

 
Синтаксис

document.forms[index].objectPropertyOrMethod


frames[ ] NN n/a  IE 4   DOM n/a

Возвращает массив всех объектов IFRAME в текущем документе. Элементы в этом массиве индексированы (начиная с нуля) в порядке исходного текста.

 
Синтаксис

document.frames(index).objectPropertyOrMethod


ids[ ] NN 4   IE n/a  DOM n/a

Используется в соотвктствии с синтаксисом JavaScript для таблиц стилей, коллекция ids[] - часть ссылки на отдельный ID и свойство CSS, назначенное на него.

 
Синтаксис

[document.]ids.idName.stylePropertyName


images[ ] NN 2   IE 3   DOM 1

Возвращает массив всех изображений (IMG элементы) в текущем документе. Элементы в этом массиве индексированы (начиная с нуля) в порядке исходного текста.

 
Синтаксис

document.images[index].objectPropertyOrMethod


layers[ ] только NN 4

Данное свойство - массив слоёв, содержащихся в текущем документе. (см. объект layer) Этот объект удалён в NN6.

 
Синтаксис

document.images[index].objectPropertyOrMethod


links[ ] NN 2   IE 3   DOM 1

Возвращает массив всех объектов ссылок (элементы, чьи атрибуты HREF уже установлены, плюс все элементы AREA). Элементы в этом массиве индексированы (начиная с нуля) в порядке исходного текста.

 
Синтаксис

document.links[index].objectPropertyOrMethod


plugins[ ] NN n/a  IE 4   DOM n/a

Возвращает массив всех внедренных объектов (элементы EMBED) в текущем документе. Элементы в этом массиве индексированы (начиная с нуля) в порядке исходного текста.Не путайте эту коллекцию с коллекцией Navigator.plugins в Netscape Navigator.

 
Синтаксис

document.plugins(index).objectPropertyOrMethod


scripts[ ] NN n/a  IE 4   DOM n/a

Возвращает массив всех объектов SCRIPT в текущем документе. Каждый объект может содержать любое число функций. Коллекция scripts[] рассчитывает номера фактических тегов <SCRIPT> в документе. Элементы в этом массиве индексированы (начиная с нуля) в порядке исходного текста.

 
Синтаксис

document.scripts(index).objectPropertyOrMethod


styleSheets[ ] NN n/a  IE 4   DOM n/a

Возвращает массив всех объектов таблицы стилей в текущем документе. Каждый объект style может содержать любое число правил CSS. Коллекция styleSheets[] рассчитывает номер фактических тэгов <STYLE> в документе. Элементы в этом массиве индексированы (начиная с нуля) в порядке исходного текста.

 
Синтаксис

document.styleSheets(index).objectPropertyOrMethod


tags[ ] NN 4   IE n/a  DOM n/a

Используется в соотвктствии с синтаксисом JavaScript для таблиц стилей,Коллекция tags[] - часть ссылки на отдельный тип tag и свойство CSS, назначенное на него. Не путайте эту коллекцию Navigator tags[] с коллекцией Internet Explorer tags[] , которая принадлежит массиву all.

 
Синтаксис

[document.]tags.tagName.stylePropertyName


Определённые обработчики событий:




HIVE: All information for read only. Please respect copyright!
Hosted by hive КГБ: Киевская городская библиотека