Справочные данные JavaScript
Объект document
Прежде всего надо отметить, что объект document существует в единственном экземпляре для всего HTML-документа. Он присутствует всегда, если существует HTML-документ, поэтому специально создавать его не требуется.
activeElement
Используется в сценарии для получения ссылки на элемент странички, находящийся в данный момент в фокусе
* Возвращает: ссылка на объект
* Совместимость: IE начиная с 4.0
alinkColor
Задает или возвращает цвет активных гиперссылок.
document.alinkColor[ ="{Цвет}"];
* Возвращает: шестнадцатеричное значение или название цвета
* Значение по умолчанию #0000FF.
* Совместимость: IE начиная с 3.02, NN начиная с 2.0
anchors
Объекты анкеров представляют собой выражения в документе HTML, описанные в дескрипторе . Данные объекты обозначаются в URL символом #, расположенным между URL странички и именем анкера.
хъхъПример: Получение количества анкеров в документе
var anchorCount=document.anchors.length
* Возвращает: массив объектов анкеров
* Совместимость: IE начиная с 3.02, NN начиная с 2.0
applets
Благодаря свойству applets можно обращаться к аплетам java, содержащимся в документе.
* Возвращает: массив объектов аплетов
* Совместимость: IE начиная с 4.0, NN начиная с 3.0
bgColor
Задает или возвращает цвет фона страницы. В IE работает правильно, только если цвет страницы установлен атрибутом BGCOLOR.
* Возвращает: шестнадцатеричное значение или название цвета
* Совместимость: IE начиная с 3.02, NN начиная с 2.0
body
Этот объект имеет множество ключевых свойств для управления внешним видом странички. Для доступа к его свойствам лучше использовать выражение document.body.
* Возвращает: ссылку на все содержимое тега <BODY>
* Совместимость: IE начиная с 4.0, NN начиная с 6.0
charset
Это свойство устанавливает кодировку, используемую браузером для отображения текущей странички. Используется только IE.
* Возвращает: строковое представление (описание) кодировки
* Совместимость: IE начиная с 3.02, NN начиная с 2.0
characterSet
Это свойство устанавливает кодировку, используемую браузером для отображения текущей странички.Используется только NN.
* Возвращает: строковое
* Совместимость: NN начиная с 6.0
compatMode
в Internet Explorer 6 появилось новое свойство объекта document, которое обзывается compatMode. Благодаря этому свойству (оно, кстати, только для чтения) мы можем определить, какой режим включён в данный момент — BackCompat (IE 4.x–IE 5.x) или CSS1Compat (IE 6). Исходя из значения этого свойство, мы можем, например, указывать различные значения CSS свойств width, margin или padding:
if (document.getElementById) {
oBlock = document.getElementById("mydiv");
oBlock.style.width =
((document.compatMode) && (document.compatMode == "CSS1Compat")) ? "200px" : "250px";
}
* Возвращает: строковое
* Совместимость: IE начиная с 6.0
defaultCharset
Это свойство устанавливает кодировку, используемую браузером для отображения текущей странички.Различия между charset и defaultCharset не найдено, однако если в сценарии временно изменять свойство charset, для восстановления оригинального набора символов можно воспользоваться defaultCharset.
* Возвращает: строковое
* Совместимость: IE начиная с 4.0
designMode
Это свойство используется, когда браузер IE выступает в качестве компонента другого приложения, данная ситуация описана здесь. Оно разрешает/запрещает изменение HTML кода текущей странички, в обычных условиях это свойство не имеет никакого действия.
* Возвращает: строковое
* Совместимость: IE начиная с 5.0
documentElement
Возвращает ссылку на объект HTML или XML - элемента, который представляет содержимое всего текущего документа.
* Возвращает: ссылка на элемент HTML или XML- объекта
* Совместимость: IE начиная с 5.0, NN начиная с 6.0
embeds
Всякий раз, когда необходимо загрузить данные, требующие надстройки (внедряемого модуля)-приложения для их воспроизведения либо вывода на экран, используют дескриптор Свойство document.embeds - это единственный способ определения таких дескрипторов, добавленных в документ
var сount=document.embeds.length
* Возвращает: массив объектов элемента embed
* Совместимость: IE начиная с 4.0, NN начиная с 3.0
expando
Это свойство установленное в true позволяет использовать новые свойства объекта, добавленные вами при выполнении сценария
* Возвращает: булево
* Совместимость: IE начиная с 3.02, NN начиная с 2.0
fgColor
Задает или возвращает цвет текста. Значение по умолчанию #000000.
* Возвращает: шестнадцатеричное значение или название цвета
* Совместимость: IE начиния с 3.02, NN начиная с 2.0
fileCreatedDate
Возвращает дату создания файла HTML-документа в формате mm/dd/yyyy, только для чтения.
* Возвращает: строка
* Совместимость: IE начиния с 4.0
fileModifiedDate
Возвращает дату последнего изменения файла HTML-документа в формате mm/dd/yyyy, только для чтения.
* Возвращает: строка
* Совместимость: IE начиния с 4.0
fileSize
Возвращает размер файла HTML-документа или графического изображения.
* Возвращает: строка
* Совместимость: IE начиния с 4.0
forms
Возвращает массив объектов form. Первым элементом массива document.forms[0] является ссылка на самую первую форму, определённую в документе.
* Возвращает: массив
* Совместимость: IE начиния с 3.02, NN начиная с 2.0
frames
Возвращает массив объектов frame. Первым элементом массива document.frames[0] является ссылкой на самый первый фрейм, определённый в документе.
* Возвращает: массив
* Совместимость: IE начиния с 4.0
height
Задает или возвращает высоту текущего окна или фрейма в пикселях, соответствует свойству в IE scrollHeight.
* Возвращает: целочисленное
* Совместимость: NN начиная с 4.0
images
Содержит массив дескрипторов всех изображений загруженных на текущей страничке, благодаря этому можно обращаться к изображениям так
edocument.images[0]
* Возвращает: массив
* Совместимость: IE начиния с 4.0, NN начиная с 3.0
lastModified
Возвращает дату последнего изменения документа в виде строки.
* Возвращает: строковая дата
* Совместимость: IE начиная с 3.02, NN начиная с 2.0
layers
Это массив слоёв расположенных в документе
* Возвращает: массив
* Совместимость: NN 4.0
linkColor
Задает или возвращает цвет гиперссылок в документе. В IE работает правильно, только если цвет гипессылок установлен атрибутом LINK.
* Возвращает: шестнадцатеричное значение или название цвета
* Совместимость:IE начиная с 3.02, NN начиная с 2.0
links
Массив содержит в себе ссылки на все объекты ссылок в текущем документе, нумерация начинается с 0.
* Возвращает: массив
* Совместимость:IE начиная с 3.02, NN начиная с 2.0
location
Установка нового URL адреса свойству location приведёт к загрузке странички находящейся по этому адресу
* Возвращает: строковое
* Совместимость:IE начиная с 3.02, NN начиная с 2.0
URL
Свойство только для чтения, возвращает адрес текущей загруженной в браузер странички.
* Возвращает: строковое
* Совместимость:IE начиная с 3.02, NN начиная с 2.0
parentWindow
Свойство document.parentWindow возвращает ссылку на объект window, который содержит текущий документ.
* Возвращает: ссылка на объект window
* Совместимость:IE начиная с 4.0
plugins
Аналог document.embeds
* Возвращает: массив
* Совместимость:IE начиная с 4.0, NN начиная с 4.0
protocol
Возвращает версию протокола, с помощью которой и осуществлялся доступ к текущему документы
* Возвращает: строковое
* Совместимость:c NN начиная с 2.0
readyState
Возвращает текущее состояние документа.
Возвращает одно из четырех значений
complete - означает, что документ полностью загружен
interactive - загружен не полностью но доступен для просмотра и управления
loading - загружается
uninitialized - недоступен, как правило, загружается.
* Доступен только для чтения.
* Возвращает: строковое
* Совместимость:IE начиная с 4.0
referrer
Возвращает Интернет-адрес Web-страницы, с которой пользователь перешел на текущую страницу. Если же пользователь перешел на нее простым набором адреса в строке Web-обозревателя, возвращается пустая строка.
* Возвращает: строковое
* Совместимость:IE начиная с 3.02, NN начиная с 2.0
scripts
Возвращает массив всех элементов SCRIPT содержащихся в документе. Имеется возможность не только просматривать массив, но и добавлять/удалять элементы.
* Возвращает: массив
* Совместимость:IE начиная с 4.0
security
Это свойство предоставляет информацию о типе защиты, если таковая применяется в текущем документе.
* Возвращает: строковое
* Совместимость:IE начиная с 5.5
selection
Свойство document.selection возвращает объект selection, содержимое которого отображается в окне браузера как выделение основного текста. Это выделение может осуществляется пользователем или с помощью сценария в объекте TextRange
* Возвращает: объект
* Совместимость:IE начиная с 4.0
styleSheets
Массив styleSheets содержит ссылки на все элементы STYLE, присутствующие на текущей страничке.
* Возвращает: массив
* Совместимость:IE начиная с 4.0, NN начиная с 6.0
title
Возвращает заголовок Web-страницы, заданный в теге <TITLE>
* Возвращает: массив
* Совместимость:IE начиная с 3.02, NN начиная с 2.0
URL
Задает или возвращает интернет-адрес текущей Web-страницы.
* Возвращает: массив
* В NN доступно только для чтения.
* Совместимость:IE начиная с 4.0, NN начиная с 2.0
URLUnencoded
Свойство возвращает строку URL-адреса в виде кода. Это означает, что все не буквенно-цифровые символы (имеются ввиду только цифры и буквы латинского алфавита) будут перекодированны в их URL-представление. т.е.знак % и шестнадцатеричный код символа ( например пробел будет выглядеть как %20).
* Возвращает: строковое
* Совместимость: IE начиная с 5.5
vlinkColor
Задает или возвращает цвет посещенных гиперссылок в документе. В IE работает правильно, только если цвет посещенных гиперссылок установлени атрибутом VLINK.
* Значение по умолчанию №800080
* Возвращает: строковое
* Совместимость:IE начиная с 3.02, NN начиная с 2.0
width
Ширина документа в пикселях.
* Доступно только для чтения
* Возвращает: строковое
* Совместимость:NN начиная с 4.0
Методы объекта
clear()
Этот метод предназначен для очистки текущего документа из окна браузера.
* Возвращаемое значение: отсутствует
* Совместимость:IE начиная с 3.02, NN начиная с 2.0
close()
Заставляет Web-страницу немедленно обновить свое содержимое после использования методов write. Метод не принимает параметров и не возвращает значения.
* Возвращает: нет
* Совместимость:IE начиная с 4.0, NN начиная с 2.0
createAttribute()
createAttribute( "Имя Атрибута" )
Генерирует объект атрибута и возвращает ссылку на него. При вызове метода указывается только название атрибута, таким образом, в сценарии назначается значение свойству nodeValue, а затем новый атрибур добавляется в существующий элемент с помощью метода *Возвращает: ссылка на объект атрибута
setAttributeNode
var newAttr = document.createAttribute("width");
newAttr.nodeValue = "80%";
document.getElementById("myTable").setAttributeNode(newAttr);
* Совместимость:NN начиная с 6.0
createElement()
createElement( "Имя дескриптора" )
Генерирует объект атрибута для любого дескриптора HTML(или XML), указанного в качастве параметра. Этот объект официально не является частью объектной модели текущего документа, так как он в состав документа пока ещё не входит. Но данный метод используется для вызова объекта элемента, который в конечном счёте будет помещён в документ.
* Возвращает: ссылка на объект атрибута
* Совместимость:IE начиная с 4.0, NN начиная с 6.0
elementFromPoint()
elementFromPoint({X}, {Y})
Возвращает ссылку на элемент, находящийся по координатам X и Y. Метод принимает два параметра, задающие в пикселях горизональную и вертикальную координаты соответственно.
* Поддерживается IE начиная с 4.0
getElementById()
getElementById({Имя элемента})
Возвращает элемент, имя которого передано в качестве параметра. Имя элемента страницы задается атрибутом ID. Метод принимает единственный параметр - имя элемента страницы.
* Поддерживаестя IE начиная с 5.0
getSelection()
Возвращает строку, содержащую текст, выделенный пользователем на странице. Метод не принимает параметров.
* Поддерживается только NN начиная с 4.0
write()
write({Текст})
Записывает текст или HTML-код, переданный как параметр, в текущее место документа.
* Поддерживается IE начиная с 3.02 и NN начиная с 2.0
writeLn()
writeLn({Текст})
То же самое, что write, но в конце добавляет символ возврата каретки и перевода строки.
Коллекция объектов
Коллекция - это своего рода массив объектов, проиндексированный не только по числовым номерам элементов, но и по их именам, и имеющий свойства и методы. Коллекция отличается от ассоциативного массива именно наличием свойств и методов, т.е. коллекция - сама по себе объект.
Рассмотрим, например, коллекцию images, которую включает в себя объект document. Вы можете получить доступ к отдельным ее элементам по порядковому номеру или уникальному имени.
document.images.item(1) document.images("iamge1")
Заметьте, что мы указываем индекс элемента коллекции не в квадратных, а в круглых скобках, потому что он фактически является аргументом функции-метода item, поддерживаемой всеми коллекциями. Имя этого метода можно опускать.
document.images(1) document.images("image1")
Все элементы Web-страницы нумеруются в порядке их появления в HTML-коде. А уникальные имена задаются специальным атрибутом ID, доступным практически во всех тегах.
<IMG src="/img1.gif" id="image1"> <SCRIPT> <!-- var someImage = document.images("image1"); --> </SCRIPT>
Для некоторых тегов (в частности <IMG> и <FRAME>) доступен также атрибут NAME, выполняющий ту же функцию, что и ID.
Коллекция all представляет все элементы Web-страницы без исключений, в том числе и изображения. К элементам этой коллекции можно обращаться по номеру (нумеруются они в порядке появления в HTML-коде) или по имени.
document.all(8) document.all("image1")
Атрибут ID требует уникальности имен всех элементов, но только формально. Реально же на странице могут встретиться два или более элемента с одинаковыми именами. В таком случае нужно будет указать второй индекс
document.all("image1", 2)
или выражение document.all("image1") вернет коллекцию всех изображений с именем image1.
Также все коллекции имеют свойство length, вызывающее количество элементов коллекции. Надо отметить, что элементы коллекции нумеруются с нуля, поэтому последний ее элемент будет иметь номер length-1.
Некоторые коллекции могут иметь методы для добавления и удаления элементов и других целей.
Подчиненные объекты и коллекции объекта
Объект document содержит внутри себя множество подчиненных объектов и коллекций. В следующей таблице перечисленны свойства, возвращающие ссылки на них, и приведены описания соответствующих объектов и коллекций.
* all - Все элементы страницы, включая теги <HTML>, <HEAD>, <TITLE> и <BODY>. Поддерживается только IE начиная с 4.0
* anchors - Все "якоря" страницы
* applets - Все Java-апплеты, изображения и элементы ActiveX
* embeds - Все расширения, внедренные в страницу.
* forms - Все Web-формы.
* frames - Все фреймы набора фреймов. Как свойство объекта document поддерживается только IE.
* images - Все изображения на странице.
* layers - Все слои страницы. Поддерживается только NN начиная с 4.0
* links - Все гиперссылки на странице. В случае NN также все "горячие" области <AREA>.
* location - Объект location для данного документа. Как свойство объекта document поддерживается только IE.
* scripts - Все скрипты, внедренные в страницу. Поддерживается только IE начиная с 4.0
* selection - Объект selection, представляющий выделенный пользователем на странице текст. Поддерживается только IE начиная с 4.0 В NN используется метод getSelection.
* styleSheets - Все таблицы стилей встроенные или привязанные к странице. Поддерживается только IE начиная с 4.0
Коллекция all имеет дополнительный метод tags, позволяющий фильтровать элементы коллекции по их тегу. В качестве параметра этот метод принимает строковое значение нужного тега.
document.all.tags("H1")
Данное выражение вернет ссылку на коллекцию, содержащую только заголовки первого уровня.
Такой же метод поддерживает коллекция links.
Также хочу упомянуть два метода, поддерживаемых Internet Explorer начиная с 5.0. Это методы getElementByName и getElementByTagName. Первый из них возвращает коллекцию элементов со значением атрубута NAME, переданным в качестве параметра. Поскольку атрибут NAME применяется в современном HTML очень редко, польза от этого метода невелика. Второй метод возвращает коллекцию элементов, созданных посредством тега, переданного в качестве параметра.
document.getElementsByName("someimage") document.getElementsByTagName("H1")
Обращение к элементам страницы
Объект document имеет несколько полезных методов, которые можно использовать в скриптах. Но главное его значение - предоставление доступа к отдельным элементам Web-страницы. Как же можно добраться до отдельного элемента страницы? Прежде всего, через коллекции. Например, коллекцию all:
document.all("image1").outerHTML
Или через коллекцию images:
document.images("image1").outerHTML
IE позволяет опускать ссылку на объект document. Так что можно будет написать и так:
all("image1").outerHTML images("image1").outerHTML
NN делать так не позволяет. Он требует обязательной ссылки на document. Вдобавок он не поддерживает коллекцию all.
document.images("image2").src
Имя элемента Web-страницы задается при помощи атрибутов ID и NAME. Если каждый элемент страницы имеет уникальное имя, то можно использовать так называемое прямое обращение к элементам. То есть, обращаться к нему не как к элементу коллекции, а как к отдельному объекту. Это работает и в IE и в NN.
image1.outerHTML layer1.top
Прямое обращение происходит быстрее, чем обращение через коллекцию. Поэтому его рекомендуется использовать во всех случаях, когда не нужно специальное обращение к коллекциям и когда каждый элемент страницы, к которому производится обращение из скриптов, имеет уникальное имя.
По материалам сайта: http://www.spravkaweb.ru/
