layerNN |4| IE s.o. DOM n/a

L'objet layer représente les éléments layer et ilayer. Dans Navigator 4 uniquement. D´autres éléments (tels que div et span) qui ont des attributs position de feuille de style définis sur absolute ou relative sont arbitrairement convertis en objets layer dans Navigator 4.

 
Equivalent HTML
 
<ilayer>
<layer>
 
Référence de modèle d'objet
 
[window.]document.layerName
 
Propriétés spécifiques à l´objet
 
abovebackgroundbelowbgColorclip
hiddenleftnamepageXpageY
parentLayersiblingAbovesiblingBelowsrctop
visibilityzIndex
 
Méthodes spécifiques à l´objet
 
captureEvents()handleEvent()load()moveAbove()
moveBelow()moveBy()moveBy()moveToAbsolute()
releaseEvents()resizeBy()resizeTo()routeEvent()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet
 
GestionnaireNNIEDOM
onblur4s.os.o
onfocus4s.os.o
onload4s.os.o
onmouseout4s.os.o
onmouseover4s.os.o
onmouseup4s.os.o
above, belowNN |4| IE s.o. DOM n/a

Lecture seule

Renvoie une référence à l'élément positionnable dont l'ordre z d'empilage se trouve au-dessus ou au-dessous de l'élément courant. Ces propriétés fonctionnent pour tous les éléments positionnables d'un document. Si l'élément actif est le plus élevé, la propriété above renvoie null. Pour limiter l'examen des éléments de niveau plus ou moins élevé à l'intérieur d'un calque, voir siblingAbove et siblingBelow. Pour ajuster l'ordre d'empilage par rapport à certains objets, voir les sections consacrées aux méthodes moveAbove() et moveBelow().

 
Exemple
 
var nextHigher = document.myILayer.above;
 
Valeur

Référence objet ou null.

 
Par défaut

Aucune.

backgroundNN |4| IE s.o. DOM n/a

Lecture/écriture

Cette propriété reçoit un objet image dont il est possible de définir la propriété src de façon à modifier l'image utilisée pour l'arrière-plan du calque. En d´autres termes, vous devez définir la propriété src de l´objet background du calque pour modifier l´image.

 
Exemple
 
document.myIlayer.background.src = "images/newlogo.gif";
 
Valeur

Une propriété d'objet image, telle que src.

 
Par défaut

Aucune.

bgColorNN |4| IE s.o. DOM n/a

Lecture/écriture

Définit la couleur d'arrière-plan de l'élément. Vous pouvez définir une valeur sous forme de triplet de couleurs en hexadécimal ou de nom de couleur en anglais. Toutefois, les valeurs renvoyées par la propriété représentent l'équivalent décimal de la version RVB hexadécimale. Par défaut, l'arrière-plan est transparent et créé par la valeur null de la propriété bgColor.

 
Exemple
 
document.myIlayer.bgColor = "yellow";
 
Valeur

Triplet de noms de couleurs en hexadécimal, ou nom de couleur en anglais. Reportez-vous à l'annexe A pour connaître les noms de couleurs admises/autorisées en anglais. Les valeurs renvoyées sont les équivalents décimaux des valeurs hexadécimales. Lorsque la valeur est null, l'arrière-plan est transparent.

 
Par défaut

null (transparent).

clipNN |4| IE s.o. DOM n/a

Lecture/écriture

Définit une zone de découpe d'un élément positionnable. Cette propriété fonctionne plus ou moins comme un objet car ses valeurs sont ajustées à l'aide de six propriétés: clip.top, clip.left, clip.bottom, clip.right, clip.width et clip.height. Ajustez le(s) côté(s) ou le(s) dimension(s) de votre choix. Toutes les valeurs sont exprimées en pixels.

 
Exemple
 
document.myIlayer.clip.width = 150;
 
Valeur

Nombre entier.

 
Par défaut

Aucune.

hiddenNN |4| IE s.o. DOM n/a

Lecture/écriture

Détermine si l'objet est visible sur la page. Lorsque l'objet est masqué, le contenu environnant ne comble pas l'espace vide laissé par l'élément.

 
Exemple
 
document.myIlayer.hidden = false;
 
Valeur

Valeur booléenne: true | false.

 
Par défaut

false

leftNN |4| IE s.o. DOM n/a

Lecture/écriture

Pour les éléments positionnables, définit la position (en pixels) du bord gauche du cadre d'un élément (contenu plus remplissage, bordure et/ou marge de gauche) par rapport au bord gauche du conteneur père. Lorsque le calque occupe une position relative, le décalage est défini par rapport au côté gauche de l'emplacement où l'élément apparaîtrait normalement dans le contenu.

 
Exemple
 
document.myIlayer.left = 45;
 
Valeur

Nombre entier.

 
Par défaut

0

nameNN |4| IE s.o. DOM n/a

Lecture seule

Identifiant associé à un cadre, utilisé comme valeur affectée aux attributs target ou comme instructions de script faisant référence au cadre. Lorsqu'aucune valeur n'est explicitement affectée à l'attribut id, Navigator lui affecte automatiquement la valeur name.

 
Exemple
 
if (document.layers[2].name == "main") {
    ...
}
 
Valeur

Identifiant sensible à la casse, conforme aux règles de dénomination des identifiants: il ne peut pas contenir d'espace blanc ni de signe de ponctuation, à l'exception du caractère de soulignement, et ne peut pas commencer par un chiffre.

 
Par défaut

Aucune.

pageX, pageYNN |4| IE s.o. DOM n/a

Lecture/écriture

Fournit la position horizontale (x) et la position verticale (y) de l'objet par rapport aux bords supérieur et gauche du document.

 
Exemple
 
document.myIlayer.pageX = 400;
 
Valeur

Nombre entier.

 
Par défaut

Aucune.

parentLayerNN |4| IE s.o. DOM n/a

Lecture seule

Renvoie une référence au calque père dans la hiérarchie contenant-contenu. Dans le cas d'un calque de document isolé, parentLayer est l'objet window.

 
Exemple
 
if (parentLayer != window) {
    ...
}
 
Valeur

Référence objet (layer ou window).

 
Par défaut

window

siblingAbove, siblingBelowNN |4| IE s.o. DOM n/a

Lecture seule

Renvoie une référence à l'élément positionnable dont l'ordre z d'empilage se trouve au-dessus ou au-dessous de l'élément courant, mais uniquement dans le cadre d'un parentLayer partagé. Si l'élément actif est le plus élevé, la valeur de la propriété siblingAbove est null. Pour étendre l'examen des éléments plus élevés ou moins élevés suivants à l'ensemble du document, voir above et below. Pour ajuster l'ordre d'empilage par rapport à certains objets, voir les sections consacrées aux méthodes moveAbove() et moveBelow().

 
Exemple
 
var nextHigher = document.myILayer.siblingAbove;
 
Valeur

Référence objet ou null.

 
Par défaut

Aucune.

srcNN |4| IE s.o. DOM n/a

Lecture/écriture

Indique l´adresse URL du fichier de contenu externe chargé dans l'élément courant. Pour modifier le contenu, affectez une nouvelle adresse URL à la propriété.

 

L'affectation d'une nouvelle adresse URL à cette propriété ne fonctionne pas pour les cadres incorporés (éléments ilayer) dans Navigator 4; le document source courant est supprimé et d'autres éléments de la page peuvent être masqués. Evitez de définir cette propriété pour les calques incorporés. Il en va de même pour la méthode load().

 
Exemple
 
document.myIlayer.src = "swap2.html";
 
Valeur

Adresse URL complète ou relative, sous forme de chaîne.

 
Par défaut

Aucune.

topNN |4| IE s.o. DOM n/a

Lecture/écriture

Pour les éléments positionnables, définit la position du bord supérieur du cadre d'un élément (contenu plus remplissage, bordure et/ou marge de gauche) par rapport au bord supérieur du conteneur père. Toutes les mesures sont exprimées en pixels. Lorsque l'élément est un calque interne placé de façon relative, le décalage se fait par rapport au côté supérieur de l'emplacement incorporé où l'élément apparaîtrait normalement dans le contenu.

 
Exemple
 
document.myIlayer.top = 50;
 
Valeur

Nombre entier.

 
Par défaut

0

visibilityNN |4| IE s.o. DOM n/a

Lecture/écriture

Indique la visibilité de l'élément positionné. Le contenu environnant ne ferme pas l'espace laissé par un élément dont la propriété visibility est paramétrée sur hide (ou hidden) dans la version CSS). Lorsque les valeurs de cette propriété sont exprimées à l'aide de la syntaxe CSS (hidden | visible), elles sont converties en JavaScript et renvoyées dans ce format.

 
Exemple
 
document.myIlayer.visibility = "hide";
 
Valeur

L'une des constantes suivantes sous forme de chaîne: hide | inherit | show.

 
Par défaut

inherit

zIndexNN |4| IE s.o. DOM n/a

Lecture/écriture

Pour un élément positionné, définit l'ordre d´empilage par rapport à d'autres éléments à l'intérieur du même conteneur père. Reportez-vous au chapitre 4 pour en savoir plus sur les relations de superposition d'éléments à l'intérieur de multiples conteneurs.

 
Exemple
 
document.myIlayer.zIndex = 3;
 
Valeur

Nombre entier.

 
Par défaut

0

captureEvents()NN |4| IE s.o. DOM n/a

captureEvents(eventTypeList)

Indique au navigateur d'intercepter des événements d'un type spécifique avant qu'ils n'atteignent leurs objets cibles. Pour traiter l'événement, l'objet appelant cette méthode doit disposer de gestionnaires d'événements définis pour ce type d'événement.

 
Paramètres
 
  • Types d'événements non sensibles à la casse, séparés par des virgules dans une liste, dérivés des constantes d'objet Event disponibles, telles que Event.CLICK ou Event.MOUSEMOVE.
 
Valeur renvoyée

Aucune.

handleEvent()NN |4| IE s.o. DOM n/a

handleEvent(événement)

Indique à l'objet qu´il doit accepter et traiter l'événement dont les spécifications sont passées à la méthode sous forme de paramètre. Pour pouvoir traiter l'événement, l'objet doit disposer d'un gestionnaire d'événements pour ce type d'événement.

 
Paramètres
 
  • Objet event de Navigator 4.
 
Valeur renvoyée

Aucune.

load()NN |4| IE s.o. DOM n/a

load("adresse_URL", largeur_nouveau_calque)

Cette méthode permet de charger un nouveau document dans un objet layer. Elle ne fonctionne pas correctement dans Navigator 4 pour les éléments ilayer. Le document existant est déchargé du calque, mais le nouveau document n'est pas chargé comme prévu. Il n'y a pas de palliatif satisfaisant autre que la conversion de l'élément en layer.

 
Paramètres
 
  • Valeur, sous forme de chaîne, représentant l'adresse URL complète ou relative du document à charger dans le calque.
  • Nombre entier de pixels représentant la nouvelle largeur attribuée à l'élément pour correspondre au nouveau contenu.
 
Valeur renvoyée

Valeur booléenne: true si le chargement du document a abouti.

moveAbove(), moveBelow()NN |4| IE s.o. DOM n/a

moveAbove(layerObject) moveBelow(layerObject)

Méthodes permettant de modifier la position du calque courant en le déplaçant vers celle d'un autre calque enfant. Ces méthodes sont utiles lorsque le script ne parvient pas à déterminer la valeur zIndex précise d'un calque utilisé comme point de référence pour la position d'empilage du calque courant. Utilisez moveAbove() pour positionner le calque courant juste au-dessus de l'objet layer référencé comme paramètre.

 
Paramètres
 
  • Référence à un autre objet layer dont le parent est identique à celui du calque courant.
 
Valeur renvoyée

Aucune.

moveBy()NN |4| IE s.o. DOM n/a

moveBy(deltaX, deltaY)

Méthode commode permettant de décaler la position de la fenêtre d'un certain nombre de pixels le long des deux axes. Pour décaler la fenêtre sur un seul axe, paramétrez l'autre valeur sur zéro. Une valeur deltaX positive décale l'élément vers la droite, tandis qu'une valeur négative le décale vers la gauche. Une valeur deltaY positive décale l'élément vers le bas, tandis qu'une valeur négative le décale vers le haut. Cette méthode est utile dans le cadre d'une animation suivant un trajet déterminé, contrôlée par une méthode setInterval() ou setTimeout() qui déplace l'élément sur une trajectoire linéaire.

 
Paramètres
 
  • Nombre positif ou négatif de pixels déterminant le déplacement horizontal de l'élément.
  • Nombre positif ou négatif de pixels déterminant le déplacement vertical de l'élément.
 
Valeur renvoyée

Aucune.

moveTo(), moveToAbsolute()NN |4| IE s.o. DOM n/a

moveTo(x, y) moveToAbsolute(x, y)

Méthodes pratiques permettant de décaler la position de l'élément actif en fonction de coordonnées spécifiques. Les différences existant entre ces deux méthodes apparaissent lorsque l'élément à déplacer est imbriqué dans un autre conteneur positionné (par exemple, un calque à l'intérieur d'un calque). La méthode moveTo() utilise le système de coordonnées du conteneur parent, tandis que la méthode moveToAbsolute() utilise celui de la page. Ces deux méthodes produisent le même résultat s'il n'y a qu'un seul calque sur la page.

 
Paramètres
 
  • Nombre positif ou négatif de pixels par rapport à la partie supérieure du conteneur de référence, qu'il s'agisse du calque parent immédiat (moveTo()) ou de la page (moveToAbsolute()).
  • Nombre positif ou négatif de pixels par rapport au côté gauche du conteneur de référence, qu'il s'agisse du calque près (moveTo()) ou de la page (moveToAbsolute()).
 
Valeur renvoyée

Aucune.

releaseEvents()NN |4| IE s.o. DOM n/a

releaseEvents(liste_types_événements)

A l'opposé de objet_calque.captureEvents(), cette méthode désactive la capture d'événement au niveau du calque pour un ou plusieurs événements spécifiques, nommés dans la liste de paramètres. Reportez-vous au chapitre 6.

 
Paramètres
 
  • Types d'événements non sensibles à la casse, séparés par des virgules dans une liste, dérivés des constantes d'objet Event disponibles, telles que Event.CLICK ou Event.MOUSEMOVE.
 
Valeur renvoyée

Aucune.

resizeBy()NN |4| IE s.o. DOM n/a

resizeBy(deltaX, deltaY)

Méthode pratique permettant de décaler la largeur et la hauteur de l'élément courant d'un certain nombre de pixels. Si vous souhaitez ajuster la fenêtre par rapport à un seul un axe, définissez l'autre valeur sur zéro. Une valeur deltaX positive élargit l'élément, tandis qu'une valeur négative le rétrécit. Une valeur deltaY positive agrandit l'élément, tandis qu'une valeur négative le rapetisse. Les bords supérieur et gauche restent fixes; seuls bougent les bords droit et inférieur.

 
Paramètres
 
  • Nombre positif ou négatif de pixels déterminant le changement de la dimension horizontale de l'élément.
  • Nombre positif ou négatif de pixels déterminant le changement de la dimension verticale de l'élément.
 
Valeur renvoyée

Aucune.

resizeTo()NN |4| IE s.o. DOM n/a

resizeTo(x, y)

Méthode commode permettant d'ajuster la hauteur et la largeur de l'élément courant d'un certain nombre de pixels. Les bords supérieur et gauche de l'élément restent fixes; seuls bougent les bords inférieur et droit.

 
Paramètres
 
  • Largeur de l'élément en pixels.
  • Hauteur de l'élément en pixels.
 
Valeur renvoyée

Aucune.

routeEvent()NN |4| IE s.o. DOM n/a

routeEvent(événement)

Utilisée dans une fonction de gestion d'événements, cette méthode indique à Navigator de transmettre l'événement à son objet cible.

 
Paramètres
 
  • Objet event de Navigator 4.
 
Valeur renvoyée

Aucune.