Window : méthode moveBy()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode moveBy() de l'interface Window déplace la fenêtre actuelle d'une quantité spécifiée.
Note :
Cette fonction déplace la fenêtre par rapport à sa position actuelle. En revanche, window.moveTo() déplace la fenêtre vers une position absolue.
Syntaxe
moveBy(deltaX, deltaY)
Paramètres
deltaX-
La quantité de pixels pour déplacer la fenêtre horizontalement. Les valeurs positives déplacent vers la droite, tandis que les valeurs négatives déplacent vers la gauche.
deltaY-
La quantité de pixels pour déplacer la fenêtre verticalement. Les valeurs positives déplacent vers le bas, tandis que les valeurs négatives déplacent vers le haut.
Valeur de retour
Aucune (undefined).
Exemples
Cet exemple déplace la fenêtre de 10 pixels vers la droite et de 10 pixels vers le haut.
function budge() {
moveBy(10, -10);
}
Spécifications
| Specification |
|---|
| CSSOM View Module> # dom-window-moveby> |
Compatibilité des navigateurs
À partir de Firefox 7, les sites Web ne peuvent plus déplacer une fenêtre de navigateur dans les cas suivants (angl.) :
- Vous ne pouvez pas déplacer une fenêtre ou un onglet qui n'a pas été créé par
Window.open(). - Vous ne pouvez pas déplacer une fenêtre ou un onglet lorsqu'il se trouve dans une fenêtre avec plus d'un onglet.
Note : Cette fonction pourrait ne pas déplacer la fenêtre de manière synchrone. Dans certains environnements (comme Wayland ou les appareils mobiles), il se peut qu'elle ne déplace pas du tout la fenêtre. Actuellement, il n'existe aucun moyen d'écouter un évènement de déplacement, voir Ticket #7693 du Groupe de travail CSS (angl.).
Voir aussi
- La méthode
Window.moveTo()