Оглавление | Назад | Вперёд | Индекс

Layer

Соответствует слою на HTML-странице и предоставляет средства для манипулирования этим слоем.

Клиентский объект
Реализован в	JavaScript 1.2

Создание

HTML-тэг LAYER или ILAYER или использование синтаксиса каскадных таблиц стилей. Машина выполнения JavaScript создаёт объект Layer, соответствующий каждому слою документа. Она размещает эти объекты в массиве свойства document.layers. Вы получаете доступ к объектам Layer по индексу в этом массиве.

Для определения слоя используется стандартный синтаксис HTML. Если Вы специфицируете атрибут ID, Вы можете использовать его значение для индексирования в массиве layers.

Полное описание слоёв см. в Dynamic HTML in Netscape Communicator.

Некоторые свойства layer могут быть непосредственно изменены операцией присвоения; например, "mylayer.visibility = hide". Объект layer имеет также методы для воздействия на эти свойства.

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

Свойства. Резюме.

Свойство	Описание
`above`	Объект `layer`, расположенный выше данного объекта в порядке z-order относительно всех слоёв документа, или содержащего объекта window, если этот слой - самый верхний.
`background`	Изображение, используемое в качестве фона канвы слоя.
`bgColor`	Цвет, используемый в качестве однородного цвета фона канвы слоя.
`below`	Объект `layer`, расположенный ниже данного объекта в порядке z-order относительно всех слоёв документа, или null, если этот слой - самый нижний.
`clip.bottom`	Нижний край отсекающего прямоугольника (видимой части слоя).
`clip.height`	Высота отсекающего прямоугольника (видимой части слоя).
`clip.left`	Левый край отсекающего прямоугольника (видимой части слоя).
`clip.right`	Правый край отсекающего прямоугольника (видимой части слоя).
`clip.top`	Верхний край отсекающего прямоугольника (видимой части слоя).
`clip.width`	Ширина отсекающего прямоугольника (видимой части слоя).
`document`	Ассоциированный документ слоя.
`left`	Позиция по горизонтали левого края слоя в пикселах относительно его родительского слоя.
`name`	Строка, специфицирующая имя, присвоенное слою атрибутом `ID` тэга `LAYER`.
`pageX`	Позиция слоя по горизонтали в пикселах относительно страницы.
`pageY`	Позиция слоя по вертикали в пикселах относительно страницы.
`parentLayer`	Объект `layer`, который содержит данный слой, или содержащий объект `window`, если этот слой не вложен в другой слой.
`siblingAbove`	Объект `layer`, расположенный выше данного в порядке z-order среди всех слоёв, использующих тот же самый родительский слой, или null, если слой не имеет родственников, расположенных выше него.
`siblingBelow`	Объект `layer`, расположенный ниже данного в порядке z-order среди всех слоёв, использующих тот же самый родительский слой, или null, если это самый нижний слой.
`src`	Строка, специфицирующая URL содержимого слоя.
`top`	Позиция по вертикали верхнего края слоя в пикселах относительно его родительского слоя.
`visibility`	Виден слой или нет.
`window`	Объект `window` или `Frame`, содержащий данный слой, вне зависимости от того, вложен ли слой в другой слой.
`x`	Удобный синоним для `Layer.left`.
`y`	Удобный синоним для `Layer.top`.
`zIndex`	Порядок z-order расположения данного слоя относительно других слоёв-родственников.

Методы. Резюме.

Метод	Описание
`captureEvents`	Устанавливает окно или документ для захвата всех событий специфицированного типа.
`handleEvent`	Вызывает обработчик для специфицированного события.
`load`	Заменяет исходное содержимое слоя на содержимое специфицированного файла и одновременно изменяет ширину размещения HTML-содержимого слоя.
`moveAbove`	Помещает данный слой в стэк над слоем, специфицированным как аргумент, без изменения горизонтальной и вертикальной позиции слоя.
`moveBelow`	Помещает данный слой в стэк под специфицированным слоем без изменения горизонтальной и вертикальной позиции слоя.
`moveBy`	Изменяет позицию слоя, применяя специфицированные deltas, измеряемые в пикселах.
`moveTo`	Перемещает верхний левый угол окна на специфицированные координаты экрана.
`moveToAbsolute`	Изменяет позицию слоя на специфицированные пикселные координаты страницы (вместо содержащего слоя).
`releaseEvents`	Даёт слою установку освободить захваченное событие специфицированного типа, отправляя событие объекту, следующему далее по цепи иерархии.
`resizeBy`	Изменяет размеры слоя на специфицированные значения height и width (в пикселах).
`resizeTo`	Изменяет значения размеров слоя на специфицированные height и width (в пикселах).
`routeEvent`	Передаёт захваченное событие по нормальной цепи иерархии.

Кроме того, этот объект наследует методы watch и unwatch из объекта Object.

ПРИМЕЧАНИЕ: Как и на уровне документа, если Вы хотите определить для слоя ответ на щелчок мышью, Вы обязаны захватить события onMouseDown и onMouseUp на уровне слоя и обработать их так, как нужно.

О захвате событий см. книгу Клиентский JavaScript. Руководство.

Если событие возникает в точке, где перекрываются несколько слоёв, самый верхний слой получает это событие, даже если он прозрачен. Однако, если слой является скрытым/hidden, он не получает событий.

above

Объект layer над данным слоем в порядке z-order среди всех слоев документа или содержащего объекта window, если это самый верхний слой.

Свойство из	`Layer`
Только для чтения
Реализовано в	JavaScript 1.2

background

Изображение, используемое в качестве фона для канвы слоя (которая является частью слоя в пределах отсекающего прямоугольника).

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

Описание

Каждый слой имеет свойство background, значением которого является объект image, атрибут src которого это URL, указывающий на изображение, используемое для размножения и заполнения фона. Значение null будет тогда, когда слой не имеет фона. Например:

layer.background.src = "fishbg.gif";

below

Объект layer, расположенный ниже данного объекта в порядке z-order относительно всех слоёв документа, или null, если этот слой - самый нижний.

Свойство из	`Layer`
Только для чтения
Реализовано в	JavaScript 1.2

bgColor

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

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

Описание

Свойство bgColor выражается как 16-ричный RGB-триплет или как строковой литерал (см. книгу Клиентский JavaScript. Руководство). Это свойство является отражением в JavaScript атрибута BGCOLOR тэга BODY.

Вы можете установить свойство bgColor в любой момент.

Если Вы выражаете цвет как 16-ричный RGB-триплет, Вы обязаны использовать формат rrggbb. Например, 16-ричные значения RGB для цвета salmon - red=FA, green=80 и blue=72, и RGB-триплет для salmon будет, соответственно, "FA8072".

Примеры

Здесь устанавливается цвет фона канвы слоя myLayer в aqua с использованием строкового литерала:

myLayer.bgColor="aqua"

Следующий пример устанавливает цвет фона с использованием 16-ричного триплета:

myLayer.bgColor="00FFFF"

См. также

Layer.bgColor

captureEvents

Настраивает окно или документ для захвата всех событий специфицированного типа.

Метод из	`Layer`
Реализован в	JavaScript 1.2

Синтаксис

captureEvents(eventType)

Параметры

eventType

Тип захватываемых событий. Допустимые типы событий перечислены в книге Клиентский JavaScript. Руководство.

Описание

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

captureEvents работает вместе с releaseEvents, routeEvent и handleEvent. Информацию по обработке событий см. в книге Клиентский JavaScript. Руководство.

clip.bottom

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

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

clip.height

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

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

clip.left

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

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

clip.right

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

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

clip.top

Верхний край отсекающего прямоугольника (видимой части слоя). Любая часть слоя, находящаяся за пределами отсекающего прямоугольника, не отображается.

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

clip.width

Ширина отсекающего прямоугольника (видимой части слоя). Любая часть слоя, находящаяся за пределами отсекающего прямоугольника, не отображается.

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

document

Документ, ассоциированный со слоем.

Свойство из	`Layer`
Только для чтения
Реализовано в	JavaScript 1.2

Описание

Каждый объект layer содержит свой собственный объект document. Этот объект может использоваться для доступа к изображениям, аплетам, гиперссылкам, внедрённым объектам, якорям и слоям, которые находятся в слое. Методы объекта document также могут вызываться для изменения содержимого слоя.

handleEvent

Вызывает обработчик специфицированного события.

Метод из	`Layer`
Реализован в	JavaScript 1.2

Синтаксис

handleEvent(event)

Параметр

event

Имя события, для которого специфицированный объект имеет обработчик события.

Описание

handleEvent работает вместе с captureEvents, releaseEvents и routeEvent. Информацию по обработке событий см в книге Клиентский JavaScript. Руководство.

left

Позиция по горизонтали левого края слоя в пикселах относительно его родительского слоя.

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

Свойство Layer.x является синонимом свойства left.

См. также

Layer.top

load

Заменяет исходное содержимое слоя на содержимое специфицированного файла и одновременно изменяет ширину размещения HTML-содержимого слоя.

Метод из	`Layer`
Реализован в	JavaScript 1.2

Синтаксис

load(sourcestring, width)

Параметры

sourcestring	Строка - имя внешнего файла.
width	Ширина слоя в пикселах.

moveAbove

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

Метод из	`Layer`
Реализован в	JavaScript 1.2

Синтаксис

moveAbove(aLayer)

Параметр

aLayer

Слой, поверх которого помещается текущий слой.

moveBelow

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

Метод из	`Layer`
Реализован в	JavaScript 1.2

Синтаксис

moveBelow(aLayer)

Параметр

aLayer

Слой, ниже которого помещается текущий слой.

moveBy

Изменяет позицию слоя, применяя специфицированные deltas, измеряемые в пикселах.

Метод из	`Layer`
Реализован в	JavaScript 1.2

Синтаксис

moveBy(horizontal, vertical)

Параметры

horizontal	Количество пикселов, на которое слой смещается по горизонтали.
vertical	Количество пикселов, на которое слой смещается по вертикали.

moveTo

Перемещает верхний левый угол окна на специфицированные координаты экрана.

Метод из	`Layer`
Реализован в	JavaScript 1.2

Синтаксис

moveTo(x-coordinate, y-coordinate)

Параметры

x-coordinate	Целое число - верхний край окна в координатах экрана.
y-coordinate	Целое число - левый край окна в координатах экрана.

Безопасность

Для перемещения окна вызовите метод moveTo в помеченном скрипте. О безопасности см. книгу Клиентский JavaScript. Руководство.

Описание

Изменяет позицию слоя на специфицированные, в пикселах, координаты в пределах содержащего слоя. Для ILayers перемещает слой относительно естественной inflow-позиции слоя.

См. также

Layer.moveBy

moveToAbsolute

Изменяет позицию слоя на специфицированные пикселные координаты страницы (а не содержащего слоя).

Метод из	`Layer`
Реализован в	JavaScript 1.2

Синтаксис

moveToAbsolute(x, y)

Параметры

x	Целое число - верхний край окна в пикселных координатах.
y	Целое число - левый край окна в пикселных координатах.

Описание

Этот метод эквивалентен установке свойств pageX и pageY объекта layer.

name

Строка, специфицирующая имя, присвоенное слою атрибутом ID тэга LAYER.

Свойство из	`Layer`
Только для чтения
Реализовано в	JavaScript 1.2

pageX

Позиция слоя в пикселах по горизонтали относительно страницы.

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

pageY

Позиция слоя в пикселах по вертикали относительно страницы.

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

parentLayer

Объект layer, который содержит данный слой, или содержащий объект window, если этот слой не вложен в другой слой.

Свойство из	`Layer`
Только для чтения
Реализовано в	JavaScript 1.2

releaseEvents

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

Метод из	`Layer`
Реализован в	JavaScript 1.2

Синтаксис

releaseEvents(eventType)

Параметр

eventType

Тип захватываемого события.

Описание

Если первоначальной целью события является окно, это окно получает событие даже в том случае, если оно (окно) имеет установку - освобождать события данного типа. releaseEvents работает вместе с captureEvents, routeEvent и handleEvent. Дополнительно см. книгу Клиентский JavaScript. Руководство.

resizeBy

Изменяет размеры слоя на специфицированные значения height и width (в пикселах).

Метод из	`Layer`
Реализован в	JavaScript 1.2

Синтаксис

resizeBy(width, height)

Параметры

width	Количество пикселов, на которое размер слоя изменяется по горизонтали.
height	Количество пикселов, на которое размер слоя изменяется по вертикали.

Описание

Он не распределяет HTML, содержащийся в слое. Наоборот, содержимое слоя может быть обрезано по новым границам слоя. Этот метод даёт тот же эффект, что и добавление width и height в clip.width и clip.height.

resizeTo

Изменяет значения размеров слоя на специфицированные height и width (в пикселах).

Метод из	`Layer`
Реализован в	JavaScript 1.2

Описание

Он не распределяет HTML, содержащийся в слое. Наоборот, содержимое слоя может быть обрезано по новым границам слоя.

Синтаксис

resizeTo(width, height)

Параметры

width	Целое число, представляющее ширину слоя в пикселах.
height	Целое число, представляющее высоту слоя в пикселах.

Описание

Этот метод даёт тот же эффект, что и установка clip.width и clip.height.

routeEvent

Передаёт захваченное событие по нормальной цепи иерархии.

Метод из	`Layer`
Реализован в	JavaScript 1.2

Синтаксис

routeEvent(event)

Параметр

event

Передаваемое событие.

Описание

Если субобъект (документ или слой) также захватывает событие, это событие передаётся этому объекту. Иначе оно пересылается цели-оригиналу.

routeEvent работает вместе с captureEvents, releaseEvents и handleEvent. Дополнительно см. книгу Клиентский JavaScript. Руководство.

siblingAbove

Объект layer, расположенный выше данного в порядке z-order среди всех слоёв, использующих тот же самый родительский слой, или null, если слой не имеет родственников, расположенных выше него.

Свойство из	`Layer`
Только для чтения
Реализовано в	JavaScript 1.2

siblingBelow

Объект layer, расположенный ниже данного в порядке z-order среди всех слоёв, использующих тот же самый родительский слой, или null, если это самый нижний слой.

Свойство из	`Layer`
Только для чтения
Реализовано в	JavaScript 1.2

src

Строка, специфицирующая URL содержимого слоя. Соответствует атрибуту SRC.

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

top

Позиция по вертикали верхнего края слоя в пикселах относительно его родительского слоя.

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

Свойство Layer.y является синонимом свойства top.

См. также

Layer.left

visibility

Виден слой или нет.

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

Описание

Значение show - показать слой; hide - скрыть слой; inherit - наследовать видимость от родительского слоя.

window

Объект window или Frame , содержащий этот слой , вне зависимости от того, вложен ли данный слой в другой слой.

Свойство из	`Layer`
Только для чтения
Реализовано в	JavaScript 1.2

x

Позиция по горизонтали левого края слоя в пикселах относительно родительского слоя.

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

Свойство x это синоним свойства Layer.left.

См. также

Layer.y

y

Позиция по вертикали левого края слоя в пикселах относительно родительского слоя.

Свойство из	`Layer`
Реализовано в	JavaScript 1.2

Свойство y это синоним свойства Layer.top.

См. также

Layer.x

zIndex

Порядок z-order расположения данного слоя относительно других слоёв-родственников.

Метод из	`Layer`
Реализован в	JavaScript 1.2

Описание

Слои-родственники с более низкими z-индексами помещаются в стэке под данным слоем. Значение zIndex обязано быть 0 или положительным целым числом.

Оглавление | Назад | Вперёд | Индекс

Дата последнего обновления: 28 мая 1999 года.
Copyright (c) 1999 Netscape Communications Corporation