Книги-online

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

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