Соответствует слою на HTML-странице и предоставляет средства для манипулирования этим слоем.
Клиентский объект
Реализован в
JavaScript 1.2
Создание
HTML-тэг LAYER или ILAYER или использование синтаксиса каскадных таблиц стилей.
Машина выполнения JavaScript создаёт объект Layer, соответствующий
каждому слою документа. Она размещает эти объекты в массиве свойства
document.layers. Вы получаете
доступ к объектам Layer по индексу в этом массиве.
Для определения слоя используется стандартный синтаксис HTML.
Если Вы специфицируете атрибут ID, Вы можете использовать его
значение для индексирования в массиве layers.
Некоторые свойства layer могут быть
непосредственно изменены операцией присвоения; например, "mylayer.visibility = hide".
Объект layer имеет также методы для воздействия на эти свойства.
Объект layer, расположенный выше данного объекта в порядке z-order
относительно всех слоёв документа, или содержащего объекта window, если этот слой - самый верхний.
Объект layer, расположенный выше данного в порядке z-order среди
всех слоёв, использующих тот же самый родительский слой, или null, если слой не
имеет родственников, расположенных выше него.
Объект layer, расположенный ниже данного в порядке z-order среди
всех слоёв, использующих тот же самый родительский слой, или null, если это самый нижний слой.
Передаёт захваченное событие по нормальной цепи иерархии.
Кроме того, этот объект наследует методы watch
и unwatch из объекта Object.
ПРИМЕЧАНИЕ:
Как и на уровне документа, если Вы хотите определить для слоя ответ на щелчок
мышью, Вы обязаны захватить события onMouseDown
и onMouseUp на уровне слоя и обработать их так, как нужно.
Если событие возникает в точке, где перекрываются
несколько слоёв, самый верхний слой получает это событие, даже если он прозрачен.
Однако, если слой является скрытым/hidden, он не получает событий.
above
Объект layer над данным слоем в порядке z-order среди всех слоев
документа или содержащего объекта window, если это самый верхний слой.
Каждый слой имеет свойство background, значением которого является объект image,
атрибут src которого это URL, указывающий на изображение,
используемое для размножения и заполнения фона. Значение null будет тогда, когда слой не имеет фона. Например:
Свойство 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-ричного триплета:
Если окно с фрэймами должно захватывать события на страницах, загруженных с
других серверов, Вам нужно будет использовать captureEvents в
помеченном скрипте с предшествующим enableExternalCapture.
Дополнительную информацию и примеры см. в разделе о
enableExternalCapture.
captureEvents работает вместе с releaseEvents, routeEvent
и handleEvent. Информацию по обработке событий см. в книге Клиентский JavaScript. Руководство.
clip.bottom
Нижний край отсекающего прямоугольника (видимой части слоя). Любая часть слоя,
находящаяся за пределами отсекающего прямоугольника, не отображается.
Каждый объект layer содержит свой собственный объект document.
Этот объект может использоваться для доступа к изображениям, аплетам,
гиперссылкам, внедрённым объектам, якорям и слоям, которые находятся в слое.
Методы объекта document также могут вызываться для изменения содержимого слоя.
Имя события, для которого специфицированный объект имеет обработчик события.
Описание
handleEvent работает вместе с captureEvents, releaseEvents
и routeEvent. Информацию по обработке событий см в книге Клиентский JavaScript. Руководство.
left
Позиция по горизонтали левого края слоя в пикселах относительно его родительского слоя.
Помещает данный слой в стэк под специфицированным слоем без изменения
горизонтальной и вертикальной позиции слоя. После рестэкирования оба слоя используют один родительский слой.
Изменяет позицию
слоя на специфицированные, в пикселах, координаты в пределах содержащего слоя.
Для ILayers перемещает слой относительно естественной inflow-позиции слоя.
Если первоначальной целью события является окно, это окно получает событие даже
в том случае, если оно (окно) имеет установку - освобождать события данного типа. releaseEvents
работает вместе с captureEvents, routeEvent и handleEvent.
Дополнительно см. книгу Клиентский JavaScript. Руководство.
resizeBy
Изменяет размеры слоя на специфицированные значения height и width (в пикселах).
Количество пикселов, на которое размер слоя изменяется по горизонтали.
height
Количество пикселов, на которое размер слоя изменяется по вертикали.
Описание
Он не распределяет HTML, содержащийся в слое. Наоборот, содержимое слоя может
быть обрезано по новым границам слоя. Этот метод даёт тот же эффект, что и
добавление width и height в clip.width и clip.height.
resizeTo
Изменяет значения размеров слоя на специфицированные height и width (в пикселах).
Объект layer, расположенный выше данного в порядке z-order среди
всех слоёв, использующих тот же самый родительский слой, или null, если слой не имеет родственников, расположенных выше него.
Объект layer, расположенный ниже данного в порядке z-order среди
всех слоёв, использующих тот же самый родительский слой, или null, если это самый нижний слой.