layer | NN |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
above | background | below | bgColor | clip
hidden | left | name | pageX | pageY
parentLayer | siblingAbove | siblingBelow | src | top
visibility | zIndex |  |  |
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
Gestionnaire | NN | IE | DOM
onblur | 4 | s.o | s.o
onfocus | 4 | s.o | s.o
onload | 4 | s.o | s.o
onmouseout | 4 | s.o | s.o
onmouseover | 4 | s.o | s.o
onmouseup | 4 | s.o | s.o

above, below | NN |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.

background | NN |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.

bgColor | NN |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).

clip | NN |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.

hidden | NN |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

left | NN |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

name | NN |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, pageY | NN |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.

parentLayer | NN |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, siblingBelow | NN |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.

src | NN |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.

top | NN |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

visibility | NN |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

zIndex | NN |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.