body NN 2  IE 3  DOM 1

Объект BODY отражает элемент BODY, который является отличным от объекта document. Объект BODY относится к только соответствующему элементу и его вложенному содержанию. Объекту BODY в IE 4 придано особое значение, в котором он является "дверью" ко многим важным визуальным эффектам на странице, типа фона, краев и прокрутки. Есть shortcut ссылка на объект - document.BODY, так что Вы не должны формировать ссылку через иерархию document.all.elementID.

Внимательно: пока страница не загружена, объект не существует.

Т.к. объект относится к элементам HTML, ему определён весь их интерфейс (см. все элементы HTML)

 
Эквивалент HTML

<BODY>

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

Свойства:


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

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

 
Пример:

document.body.accessKey = "n"

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

aLink NN 6  IE 4   DOM 1
 Чтение/Изменение
 

Цвет нажимаемой гипертекстовой ссылки. Цвет применяется к тексту ссылки, или границе вокруг изображения, или объекта, внедренного в элемент. См. также ссылку и vLink свойства для цветов непосещенных и посещенных ссылок. Соответствующее свойство Navigator 4 - alinkColor объекта document.

 
Пример:

document.body.aLink = "green"

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

background NN 6  IE 4   DOM 1
 Чтение/Изменение
 

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

 
Пример:

document.body.background = "images/watermark.jpg"

 
Возвращаемое значение:
Абсолютный или относительный URL к фоновому изображению.
 
Значение по умолчанию: Ничего.

bgColor NN 6  IE 4   DOM 1
 Чтение/Изменение
 

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

 
Пример:

document.body.bgColor = "yellow"

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

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

Остается ли фоновое изображение в установленной позиции или прокручивается, когда пользователь прокручивает страницу. Когда фоновое изображение установлено в позицию fixed, изображение не прокручивается.

 
Пример:

document.body.bgProperties = "fixed"

 
Возвращаемое значение:
Постоянные (строковые) значения без учета регистра: fixed | scroll.
 
Значение по умолчанию: scroll

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

Размер пустого пространства между краем окна и содержанием. Установка не имеет никакого визуального эффекта, если страница недостаточно длинна, чтобы прокручиваться. Значение по умолчанию 0, но в версии Macintosh Internet Explorer 4 видим край в 10px даже когда свойство установлено на нуль. Большие размеры отражены должным образом. Это свойство предлагает своего рода shortcut к свойству marginBottom CSS для объекта BODY.

 
Пример:

document.body.bottomMargin = 20

 
Возвращаемое значение:
Целочисленное значение (0 или большее) пикселов видимого пространства внизу документа.
 
Значение по умолчанию: 0

clientHeight, clientWidth NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

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

 
Пример:

var midHeight = document.body.clientHeight/2

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

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

Согласно документации Microsoft, эти свойства отражают расстояние между "настоящими" левой и верхней гранями документа. Чтобы получить или установить расстояние в пикселах, используйте pixelLeft и pixelTop свойства.

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

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

Ширина в пикселах левого поля элемента BODY в окне броузера или фрейме. По умолчанию, броузер вставляет маленький край, чтобы препятствовать примыканию содержания страницы к левому краю окна. Установка свойства как "" эквивалентна 0.

 
Пример:

document.body.leftMargin = 16

 
Возвращаемое значение:
Целое число в пикселах.
 
Значение по умолчанию: 10 (Windows); 8 (Macintosh).

link NN 6  IE 4   DOM 1
 Чтение/Изменение
 

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

 
Пример:

document.body.link = "#00FF00"

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

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

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

 
Пример:

document.body.noWrap = "true"

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

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

Используется для связи с источником данных, возвращает целое число, представляющее запись в пределах набора данных, который сгенерировал элемент (то есть, элемент, чьё содержание заполнено через связь с источником данных). Значения этого свойства могут использоваться, чтобы извлечь определенную запись из набора записей Active Data Objects (ADO) (см. свойство recordset ).

 
Пример:

<SCRIPT FOR="tableTemplate" EVENT="onclick"> myDataCollection.recordset.absoluteposition = this.recordNumber... </SCRIPT>

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

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

Ширина в пикселах правого поля элемента BODY в окне броузера или фрейме. По умолчанию, броузер вставляет маленький край, чтобы препятствовать примыканию содержания страницы к правому краю окна (кроме Macintosh). Установка свойства как "" эквивалентна 0.

 
Пример:

document.body.leftMargin = 16

 
Возвращаемое значение:
Целое число в пикселах.
 
Значение по умолчанию: 10 (Windows); 0 (Macintosh).

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

Отображает ли окно (или фрейм) полосы прокрутки, когда содержание превышает размер окна.

 
Пример:

document.body.scroll = "no"

 
Возвращаемое значение:
Неточное Булево значение. Требует одного из следующих строковых значений: yes | no.
 
Значение по умолчанию: yes

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

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

 
Пример:

var midPoint = document.body.scrollHeight/2

 
Возвращаемое значение:
Целое положительное число или 0.
 
Значение по умолчанию: Ничего.

scrollLeft, scrollTop NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

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

 
Пример:

document.body.scrollTop = 40

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

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

Номер, который указывает последовательность этого элемента в пределах порядка размещения всех форматируемых элементов в документе. Порядок форматирования строго подчиняется набору правил. Элементы, которые имеют отличные от нуля значения свойства tabIndex, находятся первые в строке, когда пользователь начинает форматирование страницы. Отсчёт начинается с элемента с самым низким значением tabIndex и заканчивается самым высоким значением, независимо от физического местоположения объекта на странице или в документе. Если два элемента имеют одни и те же значения tabIndex, элемент, который загружается в документ раньше , получает фокус первым. Затем идут все элементы что, или не поддерживающие свойство tabIndex , или имеющие нулевое значение. Эти элементы получают фокус в том порядке, в котором они загружаются в документ. Значение -1 ,в целом, удаляет элемент из порядка форматирования.

Обратите внимание, что интерфейс Macintosh не обеспечивает предоставление фокуса элементам, отличным от text и password поля INPUT.

 
Пример:

document.body.tabIndex = 0

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

text NN 6  IE 4   DOM 1
 Чтение/Изменение
 

Цвет текста для всего документа. Эквивалент цвета символа.

 
Пример:

document.body.text = "darkred"

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

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

Ширина в пикселах верхнего поля элемента BODY в окне броузера или фрейме. По умолчанию, броузер вставляет маленький край, чтобы препятствовать примыканию содержания страницы к верхнему краю окна. Установка свойства как "" эквивалентна 0.

 
Пример:

document.body.topMargin = 16

 
Возвращаемое значение:
Целое число в пикселах.
 
Значение по умолчанию: 15 (Windows); 8 (Macintosh).

vLink NN 6  IE 4   DOM 1
 Чтение/Изменение
 

Цвет гипертекстовой ссылки, которая была недавно посещена . Цвет применяется к тексту ссылки, или границе вокруг изображения, или другого подобного объекта. См. также свойства link и aLink для непосещенных и активных ссылок. Соответствующее свойство Navigator - vlinkColor объекта document.

 
Пример:

document.body.vLink = "gold"

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

Методы:


createControlRange( ) NN n/a  IE 5  (кроме IE 5/Mac)

Этот метод описывается здесь исключительно потому, что он вообще существует. Пока разработчики Microsoft не ответили на вопрос, как использовать объект controlRange, известно только одно: этот объеккт имеет некоторое отношение к документу в режиме редактирования.

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

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

Создает объект TextRange из исходного текста документа. Для подробностей см. объект TextRange.

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

doScroll( ) NN n/a  IE 5  (кроме IE 5/Mac)

doScroll(["действие"])

Рекомендуется использовать данный метод для обеспечения ответной реакции на действия пользователя, проведённые на полосах прокрутки. Он позволяет выполнить одно из действий прокрутки на странице. Этот метод удобен при создании собственных полос прокрутки вместо стандартных. Метод полностью зависит от пространственного соотношения между содержимым BODY и размером окна или фрейма. Метод при выполнении вызывает событие onScroll() для объекта BODY.

В IE любые внутренние размеры неадекватно обновляются после изменения содержимого. Поэтому в таких случаях рекомендуется совмещать метод с методом setTimeout().

 
Возвращаемое значение
Объект TextRange.
 
Параметры
действие

Одно из значений строковых констант:

Полное название параметра Сокращённое название параметра Имитируемое действие прокрутки
scrollbarDown down Щелчок на стрелке "вниз"
scrollbarLeft left Щелчок на стрелке "влево"
scrollbarHThumb нет Щелчок на горизонтальном бегунке полосы прокрутки (прокрутка не осуществляется)
scrollbarVThumb нет Щелчок на вертикальном бегунке полосы прокрутки (прокрутка не осуществляется)
scrollbarPageDown pageDown Щелчок на нижней области страницы (или нажатие <PageDown>)
scrollbarPageLeft pageLeft Щелчок на левой области страницы
scrollbarPageRight pageRight Щелчок на правой области страницы
scrollbarPageUp pageUp Щелчок на верхней области страницы (или нажатие <PageUp>)

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

 


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