Все HTML элементы | NN6 IE4+ | ||||
NN6 и IE4+ задают большой набор объектов, применяемых в сценариях, которые представляют собой "основные" элементы языка HTML. Основные элементы можно разделить на две группы. Одна группа, в которую входят, например, такие элементы, как B и STRIKE, определяет стили шрифтов, применяемые к вложенным текстовым последовательностям. Вторая группа элементов контекстно изменяет содержимое, заключённое в открывающий и закрывающий дескрипторы. Примерами контекстных элементов могут служить H1, BLOCKQUOTE и P. Все эти основные элементы имеют большое количество используемых в сценариях элементов интерфейса (методов, свойств и обработчиков событий). Эти элементы присущи не только основным объектам, но и всем элементам, отображение которых возможно. К основным относятся объекты:
Кроме того, нижеописанные элементы интерфейса применимы к:
При описании в справочнике данных элементов по отдельности будут описаны лишь те свойства, методы и обработчики событий, которые для данного элемента являются специфическими, либо специфическим является их поведение. Предполагается, что общие дла них всех свойства и методы описаны в этом разделе. |
|||||
Эквивалент HTML
<Произвольный элемент> |
|||||
Объектно-ориентированная модель
|
Свойства:
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"] Если несколько элементов набора 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 NN: document.getElementsByTagName("Дескриптор_HTML")[0].attributes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Возвращаемое значение: attribute представляет собой объект атрибута, присущего элементу HTML. В NN и IE реализованы различные представления о том, каким должен быть объект атрибута. Синтаксис: IE: document.all.ID_элемента.attributes[i] NN: document.getElementsByTagName("Дескриптор_HTML")[j].attributes[i]
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
behaviorUrns | NN n/a IE5+ | ||
Только чтение | |||
Свойство behaviorUrns предназначено для того, чтобы содержать список адресов в форме URN (Uniform Resourse Locator) всех типов поведения, назначенных текущему объекту. При отсутствии поведений длина массива равна нулю. Однако на практике IE5 возвращает массив пустых строк. |
|||
Пример:
var num = document.all.myP.behaviorUrns.length; |
|||
Возвращаемое значение: массив URN-строк поведения |
|||
|
canHaveChildren | NN n/a IE5+ | ||
Только чтение | |||
Показывает, может ли указанный элемент содержать дочерние элементы (в объектной модели DOM - вложенные элементы). |
|||
Пример:
for (var i = 0; i < document.all.length; i++) { |
|||
Возвращаемое значение: Булево значение |
|||
|
canHaveHTML | NN n/a IE5+ | ||
Только чтение | |||
Показывает, может ли указанный элемент содержать HTML код. (Например, для P это true, а для HR - false) |
|||
Пример:
for (var i = 0; i < document.all.length; i++) { |
|||
Возвращаемое значение: Булево значение |
|||
|
childNodes | NN6 IE4+ | ||
Только чтение | |||
Данное свойство представляет собой объект узлов, содержащихся в текущем объекте. В зависимости от содержимого текущего объекта, количество элементов в childNodes и число наборов дочерних узлов могут отличаться. Если массив childNodes просматривается в цикле for с целью обработки последовательности элементов HTML или XML, помните, что броузер может воспринимать пробелы в исходном коде (пустые строки или простые символы разрыва строки между элементами) как текстовые узлы. Этот баг присутствует в IE5/Mac и NN6. Большая часть циклов, просматривающих объект childNodes, предназначена
для проверки, подсчёта или изменения узлов элементов внутри набора. Если
таковой является задача и вашего сценария, до того как производить обработку,
проверьте каждый узел из массива childNodes и убедитесь, что свойство
nodeType имеет значение 1 (элемент). for (var i=0;i < myElem.childNodes.length;i++) { |
|||
Возвращаемое значение: Массив дочерних узлов |
|||
|
children | NN n/a IE4+ | ||
Только чтение | |||
Свойство children представляет собой массив объектов элементов, содержащихся в текущем объекте. В отличие от свойства childNodes свойство children не учитывает текстовые узлы, а следует иерархии HTML (и XML) с точки зрения текущего объекта. Текущему объекту видны только дочерние элементы на первом уровне вложенности. |
|||
Пример:
group = obj.children |
|||
Возвращаемое значение: Массив объектов элементов |
|||
|
className | NN6 IE4+ | ||
Чтение/запись | |||
Свойство children представляет собой массив объектов элементов, содержащихся в текущем объекте. В отличие от свойства childNodes свойство children не учитывает текстовые узлы, а следует иерархии HTML (и XML) с точки зрения текущего объекта. Текущему объекту видны только дочерние элементы на первом уровне вложенности. |
|||
Пример:
var elem = (document.all) ? document.all(elemID) : document.getElementById(elemID) |
|||
Возвращаемое значение: Строка |
|||
|
clientWidth, clientHeight, clientLeft, clientTop | NN n/a IE4+ | ||
Только чтение | |||
Согласно документации Microsoft, свойства clientWidth, clientHeight отражают высоту и ширину элемента (в пикселах), а clientLeft и clientTop - информацию о ширине границы элемента. В IE4 эти свойства присущи только элементам: |
|||
Пример:
var paragraphW = document.all.myDIV.clientWidth |
|||
Возвращаемое значение: Целочисленное |
|||
|
contentEditable | NN n/a IE5.5 | ||
Чтение/запись | |||
В IE5.5 предствлена концепция редактируемого HTML-содержимого страницы. Дескрипторы элементов могут включать атрибут CONTENTEDITABLE, чьё значение содержится в свойстве contentEditable. По умолчанию значение свойства равно inherit. Это значит, что свойство наследует установки контейнеров иерархической структуры HTML за пределами тела элемента. Если свойство имеет значение true, элемент и все вложенные в него элементы наследуют это значение, делая содержимое редактируемым; и наоборот. |
|||
Пример:
var newState = !editableText.isContentEditable |
|||
Возвращаемое значение: Булево значение |
|||
|
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"> В таблице перечислены параметры объекта TDC:
Значение ID элемента является его идентификатором и должно
быть уникальным. |
|||||||||||||||||||
Пример:
document.all.display.dataSrc = "#rights_raw" |
|||||||||||||||||||
Возвращаемое значение: Строка |
|||||||||||||||||||
|
dir | NN6 IE5+ | ||
Чтение/запись | |||
Свойство dir основано на атрибуте DIR любого текстового элемента HTML. Оно управляет тем, как отображается текст элемента: слева направо или справа налево. |
|||
|
|||
Возвращаемое значение: ltr или rtl |
|||
|
disabled | NN6 IE4+ | ||
Чтение/запись | |||
Является ли элемент активным. В то время как в IE 4 и 5 это свойствоимеют лишь некоторые элементы, в IE5.5 это свойство присуще всем элементам HTML. Следует брать во внимание, что данные неактивного элемента формы не отправляются на сервер. |
|||
|
|||
Возвращаемое значение: Булево значение |
|||
|
document | NN6 IE4+ | ||
Только чтение | |||
Ссылка на документ, содержащий данный объект. Аналогичо свойству ownerDocument в IE5.5 |
|||
|
|||
Возвращаемое значение: объект 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(дочерние). |
|||
Пример: var lastLI = document.getElementById("myList").lastChild |
|||
Возвращаемое значение: Ссылка на объект узла |
|||
|
height, width | NN4+ IE4+ | ||
Только чтение, запись только для некоторых элементов | |||
Указывают на ширину и высоту элемента. Не стоит их путать
с одноимёнными свойствами стиля. Одноимённые свойства стиля могут перекрывать
указанные свойства. |
|||
Возвращаемое значение: целочисленное (когда в пикселах) или строковое (когда в процентах) |
|||
|
hideFocus | NN n/a IE5.5 | ||
Чтение/запись | |||
Свойство позволяет не отображать пунктирную границу при активизации. Но отключение пунктирной линии не отменяет саму активизацию. Соответствующего атрибута HTML не существует. |
|||
Возвращаемое значение: Булево значение |
|||
|
id | NN6 IE4+ | ||
Только чтение | |||
Возвращает идентификатор элемента, присвоенный в атрибуте ID. Свойство позволяет присвоить идентификатор только при создании элемента в сценарии. |
|||
Возвращаемое значение: Строка |
|||
|
innerHTML, innerText | NN6(только innerHTML) IE4+ | ||
Чтение/запись | |||
Данные свойства позволяют получать доступ к содержимому
элемента. Задание этих свойств - распространённый способ динамического
изменения содержания элемента. Свойство innerHTML задаёт не только текстовое
содержание, но и все дескрипторы HTML в нём. При присвоении свойству строки
с HTML-содержимым на страницу автоматически добавляются элементы, динамически
изменяя объектное содержимое. |
|||
Пример: var content = form.HTMLInput.valueif (content) { document.all.label1.innerHTML = content } |
|||
Возвращаемое значение: Строка |
|||
|
isContentEditable | NN n/a IE5.5 | ||
Только чтение | |||
Свойство isContentEditable возвращает значение булевого типа, указывающее, является ли объект элемента редактируемым. |
|||
Пример: var newState = !editableText.isContentEditable |
|||
Возвращаемое значение: Булевого типа |
|||
|
isDisabled | NN n/a IE5.5 | ||
Только чтение | |||
Свойство isDisabled возвращает значение булевого типа, указывающее, является ли определённым объект элемента отключённым. Оно соответствует текущему состоянию элемента. |
|||
|
|||
Возвращаемое значение: Булевого типа |
|||
|
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. |
|||
|
|||
Возвращаемое значение: Строка |
|||
|
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>
задаётся пространство имён URI, определённое дя блока кода, поэтому свойство
namespaceURI элемента возвратит строку http://bigbooks.org/schema.
Имя дескриптора состоит из префикса (до двоеточия) и локального имени
(после двоеточия), которые и являются значениями соответствующих свойств:
у <bk:title> prefix=bk, а localName=title. |
|||
Возвращаемое значение: Строка |
|||
|
nextSibling, previousSibling | NN6 IE5+ | ||
Только чтение | |||
Данные свойства указывают соответственно на следующий и предыдущий родственный элемент (на том же уровне вложенности) в порядке исходного текста. |
|||
|
|||
Возвращаемое значение: Ссылка на объект |
|||
|
nodeName | NN6 IE5+ | ||
Только чтение | |||
Для элементов HTML и XML имя узла совпадает с именем дескриптора. Свойство nodeName включено для совместимости с архитектурой узлов, описанных стандартом W3C DOM. Значение свойства - строка с именем дескриптора в верхнем регистре. |
|||
|
|||
Возвращаемое значение: Строка |
|||
|
nodeType | NN6 IE5+ | ||||||||||||||||||||||||||||||||||||||||||||
Только чтение | |||||||||||||||||||||||||||||||||||||||||||||
Спецификация W3C DOM определяет набор констант, которые указывают тип узла. Не все эти значения реализованы в броузерах, совместимых с W3C DOM, хотя NN6 включает на две константы больше, чем IE.
Значение nodeType автоматически присваивается каждому элементу независимо
от того, как тт был создан.
|
|||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||
Возвращаемое значение: Целочисленное значение |
|||||||||||||||||||||||||||||||||||||||||||||
|
nodeValue | NN6 IE5+ | ||
Чтение/запись | |||
Из всех типов узлов, поддерживаемых стандартом W3C DOM,
только текстовые узлы и узлы атрибутов возвращают отличное от null значение. |
|||
|
|||
Возвращаемое значение: Число, строка или null |
|||
|
offsetHeight, offsetWidth | NN6 IE4+ | ||
Только чтение | |||
Свойства возвращают ширину и высоту элемента в пределах окружающего контейнера по аналогии с clientWidth, clientHeight. Отличие заключается в том, что они имеют значение даже тогда, когда элемент создаётся сценарием. Описание этих свойств в документации Microsoft неоднозначно, и они ведут себя по-разному в разных версиях броузеров. |
|||
|
|||
Возвращаемое значение: Целочисленное значение |
|||
|
offsetLeft, offsetTop | NN6 IE4+ | ||
Только чтение | |||
Свойства отображают координаты элемента, позиционируемого внутри родительского контейнера, даже если эти элементы не позиционируются явно. Аналог - свойства clientLeft, clientTop. Элемент, служащий точкой отсчёта - узел, возвращаемый свойством offsetParent. Разные версии броузеров по-разному трактуют эти свойства |
|||
|
|||
Возвращаемое значение: Целочисленное значение |
|||
|
offsetParent | NN6 IE4+ | ||||||||||
Только чтение | |||||||||||
Свойство возвращает ссылку на объект, действующий как точка
отсчёта позиционирования текущего элемента. Свойства offsetLeft и offsetTop
измеряются относительно левого верхнего угля элемента offsetParent.
Поведение свойства в NN и IE весьма различно. |
|||||||||||
Пример: var useClient = (cElement.offsetTop == 0) ? ((cElement.offsetParent.tagName
== "TR") ? false : true) : false; |
|||||||||||
Возвращаемое значение: Ссылка на объект |
|||||||||||
|
outerText, outerHTML | NN n/a IE4+ | ||
Чтение/запись | |||
Свойство outerText возвращает текст, заключённый в злемент.
В большинстве случаев оно аналогично свойству innerText. |
|||
Пример: function setGroupLabelAsText(form) { function setGroupLabelAsHTML(form) { |
|||
Возвращаемое значение: Строка |
|||
|
ownerDocument | NN6 | ||
Только чтение | |||
Свойство ownerDocument содержит узел document, в котором содержится данный элемент. В NN6 это свойство имеет каждый элемент. Эквивалент IE - свойство document |
|||
Возвращаемое значение: Ссылка на объект document |
|||
|
parentElement | NN n/a IE4+ | ||
Только чтение | |||
Свойство возвращает ссылку на родительский элемент. Такое
взаимоотношение между элементами часто, но не всегда, совпадает со взаимоотношением
между узлами в NN6. Различие заключается в том, что parentElement может
содержать только объекты HTML. |
|||
Возвращаемое значение: Ссылка на объект элемента или null |
|||
|
parentNode | NN6 IE5+ | ||
Только чтение | |||
Свойство содержит ссылку на узел, являющийся родительским по отношению к данному. В большинстве случаев оно эквивалентно свойству parentElement, но может быть использовано и для узлов текстового типа (кроме IE). |
|||
Возвращаемое значение: Ссылка на объект элемента или null |
|||
|
parentTextEdit | NN n/a IE4+ | ||
Только чтение | |||
Свойство используется для нахождения ближайшего к объекту внешнего контейнера, способного генерировать текстовый блок. Немногие элементы в IE способны генерировать блоки текста. Если элемент содержится в иерархии, возвращается ссылка на объект. В противном случае возвращается null. Не работает в IE5/Mac. |
|||
Пример: var x = window.event.clientX |
|||
Возвращаемое значение: Ссылка на объект элемента или null |
|||
|
readyState | NN n/a IE4+ | ||||||||||||||||||
Только чтение | |||||||||||||||||||
Свойство readyState показывает состояние загрузки элемента. Оно может принимать значения:
В 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) { |
|||
Возвращаемое значение: Целочисленное или 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. |
|||
Возвращаемое значение: Строка |
|||
|
scrollHeight, scrollWidth | NN n/a IE4+ | ||
Только чтение | |||
Описание этих двух свойств неоднозначно. Оно основано на документации Microsoft. Неоднозначны и способы реализации в версиях Windows и Macintosh Internet Explorer 4. Мое предположение, что эти свойства предназначены для того, чтобы измерить высоту и ширину элемента "полоса прокрутки" (в пикселах), даже когда часть страницы не видна и может быть не замечена. Версия Macintosh интерпретирует свойство, подразумевая содержание страницы, которое Вы можете видеть в любой момент. Важный пункт - то, что для ключевых элементов, типа BODY, свойства означают различные вещи и могут разрушать межплатформенную совместимость. В IE4 эти свойства присущи лишь элементам BODY, BUTTON, CAPTION, DIV,
FIELDSET, LEGEND, MARQUEE и TEXTAREA. |
|||
Возвращаемое значение: Целое число |
|||
|
scrollLeft, scrollTop | NN n/a IE4+ | ||
Только чтение | |||
Расстояние в пикселах между левым или верхним краем элемента и фактическим содержанем элемента. Установка этих свойств позволяет Вам использовать сценарий, чтобы корректировать прокрутку содержания в пределах прокручиваемого контейнера, типа текста в TEXTAREA элементе или полного документа в окне броузера или фрейме. Когда содержание не пролистано, оба значения нулевые. Установка scrollTop свойства как 15 прокручивает документ вверх в окне на 15 пикселов ; свойство scrollLeft равно 0, если явно не изменено. Изменение значений свойства похоже на прокручивание содержимого пользователем. В IE4 эти свойства присущи лишь элементам BODY, BUTTON, CAPTION, DIV,
FIELDSET, LEGEND, MARQUEE, SPAN и TEXTAREA. |
|||
Возвращаемое значение: Целое число |
|||
|
sourceIndex | NN n/a IE4+ | ||
Только чтение | |||
Возвращает числовой индекс объекта в коллекции document.all |
|||
Возвращаемое значение: Целое число |
|||
|
style | NN6 IE4+ | ||
Чтение/запись | |||
Свойство style представляет собой шлюз к настройкам стилей элемента. Значением свойства является объект style, чьи собственные свойства позволяют получать и изменять установки стилей |
|||
Возвращаемое значение: Ссылка на объект style |
|||
|
tabIndex | NN6 IE4+ | ||
Чтение/запись | |||
Данное свойство управляет тем, в какой момент при нажатии клавиши Tab
элемент активизируется. |
|||
Пример: for (var i = 0; i < forms[0].elements.length; i++) {forms[0].elements[i].tabIndex = 0 } |
|||
Возвращаемое значение: Целое число |
|||
|
tagName | NN6 IE4+ | ||
Только чтение | |||
Свойство возвращает строку с именем дескриптора HTML или (IE5+, NN6)
XML объекта элемента. |
|||
Возвращаемое значение: Строка. |
|||
|
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. |
|||
Возвращаемое значение: Строка. |
|||
|
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") |
|||
Возвращаемое значение Целочисленный идентификатор |
|||
Параметры
|
addEventListener(), removeEventListener() | NN6 | |||||||||
addEventListener("типCобытия",
функцияПолучателяСобытия, захват) removeEventListener("типCобытия", функцияПолучателяСобытия, захват) |
||||||||||
В броузерах, поддерживающих модель событий W3C, происходит внутреннее
преобразование методов привязывания событий - например обработчиков событий
атрибутов - в приёмники событий. Пример: document.getElementById(elemID).addEventListener("click", reportEvent, false) |
||||||||||
Возвращаемое значение Отсутствует |
||||||||||
Параметры
|
appendChild() | NN6 IE5+ | ||
appendChild(объектЭлемента) | |||
Использование понятий родительского и дочернего узлов позволяют создать
код, не зависящий от броузера (IE5+, NN6). var newB = document.createElement("B"); Пример: document.getElementById("myUL").appendChild(newItem) |
|||
Возвращаемое значение ссылка на объект узла |
|||
Параметры
|
applyElement() | NN6 IE5+ (кроме IE5/Mac) | ||||||||
applyElement(объектЭлемента[,тип]) | |||||||||
Метод позволяет вставить новый элемент в качестве родительского или дочернего элемента текущего объекта. Новый объект заключает в себя текущий (если новый элемент является родительским) или наоборот (если новый элемент является дочерним). Когда новый элемент становится дочерним, все предыдущие дочерние объекты становятся вложенными в него (смещаются на один уровень). Пример: var newItem = document.createElement("EM") |
|||||||||
Возвращаемое значение Отсутствует |
|||||||||
Параметры
|
attachEvent(), detachEvent() | NN n/a IE5+ | ||||
attachEvent("имяСобытия",
ссылкаНаФункцию) detachEvent("имяСобытия", ссылкаНаФункцию) |
|||||
Метод attachEvent() применяется, в основном, дляопределения поведения IE, но его можно также использовать для привязки обработчика событий к объекту. Метод detachEvent() выполняет обратное действие. Он не может отключить события, привязка которых была выполнена в атрибутах дескриптора или установкой свойств события. Пример: myObject.onmousedown = setHilite |
|||||
Возвращаемое значение Булевого типа |
|||||
Параметры
|
blur(), focus() | JavaScript1.0 |
blur() удаляет фокус из текущего элемента и обрабатывает событие onBlur
(в IE). Никакой другой элемент в связи с этим не получает фокус . Пример: newWindow = window.open("","","width=250,height=250") |
|
Возвращаемое значение Отсутствует |
|
Параметры нет |
clearAttributes() | NN n/a IE5+ |
Метод удаляет все атрибуты элемента за исключением NAME и ID. Он не удаляет атрибуты физически, а лишь устанавливает их в значения, которые они имели бы по умолчанию |
|
Возвращаемое значение Отсутствует |
|
Параметры нет |
click() | JavaScript1.0 |
Метод click() позволяет сценарию произвести действие, эквивалентное щелчку
на элементе. |
|
Возвращаемое значение Отсутствует |
|
Параметры нет |
cloneNode() | NN6 IE5+ | ||
cloneNode(Булево_значение) | |||
Метод cloneNode() создаёт точную копию объекта узла. Эта копия не имеет родительского узла и не обладает другими типами взаимосвязей с остальными злементами. Копия не становится частью объектной модели документа. Копия включает все атрибуты исходного элемента, включая атрибут ID. |
|||
Возвращаемое значение Ссылка на объект узла |
|||
Параметры
|
componentFromPoint() | NN6 IE5+ | ||||||||||||||||||||||||||||||||||
componentFromPoint(x, y) | |||||||||||||||||||||||||||||||||||
Метод componentFromPoint помогает решить некоторые задачи по управлению
событиями. Его используют для поиска событий (для проверки, произошло
ли событие внутри или снаружи определённого элемента). Если элемент имеет
полосы прокрутки, метод возвращает дополнительную информацию о событии,
например, какую компоненту полосы прокрутки активизировал пользователь. Строка, возвращаемая методом, характеризует точку, в которой произошло событие. Если она находится внутри элемента, метод возвращает пустую строку. Если точка находится за пределами элемента, строка содержит значение "outside". Для полос прокрутки список возвращаемых значений несколько шире. Компания Microsoft определяет дополнительные значения, отвечающие изменению размеров элемента (это происходит в специальном режиме, называемом авторизованным режимом DHTML в Windows). Этот режим требует специального элемента ActiveX. Такие значения перечислены в таблице:
Пример: var result = document.all.myTable.componentFromPoint(event.ClientX, event.ClientY) |
|||||||||||||||||||||||||||||||||||
Возвращаемое значение Строка |
|||||||||||||||||||||||||||||||||||
Параметры
|
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 - точно так, как это
происходит, когда событие генерируется пользователем или системой. Пример: var newEvent = document.createEventObject(); |
|||||
Возвращаемое значение Булевого типа |
|||||
Параметры
|
getAdjacentText() | NN n/a IE5+ | ||||||||||
getAdjacentText("позиция") | |||||||||||
Позволяет извлечь текстовые компоненты объекта элемента (без HTML-содержания).
|
|||||||||||
Возвращаемое значение Строка |
|||||||||||
Параметры
|
GetAttribute() | NN6 IE4+ | ||||
GetAttribute("имяАтрибута"[, чувствительность_к_регистру]) | |||||
метод GetAttribute() возвращает значение, присвоенное определённому атрибуту текущего объета. Этим методом можно пользоваться как альтернативой для получения свойств объекта. Например, следующие записи равносильны: var mult = document.all.mySelect.multiple |
|||||
Возвращаемое значение значение атрибута (строковое или булево) |
|||||
Параметры
|
GetAttributeNode() | NN6 | ||
GetAttributeNode("имяАтрибута") | |||
В W3C DOM атрибут является объектом, наследующим все свойства объекта
Node. Объект атрибута представляет собой пару имя-значение для атрибута,
заданного явно в дескрипторе элемента. Узлы атрибутов не рассматриваются
как узлы в иерархии документа. Узел атрибута не является дочерним узлом
элемента, в котором он определён. |
|||
Возвращаемое значение атрибут объекта узла |
|||
Параметры
|
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, находящихся внутри
текущего объекта в момент вызова метода. |
|
Возвращаемое значение массив объектов TextRectangle |
|
Параметры нет |
getElementsByTagName() | NN6 IE5+ | ||
getElementsByTagName("имяДескриптора") | |||
Метод возвращает массив всех элементов текущего объекта, чьи дескрипторы
соответствуют имени, указанному как единственный параметр. Сам текущий
элемент в массиве не содержится. |
|||
Возвращаемое значение массив объектов элементов |
|||
Параметры
|
getExpression() | NN n/a IE5+ | ||
getExpression("имяАтрибута") | |||
Метод возвращает текст выражения, присвоенного атрибуту элемента методом
setExpression(). Возвращаемое значение является не значением выражения,
а самим выражением. |
|||
Возвращаемое значение Строка |
|||
Параметры
|
hasChildNodes() | NN6 IE5+ |
getExpression("имяАтрибута") | |
Метод возвращает true, если текущий объект имеет вложенные узлы. В ином случае он возвращает false |
|
Возвращаемое значение Булево значение |
|
Параметры нет |
InsertAdjacentElement() | NN n/a IE5+ | ||||||||||||
InsertAdjacentElement("расположение", объектЭлемента) | |||||||||||||
Метод вставляет объект элемента в определённом месте по отношению к текущему
объекту. |
|||||||||||||
Возвращаемое значение Объект |
|||||||||||||
Параметры
|
InsertAdjacentHTML(), InsertAdjacentText() | NN n/a IE4+ | ||||||||||||
InsertAdjacentHTML("расположение",
"текстHTML"), InsertAdjacentText("расположение", "текст") |
|||||||||||||
Два этих метода вставляют текст HTML или просто текст в текущий элемент. Они предназначены для использования после, а не во время загрузки страницы. При использовании метода InsertAdjacentHTML() все вставляемые дескрипторы становятся частью объектной модели документа. Метод InsertAdjacentText() следует использовать, если необходимо вставить только текст. |
|||||||||||||
Возвращаемое значение Отсутствует |
|||||||||||||
Параметры
|
insertBefore() | NN6 IE5+ | |||||
insertBefore(новыйОбъектДочернегоУзла[, ссылкаНаДочернийУзел]) | ||||||
Метод используется для вставки дочернего узла в существующий элемент. Если указать второй параметр, новый дочерний узел будет вставлен перед существующим. Если опустить второй параметр, новый дочерний узел будет вставлен как последний в текущем элементе. |
||||||
Возвращаемое значение Объект NODE |
||||||
Параметры
|
item() | NN6 IE4+ | ||||
insertBefore(новыйОбъектДочернегоУзла[, ссылкаНаДочернийУзел]) | |||||
Метод item работает с массивами, которые в W3C DOM называются списками именованных узлов (узлы и атрибуты) или HTML-наборами (HTML-массивы). Пример: document.gesElementById("MyTable").childNodes.item(2) Метод неприменим к таким наборам, как attributes и rules. |
|||||
Возвращаемое значение Объект NODE |
|||||
Параметры
|
mergeAttributes() | NN n/a IE5+ | ||
mergeAttributes("исходныйОбъект") | |||
Этот метод присваивает атрибуты новосозданным объектам, вместо их добавления
по одному. Пример: function doMerge(form) { |
|||
Возвращаемое значение Отсутствует |
|||
Параметры
|
normalize() | NN6 |
В случае добавления, вставки, удаления или замещения дочернего элемента
может оказаться так, что два текстовых узла станут соседними. Некоторые
XML-приложения имеют жёсткие ограничения на расположение узлов в документе,
согласно которым два текстовых узла соседними быть не могут. |
|
Возвращаемое значение Отсутствует |
|
Параметры Нет |
releaseCapture(), setCapture() | NN n/a IE5+ | ||
setCapture(булев_контейнер) | |||
С помощью метода setCapture() можно указать объект, который будет перехватывать
все события мыши. |
|||
Возвращаемое значение Отсутствует |
|||
Параметры
|
removeAttribute() | NN6 IE4+ | ||||
removeAttribute("имяАтрибута"[, чувствительностьКРегистру]) | |||||
Этот метод удаляет атрибут, созданный с помощью метода setAttribute(). В IE метод возвращает true, если операция удаления прошла успешно, false - если нет |
|||||
Возвращаемое значение Отсутствует (NN); Булева типа (IE) |
|||||
Параметры
|
removeAttributeNode(), setAttributeNode() | NN6 | ||
removeAttributeNode(узелАтрибута), setAttributeNode(узелАтрибута) | |||
В W3C DOM пара имя-значение является объектом атрибута, который представляет
собой отдельный узел в карте именованных узлов - наборе объектов атрибутов,
принадлежащих элементу. |
|||
Возвращаемое значение Объект attribute |
|||
Параметры
|
removeBehavior() | NN n/a IE5+ | ||
removeBehavior(идентификатор) | |||
Метод removeBehavior() отсоединяет поведение от объекта. подразумевается, что оно было добавлено методом addBehavior(). |
|||
Возвращаемое значение Булевого типа (true, если успешно; false, если нет) |
|||
Параметры
|
removeChild() | NN6 IE5+ | ||
removeChild(объект_узла) | |||
Этот метод удаляет дочерний элемент текущего узла. Метод removeChild() возвращает ссылку на удалённый объект Node, который, хоть уже и не является частью иерархической структуры документа, но всё ещё находится в памяти броузера и может быть использован в сценарии. |
|||
Возвращаемое значение Ссылка на объект Node |
|||
Параметры
|
removeExpression() | NN n/a IE5+ | ||
removeExpression("имяСвойства") | |||
Метод removeExpression() удаляет значение свойства объекта, присвоенного ему методом setExpression. |
|||
Возвращаемое значение Ссылка на объект Node |
|||
Параметры
|
removeNode() | NN n/a IE5+ | ||
removeNode(флаг) | |||
Этот метод удаляет текущий узел из иерархии элементов в IE5+. Метод позволяет
удалить объект узла со всеми дочерними узлами или без них (следует использовать
с осторожностью). |
|||
Возвращаемое значение Ссылка на объект Node |
|||
Параметры
|
replaceAdjacentText() | NN n/a IE5+ | ||||||||||||
replaceAdjacentText("расположение", "текст") | |||||||||||||
Метод позволяет заменить один фрагмент текста другим. Он неприменим к
дескрипторам HTML и используется только для текста. |
|||||||||||||
Возвращаемое значение Строка, которая подверглась замене |
|||||||||||||
Параметры
|
replaceChild() | NN6 IE5+ | ||||
replaceChild(объектНовогоУзла, объектСтарогоУзла) | |||||
Метод replaceChild() позволяет заменить существующий объект дочернего
узла новым элементом. Метод обязательно вызывается из родительского элемента. |
|||||
Возвращаемое значение Ссылка на объект Node |
|||||
Параметры
|
replaceNode() | NN n/a IE5+ | ||
replaceNode("объект_нового_узла") | |||
Действие метода подобно действию replaceChild() с тем отличием, что он
заменяет текущий узел. Дочерние объекты при этом удаляются из элемента. |
|||
Возвращаемое значение Ссылка на объект Node |
|||
Параметры
|
scrollIntoView() | NN n/a IE4+ | ||
scrollIntoView(флаг) | |||
Этот метод прокручивает страницу таким образом, чтобы текущий объект попал в видимую область окна или фрейма |
|||
Возвращаемое значение Отсутствует |
|||
Параметры
|
setActive() | NN n/a IE5.5 |
Метод делает элемент активным, но приэтом окно не прокручивается. При выполнении метода запускается событие focus() |
|
Возвращаемое значение Отсутствует |
|
Параметры Нет |
setAttribute() | NN6 IE4+ | ||||||
setAttribute("ИмяАтрибута", значение[, чувствительностьКРегистру]) | |||||||
Метод присваивает новое значение существующему атрибуту текущего объекта или вставляет совершенно новую пару имя-значение в набор атрибутов объекта. Если элемент уже существует, ему просто присваивается значение, а если не существует, то создаётся новый объект. В IE4+ атрибут, добавляемый методом setAttribute(), не становится частью набора attributes |
|||||||
Возвращаемое значение Отсутствует |
|||||||
Параметры
|
setExpression() | NN n/a IE4+ | ||||||
setExpression("имяСвойства","выражение","язык") | |||||||
Метод setExpression() для присвоения результата выражения свойству объекта
элемента. Метод позволяет присваивать выражения объектам HTML и объектам
стилей. Пример: with (document.all) { |
|||||||
Возвращаемое значение Отсутствует |
|||||||
Параметры
|
swapNode() | NN n/a IE5+ | ||
swapNode(объектДругогоУзла) | |||
Метод обменивает местами два узла в иерархии элементов. Содержимое узлов
при этом полностью сохраняется. |
|||
Возвращаемое значение Ссылка на текущий (до вызова) объект Node |
|||
Параметры
|
tags() | NN n/a IE4+ | ||
tags("имяДескриптора") | |||
Данный метод присущ не всем элементам, а только наборам элементов (all, forms,elements и пр.). Его можно представить как фильтр, отбирающий определённые элементы из набора. Например: document.all.tags("P") Возвращаемое значение - массив ссылок на объекты текущего набора, имена которых совпадают с заданным параметром. |
|||
Возвращаемое значение Массив объектов элементов |
|||
Параметры
|
urns() | NN n/a IE5+ | ||
urns("имяПоведения") | |||
Данный метод присущ не всем элементам, а только наборам элементов (all,
forms,elements и пр.). Если для указанного параметра не находится соответствия,
возвращается массив нулевой длины. |
|||
Возвращаемое значение Массив объектов элементов |
|||
Параметры
|
Обработчики событий:
HIVE: All information for read only. Please respect copyright! |