[Содержание] [Предыдущая] [Следующая] [Индекс]

Layer

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

Объект client-side
Реализовано в Navigator 4.0

Создание

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

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

Для полного описания уровней, смотрите Динамический HTML в Netscape Communicator1.

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

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

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

above
Объект layer выше этого объекта в z-порядке, среди всех уровней в документе или включающий объект окна, если этот уровень самый верхний.
background
Изображение,используемое как фон для поверхности уровня.
bgColor
Цвет, используемый как сплошной цвет фона для поверхности уровня.
below
Объект layer ниже этого объекта в z-порядке, среди всех уровней в документе или 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-порядке, среди всех уровней, которые совместно используют тот же самый родительский уровень, или null если уровень не имеет никакого родственного уровня выше его.
siblingBelow
Объект layer ниже этого объекта в z-порядке, среди всех уровней, которые совместно используют тот же самый родительский уровень, или null если уровень внизу.
src
Строка, определяющая URL содержания уровня.
top
Вертикальная позиция верхнего края уровня, в пикселях, относительно начала родительского уровня.
visibility
Видим или нет уровень.
zIndex
Относительный z-порядок этого уровня относительно элементов одного уровня.

Резюме Методов

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

Обратите внимение

Как и в случае с документом, если Вы хотите определить ответ на нажатие кнопки мыши для уровня, Вы должны зафиксировать события onMouseDown и onMouseUp уровня и обрабатывать их, как Вы хотите.

Смотрите "События в Navigator 4.0" для подробностей о фиксации событий.

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

Свойства

above

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

Свойство объекта Layer
Только для чтения
Реализовано в Navigator 4.0

background

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

Свойство объекта Layer
Реализовано в Navigator 4.0

Описание

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

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

bgColor

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

Свойство объекта Layer
Реализовано в Navigator 4.0

Описание

Свойство bgColor выражается, как шестнадцатеричное RGB значение или как один из строковых литералов, перечисленных в Руководстве по JavaScript. Это свойство JavaScript реализация атрибута BGCOLOR тэга BODY.

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

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

Примеры

Следующий пример устанавливает цвет фона поверхности уровня myLayer в aqua, используя строковый литерал:

myLayer.bgColor="aqua"
Следующий пример устанавливает цвет фона поверхности уровня myLayer в aqua, используя шестнадцатеричный триплет:

myLayer.bgColor="00FFFF"

Смотрите также

Layer.bgColor

below

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

Свойство объекта Layer
Только для чтения
Реализовано в Navigator 4.0

clip.bottom

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

Свойство объекта Layer
Реализовано в Navigator 4.0

clip.height

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

Свойство объекта Layer
Реализовано в Navigator 4.0

clip.left

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

Свойство объекта Layer
Реализовано в Navigator 4.0

clip.right

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

Свойство объекта Layer
Реализовано в Navigator 4.0

clip.top

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

Свойство объекта Layer
Реализовано в Navigator 4.0

clip.width

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

Свойство объекта Layer
Реализовано в Navigator 4.0

document

Документ, связанный с уровнем.

Свойство объекта Layer
Только для чтения
Реализовано в Navigator 4.0

Описание

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

left

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

Свойство объекта Layer
Реализовано в Navigator 4.0

name

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

Свойство объекта Layer
Только для чтения
Реализовано в Navigator 4.0

pageX

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

Свойство объекта Layer
Реализовано в Navigator 4.0

pageY

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

Свойство объекта Layer
Реализовано в Navigator 4.0

parentLayer

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

Свойство объекта Layer
Только для чтения
Реализовано в Navigator 4.0

siblingAbove

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

Свойство объекта Layer
Только для чтения
Реализовано в Navigator 4.0

siblingBelow

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

Свойство объекта Layer
Только для чтения
Реализовано в Navigator 4.0

src

Строка URL, определяющая источник содержания уровня. Соответствует атрибуту SRC.

Свойство объекта Layer
Реализовано в Navigator 4.0

top

Свойство top это синоним для самого верхнего окна Navigator, которое является окном web браузера или окном документа.

Свойство объекта Layer
Только для чтения
Реализовано в Navigator 4.0

Описание

Свойство top ссылается к самому верхнему окну, которое содержит кадры или вложенные frameset. Используйте свойство top, чтобы сослаться на окно предка.

Значение свойства top равно

<object objectReference>
где objectReference внутренняя ссылка.

Примеры

Выражение top.close() закрывает самое верхнее окно предка.

Выражение top.length определяет число кадров, содержащихся внутри самого верхнего окна предка. Когда самый верхний предок определен следующим образом, top.length возвращает три:

<FRAMESET COLS="30%,40%,30%">
<FRAME SRC=child1.htm NAME="childFrame1">
<FRAME SRC=child2.htm NAME="childFrame2">
<FRAME SRC=child3.htm NAME="childFrame3">
</FRAMESET>

visibility

Виден или нет уровень.

Свойство объекта Layer
Реализовано в Navigator 4.0

Описание

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

zIndex

Относительный z-порядок этого уровня относительно элементов одного уровня.

Метод объекта Layer
Реализовано в Navigator 4.0

Описание

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

Методы

captureEvents

Устанавливает окно или документ, чтобы фиксировать все события определенного типа.

Метод объекта Layer
Реализовано в Navigator 4.0

Синтаксис

captureEvents(eventType)

Параметры

eventType
Тип события, которое будет зафиксировано. Допустимые типы событий перечислены в описании event.

Описание

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

captureEvents работает в тандеме с releaseEvents, routeEvent и handleEvent. Для подробной информации, смотрите "События в Navigator 4.0".

handleEvent

Вызывает обработчик для указанного события.

Метод объекта Layer
Реализовано в Navigator 4.0

Синтаксис

handleEvent(event)

Параметры

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

Описание

handleEvent работает в тандеме с captureEvents, releaseEvents и routeEvent. Для подробной информации, смотрите "События в Navigator 4.0".

load

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

Метод объекта Layer
Реализовано в Navigator 4.0

Синтаксис

load(sourcestring, width)

Параметры

sourcestring
Строка, указывающая внешнее имя файла.
width
Ширина уровня как значение в пикселях.

moveAbove

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

Метод объекта Layer
Реализовано в Navigator 4.0

Синтаксис

moveAbove(aLayer)

Параметры

aLayer
Уровень, на который переместить текущий уровень.

moveBelow

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

Метод объекта Layer
Реализовано в Navigator 4.0

Синтаксис

moveBelow(aLayer)

Параметры

aLayer
Уровень, под который переместить текущий уровень.

moveBy

Изменяет позицию уровня, применяя определенные смещения, измеряемые в пикселях.

Метод объекта Layer
Реализовано в Navigator 4.0

Синтаксис

moveBy(horizontal, vertical)

Параметры

horizontal
Число пикселей, на которые переместить уровень горизонтально.
vertical
Число пикселей, на которые переместить уровень вертикально.

moveTo

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

Метод объекта Layer
Реализовано в Navigator 4.0

Синтаксис

moveTo(x-coordinate, y-coordinate)

Параметры

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

Защита

Чтобы переместить окно за экран, вызовите метод moveTo в подписанном сценарии. Для информации о защите в Navigator 4.0, смотрите Главу 7, "Защита JavaScript," в Руководстве по JavaScript.

Описание

Изменяет позицию уровня на определенные пиксельные координаты внутри родительского уровня. Для уровней, созданных тэгом ILAYER, перемещает уровень относительно естественной позиции уровня.

Смотрите также

Layer.moveBy

moveToAbsolute

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

Метод объекта Layer
Реализовано в Navigator 4.0

Синтаксис

moveToAbsolute(x, y)

Параметры

x
Целое число, представляющее верхний край окна в пиксельных координатах.
y
Целое число, представляющее левый край окна в пиксельных координатах.

Описание

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

releaseEvents

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

Метод объекта Layer
Реализовано в Navigator 4.0

Синтаксис

releaseEvents(eventType)

Параметры

eventType
Тип события, которое было зафиксировано.

Описание

Если первоначальный адресат события окно, окно получает событие, даже если оно установлено, чтобы освободить этот тип события. releaseEvents работает в тандеме с captureEvents, routeEvent и handleEvent. Для подробной информации, смотрите "События в Navigator 4.0".

resizeBy

Изменяет размеры уровня определенными значениями высоты и ширины (в пикселях).

Метод объекта Layer
Реализовано в Navigator 4.0

Синтаксис

resizeBy(width, height)

Параметры

width
Число пикселей, для изменения размеров уровня по горизонтали.
height
Число пикселей, для изменения размеров уровня по вертикали.

Описание

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

resizeTo

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

Метод объекта Layer
Реализовано в Navigator 4.0

Описание

Он не размещает HTML, содержащийся в уровне, снова. Вместо этого, содержание уровня может быть отсечено новыми границами уровня.

Синтаксис

resizeBy(width, height)

Параметры

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

Описание

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

routeEvent

Передает зафиксированное событие по нормальной иерархии события.

Метод объекта Layer
Реализовано в Navigator 4.0

Синтаксис

routeEvent(event)

Параметры

event
Событие, чтобы передать.

Описание

Если подобъект (документ или уровень) также фиксирует событие, событие посылается этому объекту. Иначе, оно посылается первоначальному адресату.

routeEvent работает в тандеме с captureEvents, releaseEvents и handleEvent. Для подробной информации, смотрите "События в Navigator 4.0".


[Содержание] [Предыдущая] [Следующая] [Индекс]

Последняя Модификация: 10/31/97 12:31:11


Права © 1997 Netscape Communications Corporation



Все мессаги сюда:yanich@inbox.ru
Hosted by uCoz