popupNN s.o. IE 5,5 (Win) DOM s.o.

Un objet popup est un espace rectangulaire sans fonctionnalités qui n´a aucun des attributs d´habillage de fenêtres de navigateur typiques (bordures, barres de défilement, barre de titre, etc.) ni aucun chemin de référence permettant de retourner au document principal. Les scripts doivent créer l´objet popup avec une taille et un emplacement spécifiques, ainsi que remplir cette fenêtre de contenu en affectant une chaîne HTML à la propriété document.body.innerHTML de l´élément contextuel. Vos scripts doivent aussi faire que cette zone se détache du document en affectant des bordures et des couleurs d´arrière-plan, soit à la propriété document.body.style de l´élément contextuel, soit aux styles de l´élément à l´intérieur de cette fenêtre.

 

Bien que cet objet popup contienne ce qui est essentiellement un objet document, il n´a aucun rapport avec l´objet window et ne peut donc pas charger de documents externes. Cependant, il est doté de cette caractéristique très utile permettant de transcender les bordures des cadres et mêmes celles des fenêtres de navigateur, ce qui lui donne l´apparence d´un conteneur HTML au niveau du système d´exploitation. Ainsi, vous pouvez l´utiliser pour un menu déroulant ou une annotation devant dépasser les bordures de cadre ou s´étendre au-delà du bord de la fenêtre du navigateur.

 

Un objet popup est un élément visuel transitoire. Si vous cliquez n´importe où à l´extérieur de cet élément contextuel, il disparaît. Mais vous pouvez affecter tous les événements de souris aux éléments dans le document de l´élément contextuel, pour obtenir des effets tels que le survol de la souris ou le clic sur des éléments du menu. Le contenu HTML peut aussi comporter des images.

 

Pour créer un objet popup, utilisez la méthode window.createPopup(). Voici un exemple simple d´une séquence de création, remplissage et affichage typique: 

var popup = window.createPopup( );
var bod = popup.document.body;
bod.style.border = "3px solid #ff8800";
bod.style.padding = "2px";
bod.style.backgroundColor = "lightyellow";
bod.innerHTML = 
  <p style='font-family:Arial, sans-serif; font-size:10px'>Some popup text.</p>";
popup.show(100, 100, 100, 26, document.body);"
 
Référence de modèle d'objet
  
popupObjectRef
 
Propriétés spécifiques à l´objet
 
documentisOpen
 
Méthodes spécifiques à l´objet
 
hide()show()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

documentNN s.o. IE 5,5 (Win) DOM s.o.

Lecture seule

Renvoie une référence à l'objet document à l´intérieur de l´objet popup. La plupart (mais pas toutes) des propriétés de l´objet document s´appliquent à l´objet document de l´élément contextuel. Il s´agit de la passerelle principale pour l´affectation de contenu HTML à l´élément contextuel. Il s´agit d´une propriété en lecture seule, mais les propriétés de l´objet document sont en lecture/écriture pour vous permettre d´affecter des valeurs à son contenu.

 
Exemple
  
popupRef.document.body.innerHTML = "<p>Howdy, pardner!</p>";
 
Valeur

Référence de l'objet document.
 
Par défaut

L'objet document courant.
isOpenNN s.o. IE 5,5 (Win) DOM s.o.

Lecture seule

Renvoie une valeur booléenne indiquant si l´objet popup est visible. Même lorsque l´objet popup est masqué, son contenu reste accessible aux scripts.

 
Exemple
  
if (popupRef.isOpen) {
    popupRef.hide();
}
 
Valeur

Valeur booléenne: true | false.
 
Par défaut

false
hide()NN s.o. IE 5,5 (Win) DOM s.o.

Cache l´objet popup. Généralement invoqué à partir de scripts déclenchés par les actions de l´utilisateur sur l´élément contextuel.

 
Paramètres

Aucune.
 
Valeur renvoyée

Aucune.
show()NN s.o. IE 5,5 (Win) DOM s.o.

show(left, top, width, height[, positioningElemRef])

Affiche l´objet popup, généralement une fois que son contenu a été affecté. Toutes les dimensions et l´emplacement sont définis par le biais de paramètres. L´emplacement peut être défini par rapport à un élément du document principal (facultatif). Les paramètres d´éléments d´emplacement et de positionnement peuvent venir des propriétés de l´objet event (event.clientX, event.clientY et event.srcElement).

 
Paramètres
 
  • Coordonnée horizontale en pixels relative au bord gauche de l´écran ou, si spécifié par un paramètre facultatif, d´un élément HTML.
  • Coordonnée verticale en pixels relative au bord supérieur de l´écran ou, si spécifié par un paramètre facultatif, d´un élément HTML.
  • Largeur extérieure de l´espace de l'élément contextuel en pixels.
  • Hauteur extérieure de l´espace de l'élément contextuel en pixels.
  • Référence facultative à un élément accessible au script invoquant la méthode. Etablit un contexte de coordonnées pour les paramètres left et top.
 
Valeur renvoyée

Aucune.