Все HTML элементы NN6   IE4+

NN6 и IE4+ задают большой набор объектов, применяемых в сценариях, которые представляют собой "основные" элементы языка HTML. Основные элементы можно разделить на две группы. Одна группа, в которую входят, например, такие элементы, как B и STRIKE, определяет стили шрифтов, применяемые к вложенным текстовым последовательностям. Вторая группа элементов контекстно изменяет содержимое, заключённое в открывающий и закрывающий дескрипторы. Примерами контекстных элементов могут служить H1, BLOCKQUOTE и P.

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

К основным относятся объекты:

  1. Объекты форматирования: B, BIG, CENTER, I, NOBR, RT, RUBY, S, SMALL, STRIKE, SUB, SUP, TT, U, WBR и подобные
  2. Контекстные объекты: ACRONYM, ADDRESS, CITE, CODE, DFN, DEL, DIV, EM, INS, KBD, LISTING, P, PLAINTEXT, PRE, SAMP, SPAN, STRONG, VAR, XMP и подобные

Кроме того, нижеописанные элементы интерфейса применимы к:

  • Элементам формы
  • Изображениям
  • Объектам указания (HTML, SCRIPT, META, BASE и пр.), хоть это и неочевидно.
  • Внедряемым объектам
  • Объектам body и document

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

 
Эквивалент HTML

<Произвольный элемент>

 
Объектно-ориентированная модель
NN6, IE5+ document.getElementById("Идентификатор_объекта").свойство|метод([параметры])
IE 4 document.all.Идентификатор_объекта.свойство|метод([параметры])

Свойства:


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

Клавиша, которая активизирует элемент с клавиатуры. Броузер и операционная система определяют, должен ли пользователь нажать клавишу-модификатор (например, Ctrl, Alt, или Command(Mac)) с клавишей активации, чтобы "нажать" кнопку. В IE 4/Windows требуется клавиша Alt и клавиша, не чувствительная к регистру. Не работает в IE 4/Mac.

 
Пример:

document.forms["output"].access1.accessKey = elem.value

 
Возвращаемое значение:
Отдельный алфавитно-цифровой или пунктуационный символ клавиатуры.
 
Значение по умолчанию: Ничего

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

Свойство all представляет собой коллекцию (динамический массив) всех объектов элементов HTML и дескрипторов XML, содержащихся в текущем объекте.

Доступ к любому элементу возможен благодаря указанию идентификатора, присвоенного его аттрибуту ID, в строковой форме (а также целочисленного индекса). Для преобразования строки в ссылку достаточно просто указать элемент как индекс массива:

var paragraph = document.all["myP"]

IE позволяет для индексов одного набора использовать и квадратные, и круглые скобки.

var paragraph = document.all["myP"]
var paragraph = document.all("myP")

Если несколько элементов набора all имеют одинаковый ID, можно воспользоваться вторым аргументом для указания целочисленного индекса в исходном наборе, соответствующему определённому элементу:

var secondRadio = document.all("group0", 1)

 

 

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

attributes NN6   IE 5+
  Только чтение
Представляет собой массив аттрибутов, заданных для элемента. В IE5 этот массив содержит каждое возможное свойство, определённое для элемента, даже в том случае, когда атрибут не указан в тэге явно. Любые атрибуты, заданные при выполнении сценария (например, при помощи метода setAttribute()), не изменяют значений массива. Т.о., в IE5 массив attributes зафиксирован таким образом, что все атрибуты, не указанные явно в дескрипторе HTML, принимают значения по умолчанию. В NN6 свойство attributes возвращает массив, называемый картой именованных узлов (в терминологии W3C DOM).

 

 
Пример:

IE:

document.all.ID_элемента.attributes
document.all.tags("Дескриптор_HTML").attributes

NN:

document.getElementsByTagName("Дескриптор_HTML")[0].attributes
document.getElementById("ID_элемента").attributes

 

Возвращаемое значение:
Массив объектов attribute.

attribute представляет собой объект атрибута, присущего элементу HTML. В NN и IE реализованы различные представления о том, каким должен быть объект атрибута.

Синтаксис:

IE: document.all.ID_элемента.attributes[i]
document.all.tags("Дескриптор_HTML").attributes[i]
document.all.ID_элемента.getAttribute("атрибут")

NN: document.getElementsByTagName("Дескриптор_HTML")[j].attributes[i]
document.getElementById("ID_элемента").attributes[i]

Свойства объекта attribute:
attributes NN6 Массив вложенных атрибутов (всегда null)
childNodes NN6 Массив дочерних узлов
firstChild NN6 Первый дочерний узел
lastChild NN6 Последний дочерний узел
localName NN6 Имя в текущей области определения
name NN6 Имя атрибута
nameSpaceURI NN6 Имя пространства имён XML
nextSibling NN6 Следующий родственный узел
nodeName IE5, NN6 Имя атрибута
nodeType NN6 Тип узла (всегда 2)
nodeValue IE5, NN6 Значение, присвоенное атрибуту
ownerDocument NN6 Ссылка на содержащий документ
ownerElement NN6 Ссылка на узел элемента
parentNode NN6 Ссылка на родительский узел
prefix NN6 Префикс пространства имён XML
previousSibling NN6 Предыдующий родственный узел
specified IE6, NN6 Указывает, был ли атрибут задан в дескрипторе явно
value NN6 Значение, присвоенное атрибуту
 
Значение по умолчанию: Ничего

behaviorUrns NN n/a  IE5+
  Только чтение
 

Свойство behaviorUrns предназначено для того, чтобы содержать список адресов в форме URN (Uniform Resourse Locator) всех типов поведения, назначенных текущему объекту. При отсутствии поведений длина массива равна нулю. Однако на практике IE5 возвращает массив пустых строк.

 
Пример:

var num = document.all.myP.behaviorUrns.length;
var msg = "The myP element has " + num + " behavior(s).";
alret(msg);

 
Возвращаемое значение:

массив URN-строк поведения
 
Значение по умолчанию: Ничего.

canHaveChildren NN n/a  IE5+
  Только чтение
 

Показывает, может ли указанный элемент содержать дочерние элементы (в объектной модели DOM - вложенные элементы).

 
Пример:

for (var i = 0; i < document.all.length; i++) {
    if (document.all[i].canHaveChildren) {
        document.all[i].style.color = "red"
    }
}

 
Возвращаемое значение:

Булево значение
 
Значение по умолчанию: В зависимости от объекта.

canHaveHTML NN n/a  IE5+
  Только чтение
 

Показывает, может ли указанный элемент содержать HTML код. (Например, для P это true, а для HR - false)

 
Пример:

for (var i = 0; i < document.all.length; i++) {
    if (document.all[i].canHaveHTML) {
        document.all[i].style.color = "red"
    }
}

 
Возвращаемое значение:

Булево значение
 
Значение по умолчанию: В зависимости от объекта.

childNodes NN6  IE4+
  Только чтение
 

Данное свойство представляет собой объект узлов, содержащихся в текущем объекте. В зависимости от содержимого текущего объекта, количество элементов в childNodes и число наборов дочерних узлов могут отличаться.

Если массив childNodes просматривается в цикле for с целью обработки последовательности элементов HTML или XML, помните, что броузер может воспринимать пробелы в исходном коде (пустые строки или простые символы разрыва строки между элементами) как текстовые узлы. Этот баг присутствует в IE5/Mac и NN6.

Большая часть циклов, просматривающих объект childNodes, предназначена для проверки, подсчёта или изменения узлов элементов внутри набора. Если таковой является задача и вашего сценария, до того как производить обработку, проверьте каждый узел из массива childNodes и убедитесь, что свойство nodeType имеет значение 1 (элемент).
Примерная структура цикла перебора должна выглядеть следующим образом:

for (var i=0;i < myElem.childNodes.length;i++) {
    if (myElem.childNodes[i].nodeType == 1) {
        инструкции
    }
}

 
 
 
Возвращаемое значение:

Массив дочерних узлов
 
Значение по умолчанию: Ничего

children NN n/a  IE4+
  Только чтение
 

Свойство children представляет собой массив объектов элементов, содержащихся в текущем объекте. В отличие от свойства childNodes свойство children не учитывает текстовые узлы, а следует иерархии HTML (и XML) с точки зрения текущего объекта. Текущему объекту видны только дочерние элементы на первом уровне вложенности.

 
Пример:

group = obj.children
for (i = 0; i < group.length; i++) {
    инструкции
}

 
Возвращаемое значение:

Массив объектов элементов
 
Значение по умолчанию: В зависимости от объекта.

className NN6  IE4+
  Чтение/запись
 

Свойство children представляет собой массив объектов элементов, содержащихся в текущем объекте. В отличие от свойства childNodes свойство children не учитывает текстовые узлы, а следует иерархии HTML (и XML) с точки зрения текущего объекта. Текущему объекту видны только дочерние элементы на первом уровне вложенности.

 
Пример:

var elem = (document.all) ? document.all(elemID) : document.getElementById(elemID)
if (elem.className == "") {
    elem.className = "special"
}
else {
    elem.className = ""
}

 
Возвращаемое значение:

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

clientWidth, clientHeight, clientLeft, clientTop NN n/a  IE4+
  Только чтение
 

Согласно документации Microsoft, свойства clientWidth, clientHeight отражают высоту и ширину элемента (в пикселах), а clientLeft и clientTop - информацию о ширине границы элемента.

В IE4 эти свойства присущи только элементам:
clientWidth,clientHeight - body, button, caption, div, embed, fieldset, legend, marquee, table, td, textarea,th,tr.
clientLeft,clientTop - body, button, caption, embed, fieldset, legend, marquee, textarea.

 
Пример:

var paragraphW = document.all.myDIV.clientWidth
var paragraphH = document.all.myDIV.clientHeight

 
Возвращаемое значение:

Целочисленное
 
Значение по умолчанию: Ничего

contentEditable NN n/a  IE5.5
  Чтение/запись
 

В IE5.5 предствлена концепция редактируемого HTML-содержимого страницы. Дескрипторы элементов могут включать атрибут CONTENTEDITABLE, чьё значение содержится в свойстве contentEditable. По умолчанию значение свойства равно inherit. Это значит, что свойство наследует установки контейнеров иерархической структуры HTML за пределами тела элемента. Если свойство имеет значение true, элемент и все вложенные в него элементы наследуют это значение, делая содержимое редактируемым; и наоборот.

 
Пример:

var newState = !editableText.isContentEditable
editableText.contentEditable = newState

 
Возвращаемое значение:

Булево значение
 
Значение по умолчанию: inherit

currentStyle NN n/a  IE5+
  Только чтение
 

Свойство возвращает предназначенный только для чтения объект style, содержащий значения всех свойств style, применимых к элементу.

 

 

 
Возвращаемое значение:

объект style
 
Значение по умолчанию: Ничего

dataFld, dataSrc, dataFormatAs NN n/a  IE4+
  Чтение/запись
 

Данные свойства являются частью средств IE внедрения данных с помощью элементов управления ActiveX, встроенных в броузер и используемых для прямой передачи данных между Web-страницей и их источником. К источникам данных относят текстовые файлы, файлы HTML, XML и внешние базы данных. С помощью средств внедрения данных любая страница способна получать доступ, сортировать, отображать и фильтровать (но не обновлять) данные, загруженные на страницу из внешнего текстового файла. Загрузить данные из внешнего текстового файла позволяет средство TDS (Tabular Data Control). Ссылка на данные задаётся с помощью объекта TDS внутри дескриптора <object> и дополнительных параметров, таких, например, как URL текстового файла и символов-разделителей полей. Элемент <object> может находиться в любом месте документа внутри элемента <body>. Объект имеет в HTML следующий синтаксис:

<object id="objName" classid="clsid:333C7BC4-460F-11D0-BC04-0080C7055A83">
<param name="DataUrl" value="URL">
[дополнительные параметры]
</object>

В таблице перечислены параметры объекта TDC:

Параметры объекта Tabular Data Control
CharSet Кодовая страница исходного файла с данными. По умолчанию - Latin1
DataUrl URL файла с данными (относителбный или абсолютный)
EscapeChar Символы перехода, которые являются также разделителями данных. По умолчанию значение не установлено. Обычно указывают символ "\"
FieldDelim Символ-разделитель полей в записи. По умолчанию запятая (&#09;)
Language Код языка ISO исходных данных. По умолчанию en-us
TextQualifer Дополнительный символ, окружающий поля данных. По умолчанию значение не установлено.
RowDelim Символ-разделитель записей. По умолчанию символ новой строки (NL).
UseHeader Имеет значение true, если первая строка данных в файле содержит имена полей. Значени по умолчанию false

Значение ID элемента является его идентификатором и должно быть уникальным.
Исходное внедрение данных в элементы HTML обычно происходит при присвоении значений атрибутам элементов dataSrc и dataFld. Атрибут dataSrc указывает на идентификатор DSO (совпадающий с атрибутом ID элемента OBJECT с символом # впереди), а атрибут dataFld - на имя поля, из которого следует извлечь данные. Когда внедрение данных выполняется для такого элемента, как таблица, записи представляются как последовательные строки таблицы. Если необходимо, чтобы элемент HTML, отличный от таблицы, отображающий данные, мог изменить их, следует указать значения свойств dataFld и dataSrc. Эти свойства применимы к поднабору элементов HTML, которым можно поставить в соответствие внешние данные: объекты A, APPLET, BODY, BUTTON, DIV, FRAME, IFRAME, IMG, почти все INPUT, LABEL, MARQUEE, OBJECT, PARAM, SELECT, SPAN и TEXTAREA. В некоторых случаях источники данных могут содержать блоки форматированного HTML-текста, который необходимо отображать внутри элемента. Если не указано обратное, броузер отображает поля исходных данных как обычный текст, даже если в нём содержатся дескрипторы HTML-форматирования. Для того, чтобы при отображении учитывался и код HTML, свойство dataFormatAs (или, скорее, атрибут дескриптора DATAFORMATAS) необходимо установить в значение "HTML".

 
Пример:

document.all.display.dataSrc = "#rights_raw"
document.all.display.dataFld = "column1"
document.all.display.dataFormatAs = "text"

 
Возвращаемое значение:

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

dir NN6  IE5+
  Чтение/запись
 

Свойство dir основано на атрибуте DIR любого текстового элемента HTML. Оно управляет тем, как отображается текст элемента: слева направо или справа налево.

 

 

 
Возвращаемое значение:

ltr или rtl
 
Значение по умолчанию: ltr

disabled NN6   IE4+
  Чтение/запись
 

Является ли элемент активным. В то время как в IE 4 и 5 это свойствоимеют лишь некоторые элементы, в IE5.5 это свойство присуще всем элементам HTML. Следует брать во внимание, что данные неактивного элемента формы не отправляются на сервер.

 

 

 
Возвращаемое значение:

Булево значение
 
Значение по умолчанию: false

document NN6   IE4+
  Только чтение
 

Ссылка на документ, содержащий данный объект. Аналогичо свойству ownerDocument в IE5.5

 

 

 
Возвращаемое значение:

объект document
 
Значение по умолчанию: Объект document

filters NN n/a   IE4+
  Только чтение
 

Фильтры - специфические для IE дополнения к таблицам стилей, отвечающие за эффекты в представлении содержимого. Каждая спецификация фильтра является объектом filter. Свойство filters содержит массив объектов filter. В IE5.5 фильтры применяются для следующих элементов: BODY, MARQUEE, OL, TABLE, TD, TEXTAREA, TH, UL, DIV и SPAN.

 

 

 
Возвращаемое значение:

Массив
 
Значение по умолчанию: Ничего

firstChild, lastChild NN6   IE5+
  Только чтение
 

Объектные модели, основанные на W3C DOM, построены соответственно архитектуре, известной как "схема узлов". Каждый объект, определёный в HTML, является узлом на этой схеме. Каждый из них взаимосвязан с другими узлами. Взаимоотношения описываются следующими терминами: parents(родительские), subling(родственные), children(дочерние).
Дочерний узел - элемент, содержащийся в другом элементе. Контейнер является родительским по отношению к такому элементу. Список дочерних элементов можно получить, используя свойство childNodes:
var nodeArray = document.getElementById("ID_элемента").childNodes;
Свойства firstChild и lastChild указывают на первый и последний (соответственно) элементы данного массива.

 

Пример:

var lastLI = document.getElementById("myList").lastChild

 
Возвращаемое значение:

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

height, width NN4+   IE4+
  Только чтение, запись только для некоторых элементов
 

Указывают на ширину и высоту элемента. Не стоит их путать с одноимёнными свойствами стиля. Одноимённые свойства стиля могут перекрывать указанные свойства.
В NN4 данные свойства имеет только объект Image.

 
 
 
Возвращаемое значение:

целочисленное (когда в пикселах) или строковое (когда в процентах)
 
Значение по умолчанию: Определено в HTML коде

hideFocus NN n/a   IE5.5
  Чтение/запись
 

Свойство позволяет не отображать пунктирную границу при активизации. Но отключение пунктирной линии не отменяет саму активизацию. Соответствующего атрибута HTML не существует.

 
 
 
Возвращаемое значение:

Булево значение
 
Значение по умолчанию: false

id NN6   IE4+
  Только чтение
 

Возвращает идентификатор элемента, присвоенный в атрибуте ID. Свойство позволяет присвоить идентификатор только при создании элемента в сценарии.

 
 
 
Возвращаемое значение:

Строка
 
Значение по умолчанию: Определено в HTML коде

innerHTML, innerText NN6(только innerHTML)   IE4+
  Чтение/запись
 

Данные свойства позволяют получать доступ к содержимому элемента. Задание этих свойств - распространённый способ динамического изменения содержания элемента. Свойство innerHTML задаёт не только текстовое содержание, но и все дескрипторы HTML в нём. При присвоении свойству строки с HTML-содержимым на страницу автоматически добавляются элементы, динамически изменяя объектное содержимое.
Свойство же innerText включает только текстовое содержимое.

 

Пример:

var content = form.HTMLInput.value
if (content) {
    document.all.label1.innerHTML = content
}
 
Возвращаемое значение:

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

isContentEditable NN n/a   IE5.5
  Только чтение
 

Свойство isContentEditable возвращает значение булевого типа, указывающее, является ли объект элемента редактируемым.

 

Пример:

var newState = !editableText.isContentEditable
 
Возвращаемое значение:

Булевого типа
 
Значение по умолчанию: inherit

isDisabled NN n/a   IE5.5
  Только чтение
 

Свойство isDisabled возвращает значение булевого типа, указывающее, является ли определённым объект элемента отключённым. Оно соответствует текущему состоянию элемента.

 

 

 
Возвращаемое значение:

Булевого типа
 
Значение по умолчанию: false

isMultiLine NN n/a   IE5.5
  Только чтение
 

Возвращает значение Булевого типа, показывающее, может ли элемент занимать или отображать более одной строки текста. Свойство не указывает, занимает или нет элемент несколько строк, оно демонстрирует лишь возможность или невозможность этого.

 

 

 
Возвращаемое значение:

Булевого типа
 
Значение по умолчанию: В зависимости от объекта.

isTextEdit NN n/a   IE4+
  Только чтение
 

Свойство isTextEdit указывает, можно ли на основе его содержимого создать объект TextRange. В IE5/Mac свойство всегда возвращает false.

 

 

 
Возвращаемое значение:

Булевого типа
 
Значение по умолчанию: В зависимости от объекта.

lang NN6   IE4+
  Чтение/запись
 

Свойство управляет набором символов, используемых для отображения текстового элемента, когда настройки броузера по умолчанию не применяются. Если атрибуту LANG дескриптора HTML не присвоено значение, свойство возвращает пустую строку.

 

 

 
Возвращаемое значение:

Кодовая страница языка ISO
 
Значение по умолчанию: Пустая строка

language NN n/a   IE4+
  Чтение/запись
 

Свойство показывает, какой язык сценариев требуется использовать для обработки операторов. IE4 понимает значения JScript, JavaScript, VBScript, VBS. IE5 понимает также и XML.

 

 

 
Возвращаемое значение:

Строка
 
Значение по умолчанию: JavaScript

length NN2+   IE3+
  Чтение/запись (для некоторых элементов - только чтение)
 

Возвращает число элементов в массиве, коллекции или наборе (группе) объектов.

 

Пример:

for (var i=0; i<someArray.length;i++) { инструкции }
 
Возвращаемое значение:

Целочисленное значение
 
Значение по умолчанию: В зависимости от объекта.

localName, namespaceURI, prefix NN6
  Только чтение
 

Эти три свойства применимы к любому узлу в XML-документе, в котором в дескрипторе XML задаётся пространство имён URI. Хотя в NN6 все три свойства присущи для всех объектов элементов (и узлов), эти свойства не возвращают требуемых значений.

 

Пример:

<x xmlns:bk='http://bigbooks.org/schema'>
<bk:title>To kill a Mockingbird</bk:title>
</x>

Здесь элементу дескриптора <bk:title> задаётся пространство имён URI, определённое дя блока кода, поэтому свойство namespaceURI элемента возвратит строку http://bigbooks.org/schema. Имя дескриптора состоит из префикса (до двоеточия) и локального имени (после двоеточия), которые и являются значениями соответствующих свойств: у <bk:title> prefix=bk, а localName=title.

 
Возвращаемое значение:

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

nextSibling, previousSibling NN6   IE5+
  Только чтение
 

Данные свойства указывают соответственно на следующий и предыдущий родственный элемент (на том же уровне вложенности) в порядке исходного текста.

 

 

 
Возвращаемое значение:

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

nodeName NN6   IE5+
  Только чтение
 

Для элементов HTML и XML имя узла совпадает с именем дескриптора. Свойство nodeName включено для совместимости с архитектурой узлов, описанных стандартом W3C DOM. Значение свойства - строка с именем дескриптора в верхнем регистре.

 

 

 
Возвращаемое значение:

Строка
 
Значение по умолчанию: Определено в HTML коде

nodeType NN6   IE5+
  Только чтение
 

Спецификация W3C DOM определяет набор констант, которые указывают тип узла. Не все эти значения реализованы в броузерах, совместимых с W3C DOM, хотя NN6 включает на две константы больше, чем IE.

Значения, поддерживаемые текущими версиями броузеров
1 Узел элемента IE5+ NN6
2 Узел атрибута IE5/Mac NN6
3 Текстовый узел (#text) IE5+ NN6
8 Узел комментария IE5/Mac NN6
9 Узел документа IE5/Mac NN6

Значение nodeType автоматически присваивается каждому элементу независимо от того, как тт был создан.
Эти значения эквивалентны константам свойства Node.

Полный набор констант nodeType, определённый в спецификации W3C DOM
Node.ELEMENT_NODE 1
Node.ATTRIBUTE_NODE 2
Node.TEXT_NODE 3
Node.CDATA_SECTION_NODE 4
Node.ENTITY_REFERENCE_NODE 5
Node.ENTITY_NODE 6
Node.PROCESSING_INSTRUCTIONS_NODE 7
Node.COMMENT_NODE 8
Node.DOCUMENT_NODE 9
Node.DOCUMENT_TYPE_NODE 10
Node.DOCUMENT_FRAGMENT_NODE 11
Node.NOTATION_NODE 12
 

 

 
Возвращаемое значение:

Целочисленное значение
 
Значение по умолчанию: В зависимости от объекта.

nodeValue NN6   IE5+
  Чтение/запись
 

Из всех типов узлов, поддерживаемых стандартом W3C DOM, только текстовые узлы и узлы атрибутов возвращают отличное от null значение.
Для текстовых узлов это реальный текст, находящийся в нём.
Для узлов атрибутов это значение, присвоенное атрибуту (в виде строки). Если значение атрибута содержит только цифры, IE5/Windows преобразует это значение к типу Number. Другие броузеры преобразуют любое значение к типу String

 

 

 
Возвращаемое значение:

Число, строка или null
 
Значение по умолчанию: В зависимости от объекта.

offsetHeight, offsetWidth NN6   IE4+
  Только чтение
 

Свойства возвращают ширину и высоту элемента в пределах окружающего контейнера по аналогии с clientWidth, clientHeight. Отличие заключается в том, что они имеют значение даже тогда, когда элемент создаётся сценарием. Описание этих свойств в документации Microsoft неоднозначно, и они ведут себя по-разному в разных версиях броузеров.

 

 

 
Возвращаемое значение:

Целочисленное значение
 
Значение по умолчанию: В зависимости от объекта.

offsetLeft, offsetTop NN6   IE4+
  Только чтение
 

Свойства отображают координаты элемента, позиционируемого внутри родительского контейнера, даже если эти элементы не позиционируются явно. Аналог - свойства clientLeft, clientTop. Элемент, служащий точкой отсчёта - узел, возвращаемый свойством offsetParent. Разные версии броузеров по-разному трактуют эти свойства

 

 

 
Возвращаемое значение:

Целочисленное значение
 
Значение по умолчанию: В зависимости от объекта.

offsetParent NN6   IE4+
  Только чтение
 

Свойство возвращает ссылку на объект, действующий как точка отсчёта позиционирования текущего элемента. Свойства offsetLeft и offsetTop измеряются относительно левого верхнего угля элемента offsetParent.
При использовании данного свойства для ячеек таблицы следует учесть следующие особенности броузеров

Броузер Свойство offsetParent элемента TD
IE4/Windows TR
IE5+/Windows TABLE
IE/Mac TABLE
NN6 BODY

Поведение свойства в NN и IE весьма различно.

 

Пример:

var useClient = (cElement.offsetTop == 0) ? ((cElement.offsetParent.tagName == "TR") ? false : true) : false;
if (useClient) {
    var x = cElement.clientLeft
    var y = cElement.clientTop
}
    else {
    var x = cElement.offsetLeft
    var y = cElement.offsetTop
}

 
Возвращаемое значение:

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

outerText, outerHTML NN n/a   IE4+
  Чтение/запись
 

Свойство outerText возвращает текст, заключённый в злемент. В большинстве случаев оно аналогично свойству innerText.
Свойство outerHTML содержит не только текст, отображаемый на странице, но и все дескрипторы HTML внутри элемента, включая дескрипторы элемента. Присвоение свойству значения пустой строки позволяет удалить элемент со страницы.
Данные свойства в IE4/Mac поддерживаются не всеми элементами.

 

Пример:

function setGroupLabelAsText(form) {
    var content = form.textInput.value
    if (content) {
        document.all.label1.outerText = content
    }
}

function setGroupLabelAsHTML(form) {
    var content = form.HTMLInput.value
    if (content) {
        document.all.label1.outerHTML = content
    }
}

 
Возвращаемое значение:

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

ownerDocument NN6
  Только чтение
 

Свойство ownerDocument содержит узел document, в котором содержится данный элемент. В NN6 это свойство имеет каждый элемент. Эквивалент IE - свойство document

 
 
 
Возвращаемое значение:

Ссылка на объект document
 
Значение по умолчанию: объект document

parentElement NN n/a   IE4+
  Только чтение
 

Свойство возвращает ссылку на родительский элемент. Такое взаимоотношение между элементами часто, но не всегда, совпадает со взаимоотношением между узлами в NN6. Различие заключается в том, что parentElement может содержать только объекты HTML.
Различие же между свойствами parentElement и offsetParent в том, что offsetParent возвращает элемент, являющийся точкой отсчёта при позиционировании, а parentElement - элемент, внутри которого содержится текущий согласно исходного кода.
У элемента "HTML" свойство всегда равно null.

 
 
 
Возвращаемое значение:

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

parentNode NN6   IE5+
  Только чтение
 

Свойство содержит ссылку на узел, являющийся родительским по отношению к данному. В большинстве случаев оно эквивалентно свойству parentElement, но может быть использовано и для узлов текстового типа (кроме IE).

 
 
 
Возвращаемое значение:

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

parentTextEdit NN n/a   IE4+
  Только чтение
 

Свойство используется для нахождения ближайшего к объекту внешнего контейнера, способного генерировать текстовый блок. Немногие элементы в IE способны генерировать блоки текста. Если элемент содержится в иерархии, возвращается ссылка на объект. В противном случае возвращается null. Не работает в IE5/Mac.

 

Пример:

var x = window.event.clientX
var y = window.event.clientY
if (window.event.srcElement.parentTextEdit) {
    range = window.event.srcElement.parentTextEdit.createTextRange()
    range.collapse()
    range.moveToPoint(x, y)
    range.expand(chunk)
    range.select()
}

 
Возвращаемое значение:

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

readyState NN n/a   IE4+
  Только чтение
 

Свойство readyState показывает состояние загрузки элемента. Оно может принимать значения:

Значение HTML Значение OBJECT Описание
complete 4 Элемент и данные полностью загружены
interactive 3 Данные загружены не полностью, но пользователь иожет взаимодействовать с элементом.
loaded 2 Объект может начинать использоваться
loading 1 Данные загружаются
uninitialized 0 Объект ещё не начал загрузку данных

В IE4 свойство ограничено такими объектами, как то: document, EMBED, IMG, LINK, OBJECT, SCRIPT, и STYLE. В IE5+ оно доступно почти для всех элементов.

 
 
 
Возвращаемое значение:

Строка (целочисленное для объекта OBJECT)
 
Значение по умолчанию: Ничего

recordNumber NN n/a   IE4+
  Только чтение
 

Cвойство recordNumber применяется при внедрении объектов в IE для представления повторяющихся данных. Например, при отображении 30 записей из внешнего источника данныхв таблице элемент TR встречается только один раз, однако IE повторяет строку таблицы для размещения всех 30 строк данных. Если объект не привязан к источнику данных или не является повторяющимся, свойство содержит значение null.

 

Пример:

function setRecNum(row) {
    document.oscars.recordset.AbsolutePosition = row.recordNumber
}

 
Возвращаемое значение:

Целочисленное или null.
 
Значение по умолчанию: Ничего

runtimeStyle NN n/a   IE5+
  Только чтение
 

С помощью свойства runtimeStyle можно определить настройки стилей броузера по умолчанию. Объект style, который возвращает это свойство, принимает все атрибуты стилей и настройки по умолчанию во время загрузки страницы. Это свойство не отображает значений, присвоенных элементам стилевыми спецификациями в документе или в сценариях. Свойство runtimeStyle показывает неустановленные значения стиля как пустые или нулевые.

 
 
 
Возвращаемое значение:

Объект Style.
 
Значение по умолчанию: Ничего

scopeName NN n/a   IE5+
  Только чтение
 

Это свойство связано напрямую непосредственно с данными XML, включёнными в документ. При подключении XML-кода указывается одно или несколько пространств имён XML, определяющих владельца определённого дескриптора. Пространство имён XML определяется как атрибут дескриптора <HTML>, целиком окружающего документ.

<HTML XMLNS:Fred="http://www.someURL.com">

После этого значение пространства имён включается во все дескрипторы документа.

<Fred:FIRST_Name ID="fredFirstName"/>

Чтобы найти владельца пространства имён, необходимо получить его свойство scopeName. В предыдущем примере оно имеет значение Fred.
Для обычных элементов HTML возвращаемое значение всегда равно HTML

 
 
 
Возвращаемое значение:

Строка
 
Значение по умолчанию: HTML

scrollHeight, scrollWidth NN n/a   IE4+
  Только чтение
 

Описание этих двух свойств неоднозначно. Оно основано на документации Microsoft. Неоднозначны и способы реализации в версиях Windows и Macintosh Internet Explorer 4. Мое предположение, что эти свойства предназначены для того, чтобы измерить высоту и ширину элемента "полоса прокрутки" (в пикселах), даже когда часть страницы не видна и может быть не замечена. Версия Macintosh интерпретирует свойство, подразумевая содержание страницы, которое Вы можете видеть в любой момент. Важный пункт - то, что для ключевых элементов, типа BODY, свойства означают различные вещи и могут разрушать межплатформенную совместимость.

В IE4 эти свойства присущи лишь элементам BODY, BUTTON, CAPTION, DIV, FIELDSET, LEGEND, MARQUEE и TEXTAREA.
В IE5+ они доступны почти всем элементам

 
 
 
Возвращаемое значение:

Целое число
 
Значение по умолчанию: Ничего.

scrollLeft, scrollTop NN n/a   IE4+
  Только чтение
 

Расстояние в пикселах между левым или верхним краем элемента и фактическим содержанем элемента. Установка этих свойств позволяет Вам использовать сценарий, чтобы корректировать прокрутку содержания в пределах прокручиваемого контейнера, типа текста в TEXTAREA элементе или полного документа в окне броузера или фрейме. Когда содержание не пролистано, оба значения нулевые. Установка scrollTop свойства как 15 прокручивает документ вверх в окне на 15 пикселов ; свойство scrollLeft равно 0, если явно не изменено. Изменение значений свойства похоже на прокручивание содержимого пользователем.

В IE4 эти свойства присущи лишь элементам BODY, BUTTON, CAPTION, DIV, FIELDSET, LEGEND, MARQUEE, SPAN и TEXTAREA.
В IE5+ они доступны почти всем элементам

 
 
 
Возвращаемое значение:

Целое число
 
Значение по умолчанию: Ничего.

sourceIndex NN n/a   IE4+
  Только чтение
 

Возвращает числовой индекс объекта в коллекции document.all

 
 
 
Возвращаемое значение:

Целое число
 
Значение по умолчанию: Ничего.

style NN6   IE4+
  Чтение/запись
 

Свойство style представляет собой шлюз к настройкам стилей элемента. Значением свойства является объект style, чьи собственные свойства позволяют получать и изменять установки стилей

 
 
 
Возвращаемое значение:

Ссылка на объект style
 
Значение по умолчанию: Ничего.

tabIndex NN6   IE4+
  Чтение/запись
 

Данное свойство управляет тем, в какой момент при нажатии клавиши Tab элемент активизируется.
Если свойство равно 0 (-1 в NN), элемент активизируется в порядке исжодного текста.
Если свойство равно -1 (в IE), элемент полностью устраняется из последовательности активизируемых объектов

 

Пример:

for (var i = 0; i < forms[0].elements.length; i++) {
    forms[0].elements[i].tabIndex = 0
}
 
Возвращаемое значение:

Целое число
 
Значение по умолчанию: 0

tagName NN6   IE4+
  Только чтение
 

Свойство возвращает строку с именем дескриптора HTML или (IE5+, NN6) XML объекта элемента.
Все значения tagName содержат символы только верхнего регистра

 
 
 
Возвращаемое значение:

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

tagUrn NN n/a   IE5+
  Только чтение
 

Свойство tagUrn связано с кодом XML, включённым в документ. Пространство имён может включать унифицированное имя ресурса URN, то есть ссылку на место в сети, где подробнее указано поведение дескриптора элемента XML. Пространство имён XML определяется как атрибут дескриптора <HTML>, целиком окружающего документ.

<HTML XMLNS:Fred="http://www.someURL.com">

После этого значение пространства имён включается во все дескрипторы документа.

<Fred:FIRST_Name ID="fredFirstName"/>

Чтобы определить URN пространства имён владельца элемента, необходимо обратиться к его свойству tagUrn. В предыдущем примере оно имеет значение http://www.someURL.com.
Для обычных элементов HTML возвращаемое значение всегда равно null

 
 
 
Возвращаемое значение:

Строка.
 
Значение по умолчанию: null

title NN6   IE4+
  Чтение/запись
 

Свойство title используется как подсказка, это текст, появляющийся при наведении пользователем курсора на элемент.
Такие характеристики, как шрифт и цвет подсказки, устанавливает броузер. Их нельзя изменить средствами сценария.

 
 
 
Возвращаемое значение:

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

uniqueID NN n/a   IE5+
  Только чтение
 

Данное свойство в IE позволяет генерировать идентификатор элемента, создаваемого на странице динамически. Этим свойством рекомендуется пользоваться, когда сценариям необходимо, чтобы неизвестный элемент имел идентификатор, но сами алгоритмы не зависели от конкретного идентификатора

 
 
 
Возвращаемое значение:

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

Методы:


addBehavior() NN n/a  IE5+
addBehavior("URL")  
 

Метод addBehavior() импортирует внешнее поведение IE и присоединяет его к текущему объекту, расширяя его свойства и методы. IE включает библиотеку встроенных (по умолчанию) поведений, чьи URL имеют следующий формат:

#default#имя_поведения

Если поведение импортируется в документ при помощи дескриптора OBJECT, то параметром является строка следующего формата:

#идентификатор_объекта

К поведениям, загружаемым из внешних файлов, применяются правила безопасности доменов. Компонента поведения и страница HTML, загружающая её, должны принадлежать одному серверу из одного домена; кроме того, они должны быть загружены по одному протоколу

Пример:

myPBehaviorID = document.all.myP.addBehavior("makeHot.htc")

 
Возвращаемое значение
Целочисленный идентификатор
 
Параметры
URL ссылка URL на компоненты поведения (в файле с расширением .htc)

addEventListener(), removeEventListener() NN6
addEventListener("типCобытия", функцияПолучателяСобытия, захват)
removeEventListener("типCобытия", функцияПолучателяСобытия, захват)
 
 

В броузерах, поддерживающих модель событий W3C, происходит внутреннее преобразование методов привязывания событий - например обработчиков событий атрибутов - в приёмники событий.
Чтобы сообщить объектной модели документа, что элемент должен принимать определённый тип события, необходимо воспользоваться методом addEventListener.
Использование метода addEventListener требует, чтобы объект, к которому присоединён метод, уже существовал.
Сценарий обладает возможностью удалить приёмник события, который ранее был добавлен сценарием. Для этого используется метод removeEventListener

Пример:

document.getElementById(elemID).addEventListener("click", reportEvent, false)

 
Возвращаемое значение
Отсутствует
 
Параметры
типCобытия

строка с типом события, который должен приниматься элементом (без перфикса on). В таблице перечислены все события, заданные спецификацией W3C DOM, хотя и не все из них поддерживаются в NN6.

abort
blur
change
click
DOMActivate
DOMCharacterDataModifed
DOMFocusIn
DOMFocusOut
DOMNodeInserted
DOMNodeInsertedIntoDocument
DOMNodeRemoved
DOMNodeRemovedFromDocument
DOMSubtreeModified
error
focus
load
mousedown
mousemove
mouseout
mouseover
mouseup
reset
resize
scroll
select
submit
unload
функцияПолучателяСобытия   ссылка на функцию JavaScript. Название не должно помещаться в кавычки, в вызове функции нельзя указывать параметры
захват если равно true, то захват определённого типа события разрешён всякий раз, когда текущий объект является целевым. Это значит, что событие любого другого типа, целью которого является текущий объект, переместится по иерархии, если только оно также не имеет приёмника события, связанного с объектом, третий параметр которого установлен в значение true

appendChild() NN6  IE5+
appendChild(объектЭлемента)  
 

Использование понятий родительского и дочернего узлов позволяют создать код, не зависящий от броузера (IE5+, NN6).
Метод appendChild() вставляет элемент или текстовый узел (определённый ранее) в качестве нового, последнего дочернего объекта текущего элемента. Например, чтобы создать элемент B и его содержимое, необходимо вначале создать элемент, а затем присоединить текстовый узел:

var newB = document.createElement("B");
newB.appendChild(document.createTextNode("Important"));

Пример:

document.getElementById("myUL").appendChild(newItem)

 
Возвращаемое значение
ссылка на объект узла
 
Параметры
объектЭлемента

  Ссылка на объект (который создаётся методом createElement и подобными)


applyElement() NN6  IE5+ (кроме IE5/Mac)
applyElement(объектЭлемента[,тип])  
 

Метод позволяет вставить новый элемент в качестве родительского или дочернего элемента текущего объекта. Новый объект заключает в себя текущий (если новый элемент является родительским) или наоборот (если новый элемент является дочерним). Когда новый элемент становится дочерним, все предыдущие дочерние объекты становятся вложенными в него (смещаются на один уровень).

Пример:

var newItem = document.createElement("EM")
newItem.id = newItem.uniqueID
document.all.mySpan.applyElement(newItem)

 
Возвращаемое значение
Отсутствует
 
Параметры
объектЭлемента Ссылка на объект (который создаётся методом createElement и подобными)
тип

Дополнительный параметр, который может принимать одно из следующих значений:

outside Новый элемент становится родительским для текущего (по умолчанию)
inside Новый элемент становится первым дочерним узлом текущего

attachEvent(), detachEvent() NN n/a  IE5+
attachEvent("имяСобытия", ссылкаНаФункцию)
detachEvent("имяСобытия", ссылкаНаФункцию)
 
 

Метод attachEvent() применяется, в основном, дляопределения поведения IE, но его можно также использовать для привязки обработчика событий к объекту. Метод detachEvent() выполняет обратное действие. Он не может отключить события, привязка которых была выполнена в атрибутах дескриптора или установкой свойств события.

Пример:

myObject.onmousedown = setHilite
//равносильно
myObject.attachEvent("onmousedown", setHilite)

 
Возвращаемое значение
Булевого типа
 
Параметры
имяСобытия строка с именем события в кавычках
ссылкаНаФункцию

идентификатор функции (без параметров)


blur(), focus() JavaScript1.0
   
 

blur() удаляет фокус из текущего элемента и обрабатывает событие onBlur (в IE). Никакой другой элемент в связи с этим не получает фокус .
focus() передает фокус текущему элементу и автоматически обрабатывает для него событие onFocus (в IE). Если другие элементы имели фокус в то время, то для них обрабатывается событие onBlur.
Броузеры до IE4 и NN6 имели ограниченную поддержку этих методов

Пример:

newWindow = window.open("","","width=250,height=250")
newWindow.focus()

 
Возвращаемое значение
Отсутствует
 
Параметры
нет

clearAttributes() NN n/a  IE5+
   
 

Метод удаляет все атрибуты элемента за исключением NAME и ID. Он не удаляет атрибуты физически, а лишь устанавливает их в значения, которые они имели бы по умолчанию

 
Возвращаемое значение
Отсутствует
 
Параметры
нет

click() JavaScript1.0
   
 

Метод click() позволяет сценарию произвести действие, эквивалентное щелчку на элементе.
Броузеры до IE4 и NN6 имели ограниченную поддержку этих методов.
В броузерах до NN4 и IE4 метод не вызывает событие click, поэтому для них необходимо указывать операторы обработчика события напрямую.

 
Возвращаемое значение
Отсутствует
 
Параметры
нет

cloneNode() NN6   IE5+
cloneNode(Булево_значение)  
 

Метод cloneNode() создаёт точную копию объекта узла. Эта копия не имеет родительского узла и не обладает другими типами взаимосвязей с остальными злементами. Копия не становится частью объектной модели документа. Копия включает все атрибуты исходного элемента, включая атрибут ID.

 
Возвращаемое значение
Ссылка на объект узла
 
Параметры
Булево значение Это значение управляет тем, включает ли копия узла все дочерние узлы исходного (true) или нет (false). По умолчанию в IE - false; в NN - true

componentFromPoint() NN6   IE5+
componentFromPoint(x, y)  
 

Метод componentFromPoint помогает решить некоторые задачи по управлению событиями. Его используют для поиска событий (для проверки, произошло ли событие внутри или снаружи определённого элемента). Если элемент имеет полосы прокрутки, метод возвращает дополнительную информацию о событии, например, какую компоненту полосы прокрутки активизировал пользователь.
Метод не поддерживается в IE5/Mac.
Метод componentFromPoint применяют для элемента, используемого в качестве ссылки.

Строка, возвращаемая методом, характеризует точку, в которой произошло событие. Если она находится внутри элемента, метод возвращает пустую строку. Если точка находится за пределами элемента, строка содержит значение "outside". Для полос прокрутки список возвращаемых значений несколько шире. Компания Microsoft определяет дополнительные значения, отвечающие изменению размеров элемента (это происходит в специальном режиме, называемом авторизованным режимом DHTML в Windows). Этот режим требует специального элемента ActiveX. Такие значения перечислены в таблице:

scrolbarDown Кнопка прокрутки вниз
scrolbarHThumb Бегунок на горизонтальной полосе прокрутки
scrolbarPageDown Область постраничной прокрутки вниз
scrolbarPageLeft Область постраничной прокрутки влево
scrolbarPageUp Область постраничной прокрутки вверх
scrolbarRight Кнопка прокрутки вправо
scrolbarUp Кнопка прокрутки вверх
scrolbarVThumb Бегунок на вертикальной полосе прокрутки
handleBottom Нижний элемент изменения размера
handleBottomLeft Нижний левый элемент изменения размера
handleBottomRight Нижний правый элемент изменения размера
handleLeft Левый элемент изменения размера
handleRight Правый элемент изменения размера
handleBottomLeft Нижний левый элемент изменения размера
handleTop Верхний элемент изменения размера
handleTopLeft Верхний левый элемент изменения размера
handleTopRight Верхний правый элемент изменения размера

Пример:

var result = document.all.myTable.componentFromPoint(event.ClientX, event.ClientY)

 
Возвращаемое значение
Строка
 
Параметры
x, y Координаты x и y. Они не поступают от события, но, как правило, привязывают метод к определённому событию. События мыши (кроме click) подходят лучше всего.

contains() NN n/a  IE4+
contains(ссылкаНаОбъект)  
 

Метод contains() сообщает, содержит ли текущий объект другой известный объект в иерархии контейнера HTML. Это не определение физически накладывающихся элементов, а анализ того, вложен ли один элемент в другой.
Элемент всегда содержит самого себя

 
Возвращаемое значение
Булевого типа
 
Параметры
ссылкаНаОбъект ссылка на содержащийся объект

dispatchEvent() NN6
dispatchEvent(ОбъектСобытия)  
 

Метод displatchEvent() позволяет сценарию эмулировать событие для любого объекта, который его поддерживает. Событие, генерируемое таким способом, является экземпляром объекта Event. Для задания параметров экземпляров события следует пользоваться свойствами объекта Event. Затем пропустить событие с помощью метода displatchEvent() и передать в него новосозданный объект Event как единственный параметр.

Интерпретация значения булевого типа, которое возвращает displatchEvent(), не так проста. Броузер следует запущенному событию в зависимости от типа установленной обработки событий (всплывание или захват). Если определённая функция приёмника событий запускает метод preventDefault(), то метод displatchEvent() возвращает false, указыая, что событие не вызывает естественного действия для объекта; иначе метод возвращает true. В NN6 броузер не обеспечивает способ генерирования новых событий

 
Возвращаемое значение
Булевого типа
 
Параметры
ОбъектСобытия Объект События

fireEvent() NN n/a   IE5.5
fireEvent("типСобытия"[, ссылка_на_событие])  
 

IE5.5 обобщает механизм эмуляции физических событий, позволяя сценарию направить любое подходящее событие любому объекту. Его переносчиком является метод fireEvent().

События, генерируемые методом fireEvent(), совпадают с обычными объектами window.event в IE и имеют несколько важных свойств объекта event, рпедварительную установку которых производит броузер. Важно, что свойство cancelBubble имеет значение false, а returnValue - значение true - точно так, как это происходит, когда событие генерируется пользователем или системой.
Метод возвращает значение булевого типа, которое определяет свойство returnValue. По умолчанию - true.

Пример:

var newEvent = document.createEventObject();
newEvent.clientX = 100;
newEvent.clientY = 30;
newEvent.cancelBubble = false;
newEvent.button = 1;
document.all.myElement.fireEvent("onmousedown", newEvent);

 
Возвращаемое значение
Булевого типа
 
Параметры
типСобытия Строка с типом события (с перфиксом on-, в кавычках и в нижнем регистре)
ссылка_на_событие Дополнительный параметр, представляющий собой ссылку на существующий объект event. Этот объект может быть событием, вызываемым пользователем или системой. Оно может быть также объектом, созданным методом document.createEventObject().

getAdjacentText() NN n/a   IE5+
getAdjacentText("позиция")  
 

Позволяет извлечь текстовые компоненты объекта элемента (без HTML-содержания).
Метод не поддерживается в IE5

 
Возвращаемое значение
Строка
 
Параметры
позиция

одна из четырёх констант в виде строки, показывающая, откуда по отношению к текущему объекту следует извлечь текст:

beforeBegin Текст от открывающего дескриптора текущего элемента до дескриптора предыдущего элемента.
afterBegin Текст после открывающего дескриптора элемента до следующего дескриптора.
beforeEnd Текст от закрывающего дескриптора текущего элемента до предыдущего дескриптора
afterEnd Текст от открывающего дескриптора текущего элемента дескриптора следующего элемента

GetAttribute() NN6   IE4+
GetAttribute("имяАтрибута"[, чувствительность_к_регистру])  
 

метод GetAttribute() возвращает значение, присвоенное определённому атрибуту текущего объета. Этим методом можно пользоваться как альтернативой для получения свойств объекта. Например, следующие записи равносильны:

var mult = document.all.mySelect.multiple
var mult = document.all.mySelect.getAttribute("multiple")

 
Возвращаемое значение
значение атрибута (строковое или булево)
 
Параметры
имяАтрибута

Строка с именем атрибута

чувствительность_к_регистру Булево значение, определяющее, стоит ли учитывать регистр. По умолчанию - false.

GetAttributeNode() NN6
GetAttributeNode("имяАтрибута")  
 

В W3C DOM атрибут является объектом, наследующим все свойства объекта Node. Объект атрибута представляет собой пару имя-значение для атрибута, заданного явно в дескрипторе элемента. Узлы атрибутов не рассматриваются как узлы в иерархии документа. Узел атрибута не является дочерним узлом элемента, в котором он определён.
Метод GetAttributeNode() возвращает объект атрибута в W3C DOM

 
Возвращаемое значение
атрибут объекта узла
 
Параметры
имяАтрибута

Строка с именем атрибута без учёта регистра


getBoundingClientRect() NN n/a   IE5+
   
 

В IE каждому элементу, имеющему содержимое, поставлен в соответствие прямоугольник, указывающий, сколько места объект занимает на странице. Этот прямоугольник является ограничивающим и в объектной модели IE называется объектом TextRectangle. Он имеет 4 свойства: left, top, bottom и right - координаты точек, определяющих прямоугольник. Доступ к этим координатам осуществляется следующим образом:

var parTop = document.all.myP.getBoundingClientRect().top

Метод не поддерживается в IE5/Mac

 
Возвращаемое значение
объект TextRectangle
 
Параметры
нет

getClientRects() NN n/a   IE5+
   
 

Метод возвращает массив всех объектов TextRectangle, находящихся внутри текущего объекта в момент вызова метода.
Метод не поддерживается в IE5/Mac

 
Возвращаемое значение
массив объектов TextRectangle
 
Параметры
нет

getElementsByTagName() NN6   IE5+
getElementsByTagName("имяДескриптора")  
 

Метод возвращает массив всех элементов текущего объекта, чьи дескрипторы соответствуют имени, указанному как единственный параметр. Сам текущий элемент в массиве не содержится.
В W3C DOM (но не в IE5.x/Windows) в качестве параметра может быть "*".

 
Возвращаемое значение
массив объектов элементов
 
Параметры
имяДескриптора

Строка без учёта регистра


getExpression() NN n/a   IE5+
getExpression("имяАтрибута")  
 

Метод возвращает текст выражения, присвоенного атрибуту элемента методом setExpression(). Возвращаемое значение является не значением выражения, а самим выражением.
Метод не поддерживается в IE5/Mac

 
Возвращаемое значение
Строка
 
Параметры
имяАтрибута

Строка с именем атрибута


hasChildNodes() NN6   IE5+
getExpression("имяАтрибута")  
 

Метод возвращает true, если текущий объект имеет вложенные узлы. В ином случае он возвращает false

 
Возвращаемое значение
Булево значение
 
Параметры
нет

InsertAdjacentElement() NN n/a   IE5+
InsertAdjacentElement("расположение", объектЭлемента)  
 

Метод вставляет объект элемента в определённом месте по отношению к текущему объекту.
Метод нельза использовать для вставки элементов в таблицу.
Метод не поддерживается в IE5/Mac

 
Возвращаемое значение
Объект
 
Параметры
расположение

Один из возможных параметров:

beforeBegin Текст от открывающего дескриптора текущего элемента до дескриптора предыдущего элемента.
afterBegin Текст после открывающего дескриптора элемента до следующего дескриптора.
beforeEnd Текст от закрывающего дескриптора текущего элемента до предыдущего дескриптора
afterEnd Текст от открывающего дескриптора текущего элемента дескриптора следующего элемента
объектЭлемента Ссылка на вставляемый элемент

InsertAdjacentHTML(), InsertAdjacentText() NN n/a   IE4+
InsertAdjacentHTML("расположение", "текстHTML"),
InsertAdjacentText("расположение", "текст")
 
 

Два этих метода вставляют текст HTML или просто текст в текущий элемент. Они предназначены для использования после, а не во время загрузки страницы. При использовании метода InsertAdjacentHTML() все вставляемые дескрипторы становятся частью объектной модели документа. Метод InsertAdjacentText() следует использовать, если необходимо вставить только текст.

 
Возвращаемое значение
Отсутствует
 
Параметры
расположение

Один из возможных параметров:

beforeBegin Текст от открывающего дескриптора текущего элемента до дескриптора предыдущего элемента.
afterBegin Текст после открывающего дескриптора элемента до следующего дескриптора.
beforeEnd Текст от закрывающего дескриптора текущего элемента до предыдущего дескриптора
afterEnd Текст от открывающего дескриптора текущего элемента дескриптора следующего элемента
текст, текстHTML Вставляемое содержимое

insertBefore() NN6   IE5+
insertBefore(новыйОбъектДочернегоУзла[, ссылкаНаДочернийУзел])  
 

Метод используется для вставки дочернего узла в существующий элемент. Если указать второй параметр, новый дочерний узел будет вставлен перед существующим. Если опустить второй параметр, новый дочерний узел будет вставлен как последний в текущем элементе.

 
Возвращаемое значение
Объект NODE
 
Параметры
новыйОбъектДочернегоУзла Объекты NODE (включая и генерируемые методом document.createElement())

ссылкаНаДочернийУзел

ссылкаНаДочернийУзел Ссылка на существующий дочерний узел текущего элемента

item() NN6   IE4+
insertBefore(новыйОбъектДочернегоУзла[, ссылкаНаДочернийУзел])  
 

Метод item работает с массивами, которые в W3C DOM называются списками именованных узлов (узлы и атрибуты) или HTML-наборами (HTML-массивы).

Пример:

document.gesElementById("MyTable").childNodes.item(2)

Метод неприменим к таким наборам, как attributes и rules.
Метод возвращает ссылку на объект, заданный аргументами метода.

 
Возвращаемое значение
Объект NODE
 
Параметры
index, "индекс" индекс элемента или его строковой идентификатор (только для IE) в массиве
подиндекс если в массиве присутствует несколько элементов с одним идентификатором, индекс элемента в их массиве.

mergeAttributes() NN n/a   IE5+
mergeAttributes("исходныйОбъект")  
 

Этот метод присваивает атрибуты новосозданным объектам, вместо их добавления по одному.
Метод не поддерживается в IE5/Mac

Пример:

function doMerge(form) {
    var newPElem = document.createElement("P")
    var newInputElem = document.createElement("INPUT")
    newInputElem.id = newInputElem.uniqueID
    newInputElem.mergeAttributes(form.field1)
    newPElem.appendChild(newInputElem)
    form.appendChild(newPElem)
    newInputElem.value = newInputElem.outerHTML
}

 
Возвращаемое значение
Отсутствует
 
Параметры
исходныйОбъект Объект, чьи атрибуты передаются новосозданному объекту.

normalize() NN6
   
 

В случае добавления, вставки, удаления или замещения дочернего элемента может оказаться так, что два текстовых узла станут соседними. Некоторые XML-приложения имеют жёсткие ограничения на расположение узлов в документе, согласно которым два текстовых узла соседними быть не могут.
Метод normalize() просматривает дочерние узлы текущего объекта и комбинирует соседние текстовые узлы в один.

 
Возвращаемое значение
Отсутствует
 
Параметры
Нет

releaseCapture(), setCapture() NN n/a   IE5+
setCapture(булев_контейнер)  
 

С помощью метода setCapture() можно указать объект, который будет перехватывать все события мыши.
Захват событий не блокирует события, они лишь перенаправляются к указанному объекту.
Если дизайн страницы требует, чтобы всплывающий на экране элемент скрывался, а обработка событий вновь приобретала привычный характер, необходимо воспользоваться методом releaseCapture(). Этод метод отменяет захват события элементом.

 
Возвращаемое значение
Отсутствует
 
Параметры
булев_контейнер Значение логического типа, управляющее тем, подчиняются ли события дочерних элементов захватывающего объекта описанному механизму захвата. true (по умолчанию) означает, что все события мыши, определённые для дочерних элементов текущего объекта, направляются последнему, а не в исходную точку назначения. false соответствует ситуации, когда дочерние элементы обрабатывают события непосредственно сами.

removeAttribute() NN6   IE4+
removeAttribute("имяАтрибута"[, чувствительностьКРегистру])  
 

Этот метод удаляет атрибут, созданный с помощью метода setAttribute(). В IE метод возвращает true, если операция удаления прошла успешно, false - если нет

 
Возвращаемое значение
Отсутствует (NN); Булева типа (IE)
 
Параметры
имяАтрибута обязательный параметр
чувствительностьКРегистру дополнительный параметр (только для IE), указывающий, стоит ли учитывать регистр при поиске атрибута, который стоит удалить

removeAttributeNode(), setAttributeNode() NN6
removeAttributeNode(узелАтрибута), setAttributeNode(узелАтрибута)  
 

В W3C DOM пара имя-значение является объектом атрибута, который представляет собой отдельный узел в карте именованных узлов - наборе объектов атрибутов, принадлежащих элементу.
Если требуется вставить атрибут согласно формальной спецификации W3C, следует воспользоваться методом document.createAttribute(), генерирующим новый объект атрибута, а затем, пользуясь свойствами nodeName и nodeValue, следует установить атрибуту пару имя-значение.
После этого уже готовый узел атрибута следует вставить в какой-нибудь элемент методом setAttributeNode().
Удалить атрибут из элементаможно с помощью метода removeAttributeNode(). Метод removeAttributeNode() возвращает ссылку на удалённый объект атрибута, который, хоть уже и не является частью иерархической структуры документа, но всё ещё находится в памяти броузера и может быть использован в сценарии.
Ошибка в NN6 не позволяет методу setAttributeNode() возвратить ссылку на объект атрибута, что не даёт впоследствии использовать метод removeAttributeNode().

 
Возвращаемое значение
Объект attribute
 
Параметры
узелАтрибута вставляемый узел атрибута

removeBehavior() NN n/a   IE5+
removeBehavior(идентификатор)  
 

Метод removeBehavior() отсоединяет поведение от объекта. подразумевается, что оно было добавлено методом addBehavior().

 
Возвращаемое значение
Булевого типа (true, если успешно; false, если нет)
 
Параметры
идентификатор уникальный идентификатор поведения, возвращаемый методом addBehavior.

removeChild() NN6   IE5+
removeChild(объект_узла)  
 

Этот метод удаляет дочерний элемент текущего узла. Метод removeChild() возвращает ссылку на удалённый объект Node, который, хоть уже и не является частью иерархической структуры документа, но всё ещё находится в памяти броузера и может быть использован в сценарии.

 
Возвращаемое значение
Ссылка на объект Node
 
Параметры
объект_узла  

removeExpression() NN n/a   IE5+
removeExpression("имяСвойства")  
 

Метод removeExpression() удаляет значение свойства объекта, присвоенного ему методом setExpression.

 
Возвращаемое значение
Ссылка на объект Node
 
Параметры
имяСвойства Строка с учётом регистра.

removeNode() NN n/a   IE5+
removeNode(флаг)  
 

Этот метод удаляет текущий узел из иерархии элементов в IE5+. Метод позволяет удалить объект узла со всеми дочерними узлами или без них (следует использовать с осторожностью).
Метод возвращает ссылку на удаляемый узел, который, хоть уже и не является частью иерархической структуры документа, но всё ещё находится в памяти броузера и может быть использован в сценарии.

 
Возвращаемое значение
Ссылка на объект Node
 
Параметры
флаг Значение булевого типа, определяющее, удалить ли объект со всеми его дочерними узлами (true), или только сам объект (false).

replaceAdjacentText() NN n/a   IE5+
replaceAdjacentText("расположение", "текст")  
 

Метод позволяет заменить один фрагмент текста другим. Он неприменим к дескрипторам HTML и используется только для текста.
Метод не поддерживается в IE5/Mac.

 
Возвращаемое значение
Строка, которая подверглась замене
 
Параметры
расположение

Один из возможных параметров:

beforeBegin Текст от открывающего дескриптора текущего элемента до дескриптора предыдущего элемента.
afterBegin Текст после открывающего дескриптора элемента до следующего дескриптора.
beforeEnd Текст от закрывающего дескриптора текущего элемента до предыдущего дескриптора
afterEnd Текст от открывающего дескриптора текущего элемента дескриптора следующего элемента
текст Вставляемое содержимое

replaceChild() NN6   IE5+
replaceChild(объектНовогоУзла, объектСтарогоУзла)  
 

Метод replaceChild() позволяет заменить существующий объект дочернего узла новым элементом. Метод обязательно вызывается из родительского элемента.
Метод возвращает ссылку на заменённый объект узла.

 
Возвращаемое значение
Ссылка на объект Node
 
Параметры
объектНовогоУзла

Замещающий объект

объектСтарогоУзла Заменяемый объект

replaceNode() NN n/a   IE5+
replaceNode("объект_нового_узла")  
 

Действие метода подобно действию replaceChild() с тем отличием, что он заменяет текущий узел. Дочерние объекты при этом удаляются из элемента.
Метод не поддерживается в IE5/Mac.

 
Возвращаемое значение
Ссылка на объект Node
 
Параметры
объект_нового_узла

Замещающий объект


scrollIntoView() NN n/a   IE4+
scrollIntoView(флаг)  
 

Этот метод прокручивает страницу таким образом, чтобы текущий объект попал в видимую область окна или фрейма

 
Возвращаемое значение
Отсутствует
 
Параметры
флаг

Если true, объект оказывается наверху окна или фрейма. Если false - внизу.


setActive() NN n/a   IE5.5
   
 

Метод делает элемент активным, но приэтом окно не прокручивается. При выполнении метода запускается событие focus()

 
Возвращаемое значение
Отсутствует
 
Параметры
Нет

setAttribute() NN6   IE4+
setAttribute("ИмяАтрибута", значение[, чувствительностьКРегистру])  
 

Метод присваивает новое значение существующему атрибуту текущего объекта или вставляет совершенно новую пару имя-значение в набор атрибутов объекта. Если элемент уже существует, ему просто присваивается значение, а если не существует, то создаётся новый объект. В IE4+ атрибут, добавляемый методом setAttribute(), не становится частью набора attributes

 
Возвращаемое значение
Отсутствует
 
Параметры
ИмяАтрибута Первая часть пары имя-значение
значение Вторая часть пары имя-значение
чувствительностьКРегистру По умолчанию - true

setExpression() NN n/a   IE4+
setExpression("имяСвойства","выражение","язык")  
 

Метод setExpression() для присвоения результата выражения свойству объекта элемента. Метод позволяет присваивать выражения объектам HTML и объектам стилей.
Тип значения всегда должен совпадать с типом свойства, которому оно присваивается.
Метод не поддерживается в IE5/Mac.

Пример:

with (document.all) {
    hoursBlock.style.setExpression("width","now.getHours() * shortWidth * multiple","jscript")
    hoursLabel.setExpression("innerHTML","now.getHours()","jscript")
    minutesBlock.style.setExpression("width","now.getMinutes() * shortWidth","jscript")
    minutesLabel.setExpression("innerHTML","now.getMinutes()","jscript")
    secondsBlock.style.setExpression("width","now.getSeconds() * shortWidth","jscript")
    secondsLabel.setExpression("innerHTML","now.getSeconds()","jscript")
}

 
Возвращаемое значение
Отсутствует
 
Параметры
имяСвойства Строка с именем свойства с учётом регистра, которому присваивается выражение.
выражение Строка с вычисляемым выражением
язык Язык сценариев. Допустимые значения - JScript, VBScript, JavaScript.

swapNode() NN n/a   IE5+
swapNode(объектДругогоУзла)  
 

Метод обменивает местами два узла в иерархии элементов. Содержимое узлов при этом полностью сохраняется.
Метод не поддерживается в IE5/Mac

 
Возвращаемое значение
Ссылка на текущий (до вызова) объект Node
 
Параметры
объектДругогоУзла объект узла

tags() NN n/a   IE4+
tags("имяДескриптора")  
 

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

document.all.tags("P")

Возвращаемое значение - массив ссылок на объекты текущего набора, имена которых совпадают с заданным параметром.

 
Возвращаемое значение
Массив объектов элементов
 
Параметры
имяДескриптора Строка с именем дескриптора, который нужно извлечь

urns() NN n/a   IE5+
urns("имяПоведения")  
 

Данный метод присущ не всем элементам, а только наборам элементов (all, forms,elements и пр.). Если для указанного параметра не находится соответствия, возвращается массив нулевой длины.
Использование URN в сценарии представляет собой дыру в системе безопасности IE.
В IE5/Win32 всегда возвращается массив нулевой длины

 
Возвращаемое значение
Массив объектов элементов
 
Параметры
имяПоведения Строка, содержащая URN (Uniform Resource Identifier) поведения (Как правило, .htc в IE5), присвоенного одному или нескольким элементам набора. параметр не включает в себя расширение в имени файла

Обработчики событий:


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