-
openPopup( anchor , position , x , y , isContextMenu, attributesOverride )
- Type de retour : pas de valeur de retour
Ouvre le popup relativement à un nœud spécifié à un emplacement spécifique.
Le popup peut soit être ancré à un autre nœud ou ouvert librement. Pour ancrer un popup à un nœud, fournissez un nœud d'accrochage dans le paramètre anchor
et définissez la position
par une chaîne indiquant la manière dont le popup doit être ancré.
Les valeurs possibles pour le paramètre position
sont : before_start, before_end, after_start, after_end, start_before, start_after, end_before, end_after, overlap, after_pointer
Le nœud d'accrochage ne doit pas nécessairement être dans le même document que le popup.
Si le paramètre attributesOverride
vaut true
, l'attribut position
sur le nœud popup a priorité sur la valeur du paramètre position
. Si attributesOverride
vaut false
, l'attribut n'est utilisé que si le paramètre position
est vide.
Pour un popup ancré, les paramètres x
et y
peuvent être utilisés pour décaler le popup de sa position d'ancrage de quelques pixels (mesurés en pixels CSS).
Les popups non ancrés peuvent être créés en fournissant null
comme paramètre anchor
. Un popup non ancré apparait à la position spécifiée par x
et y
relativement à la zone visible (viewport) du document contenant le nœud popup. Dans ce cas, les paramètres position
et attributesOverride
sont ignorés.