showPopup

« Accueil de la référence XUL

showPopup( element, x, y, popupType, anchor, align ) Déprécié dans Mozilla 1.9

Type de retour : aucune valeur de retour

Ouvre un élément popup. Deux moyens de spécifier l'emplacement où s'affichera la fenêtre popup existent, soit en spécifiant une position spécifique de l'écran, soit par rapport à un autre élément de la fenêtre. Si <var>x</var> ou <var>y</var> sont définies par une valeur, le popup apparaîtra aux coordonnées (<var>x</var>,<var>y</var>) de l'écran. Si <var>x</var> et <var>y</var> sont définies à -1, le popup sera positionné par rapport à l'<var>element</var> spécifié dans le premier paramètre. C'est cette dernière méthode qu'il faut utiliser, par exemple, pour afficher un popup sous un bouton. Dans ce cas, les paramètres <var>anchor</var> et <var>align</var> peuvent être utilisés pour contrôler plus avant l'endroit où apparaîtra le popup par rapport à l'élément. Le paramètre <var>anchor</var> correspond à l'attribut popupanchor de l'élément et le paramètre <var>align</var> correspond à l'attribut popupalign. Les paramètres <var>anchor</var> et <var>align</var> sont ignorés si ni <var>x</var> ni <var>y</var> ne valent -1.

Pour qu'un popup apparaisse à une position relative à un autre élément tout en étant décalé de quelques pixels, déterminez la position réelle de l'élément à l'aide de ses propriétés boxObject.screenX et boxObject.screenY, et utilisez celles-ci comme paramètres <var>x</var> et <var>y</var> en y ajoutant les décalages souhaités.

Le paramètre <var>popupType</var> doit être une des chaînes popup, context ou tooltip. Chaque type de popup est destiné à être affiché temporairement ; ils ne sont pas censés être affichés de façon permanente. On ne peut afficher qu'un popup à la fois.