Script fenetres.js

Le script fenetres.js permet de modifier les propriétés et le contenu des fenêtres du navigateur.

Les fonctions proposées permettent :

• d'ouvrir une page Web dans une nouvelle fenêtre ou en plein écran ;
• de créer une nouvelle page Web dans une nouvelle fenêtre ou en plein écran ;
• de fermer une fenêtre précédemment ouverte ;
• d'activer ou de désactiver une fenêtre en lui donnant ou non le "focus" ;
• de déplacer une fenêtre vers une position précise ou de manière relative ;
• de modifier la largeur et la hauteur d'une fenêtre ;
• de modifier le texte affiché dans la barre d'état d'une fenêtre ;
• de rediriger la page Web affichée dans une fenêtre vers une autre page.

Depuis :

JsLib 1.2

activerFenetre

booléen activerFenetre(chaîne id)

Active la fenêtre spécifiée en lui donnant le "focus". La fenêtre est placée au premier plan et obtient le "focus". A partir de ce moment, tout événement clavier ou souris est capturé par cette fenêtre.

Paramètres :

id - l'identifiant de la fenêtre à activer.

Retourne :

true si la fenêtre existe et a pu être activée, false sinon.

deplacerFenetreDe

booléen deplacerFenetreDe(chaîne id, entier px, entier py)

Déplace la fenêtre spécifiée du nombre de pixels spécifié. Contrairement à la fonction qui suit, la fenêtre est ici déplacée de manière relative à sa position précédente. Les valeurs px et py sont le nombre de pixels à ajouter aux coordonnées du coin supérieur gauche de la fenêtre. S'ils valent tous deux 0, la fenêtre conservera sa position. Ces paramètres peuvent être inférieurs à 0 : dans ce cas, la fenêtre sera déplacée vers le haut et vers la gauche.

Paramètres :

id - l'identifiant de la fenêtre à déplacer.

px - le nombre de pixels à utiliser pour déplacer la fenêtre sur le plan horizontal.

py - le nombre de pixels à utiliser pour déplacer la fenêtre sur le plan vertical.

Retourne :

true si la fenêtre existe et a pu être déplacée, false sinon.

deplacerFenetreVers

booléen deplacerFenetreVers(chaîne id, entier x, entier y)

Déplace la fenêtre spécifiée vers les coordonnées spécifiées. Les coordonnées x et y sont respectivement l'abscisse et l'ordonnée du coin supérieur gauche de la fenêtre sur l'écran. S'ils valent tous deux 0, la fenêtre sera placée dans l'angle supérieur gauche de l'écran.

Paramètres :

id - l'identifiant de la fenêtre à déplacer.

x - l'abscisse du coin supérieur gauche de la fenêtre (distance en pixels entre le côté gauche de l'écran et le côté gauche de la fenêtre).

y - l'ordonnée du coin supérieur gauche de la fenêtre (distance en pixels entre le haut de l'écran et le haut de la fenêtre).

Retourne :

true si la fenêtre existe et a pu être déplacée, false sinon.

desactiverFenetre

booléen desactiverFenetre(chaîne id)

Si nécessaire, désactive la fenêtre spécifiée en lui retirant le "focus". La fenêtre qui avait le focus précédemment est placée au premier plan et obtient de nouveau le "focus". A partir de ce moment, la fenêtre spécifiée ne peut plus capturer les événements clavier et souris.

Paramètres :

id - l'identifiant de la fenêtre à désactiver.

Retourne :

true si la fenêtre existe et a pu être désactivée, false sinon.

dimensionsFenetre

booléen dimensionsFenetre(chaîne id, entier largeur, entier hauteur)

Modifie les dimensions de la fenêtre spécifiée. La largeur et la hauteur spécifiées doivent être des entiers positifs. Si les valeurs spécifiée sont très faibles (inférieures à 50), elles peuvent être corrigées par le navigateur afin que la fenêtre reste exploitable.

Paramètres :

id - l'identifiant de la fenêtre à redimensionner.

largeur - la nouvelle largeur de la fenêtre.

hauteur - la nouvelle hauteur de la fenêtre.

Retourne :

true si la fenêtre existe et a pu être redimensionnée, false sinon.

ecrireFenetre

ecrireFenetre(chaîne id, chaîne texte)

Ouvre une nouvelle fenêtre de type standard (avec barre d'outils, barre d'état, etc.) et y insère le code HTML spécifié. Si la fenêtre existait auparavant, le nouveau code HTML remplace l'ancien, il n'est pas ajouté à la suite. Le texte spécifié peut contenir n'importe quelle balise HTML. Cette fonction permet aussi d'effacer le contenu d'une fenêtre en passant en paramètre une chaîne vide.

Paramètres :

id - l'identifiant de la fenêtre à ouvrir ou à modifier.

texte - le code HTML à écrire dans la fenêtre.

ecrirePleinEcran

ecrirePleinEcran(chaîne id, chaîne texte)

Ouvre une nouvelle fenêtre en mode plein écran et y insère le code HTML spécifié. Si la fenêtre existait auparavant, le nouveau code HTML remplace l'ancien, il n'est pas ajouté à la suite. Le texte spécifié peut contenir n'importe quelle balise HTML. Cette fonction permet aussi d'effacer le contenu d'une fenêtre en passant en paramètre une chaîne vide.

Paramètres :

id - l'identifiant de la fenêtre à ouvrir en plein écran ou à modifier.

texte - le code HTML à écrire dans la fenêtre.

ecrirePopup

ecrirePopup(chaîne id, chaîne texte)

Ouvre une nouvelle fenêtre de type popup (sans barre d'outils, barre d'état, etc.) et y insère le code HTML spécifié. Si la fenêtre existait auparavant, le nouveau code HTML remplace l'ancien, il n'est pas ajouté à la suite. Le texte spécifié peut contenir n'importe quelle balise HTML. Cette fonction permet aussi d'effacer le contenu d'une fenêtre en passant en paramètre une chaîne vide. La nouvelle fenêtre est placée au centre de l'écran.

Paramètres :

id - l'identifiant de la fenêtre de type popup à ouvrir ou à modifier.

texte - le code HTML à écrire dans la fenêtre.

etatFenetre

booléen etatFenetre(chaîne id, chaîne texte)

Modifie le contenu de la barre d'état de la fenêtre spécifiée. Le texte spécifié remplace le texte précédemment affiché dans la barre d'état. Le texte spécifié est affiché par défaut entre chaque événement surgissant dans la fenêtre.

Paramètres :

id - l'identifiant de la fenêtre à mettre à jour.

texte - le texte à afficher dans la barre d'état.

Retourne :

true si la fenêtre existe et a pu être mise à jour, false sinon.

fermerFenetre

booléen fermerFenetre(chaîne id)

Ferme la fenêtre spécifiée. Pour des raisons de sécurité, le navigateur Web peut afficher une boîte de dialogue demandant confirmation pour la fermeture de la fenêtre.

Paramètres :

id - l'identifiant de la fenêtre à fermer.

Retourne :

true si la fenêtre existe et a pu être fermée, false sinon.

ouvrirFenetre

ouvrirFenetre(chaîne id, chaîne url)

Ouvre une nouvelle fenêtre de type standard (avec barre d'outils, barre d'état, etc.) et y charge la page Web d'URL spécifiée. Si la fenêtre existait auparavant, la nouvelle page remplace l'ancienne.

Paramètres :

id - l'identifiant de la fenêtre à ouvrir ou à modifier.

url - l'URL (absolue ou relative) de la page Web à charger dans la fenêtre.

ouvrirPleinEcran

ouvrirPleinEcran(chaîne id, chaîne url)

Ouvre une nouvelle fenêtre en mode plein écran et y charge la page Web d'URL spécifiée. Si la fenêtre existait auparavant, la nouvelle page remplace l'ancienne.

Paramètres :

id - l'identifiant de la fenêtre à ouvrir en plein écran ou à modifier.

url - l'URL (absolue ou relative) de la page Web à charger dans la fenêtre.

ouvrirPopup

ouvrirPopup(chaîne id, chaîne url)

Ouvre une nouvelle fenêtre de type popup (sans barre d'outils, barre d'état, etc.) et y charge la page Web d'URL spécifiée. Si la fenêtre existait auparavant, la nouvelle page remplace l'ancienne. La nouvelle fenêtre est placée au centre de l'écran.

Paramètres :

id - l'identifiant de la fenêtre à ouvrir ou à modifier.

url - l'URL (absolue ou relative) de la page Web à charger dans la fenêtre.

redirigerFenetre

booléen redirigerFenetre(chaîne id, chaîne url)

Redirige la fenêtre spécifiée vers la page Web d'URL spécifiée. Lorsque la version de JavaScript le permet, la nouvelle URL remplace l'ancienne dans l'historique de la fenêtre.

Paramètres :

id - l'identifiant de la fenêtre à rediriger.

url - l'URL (absolue ou relative) de la nouvelle page Web à charger dans la fenêtre.

Retourne :

true si la fenêtre existe et a pu être redirigée, false sinon.