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 | ||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||
Méthodes spécifiques à l´objet | ||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||
Propriétés de gestionnaire d´événements spécifiques à l´objet | ||||||||||||||||||||||||||||
|
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. |
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 | |
|
|
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 | |
|
|
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 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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
Valeur renvoyée | |
Aucune. |