L'Altruiste : Le Javascript

Frame représente un cadre dans une fenêtre du navigateur.

Compatibilité

Disponibilité

Javascript 1.0 côté client

Correspondance HTML

<frame...>...</frame>

Synopsis

window.frames[i]
window.frames.length

On fournit une convenance à l'objet d'Encadrement (frame) pour la référence aux objets qui constituent des cadres. Cependant, JavaScript représente en réalité un cadre employant un objet de fenêtre. Chaque objet Frame est un objet de fenêtre et a toutes les méthodes et les propriétés d'un objet Window. Cependant, une fenêtre qui est un cadre diffère légèrement d'une fenêtre au plus haut niveau.

Propriétés

Propriété	Description
closed	spécifie si une fenêtre a été fermée.
crypto	un objet qui permet les particularités de chiffrage du Navigateur d'accès.
defaultStatus	représente l'affichage par défaut d'un message dans la barre de statut du navigateur.
document	contient l'information sur le document actuel et fournit des méthodes pour l'affichage de la production de HTML à l'utilisateur.
frames[]	représente un tableau de toutes les cadres d'une fenêtre.
history	contient l'information sur les adresses URL que les clients ont visité à l'intérieur d'une fenêtre.
innerHeight	spécifie la dimension verticale de la zone de contenu d'une fenêtre en pixels.
innerWidth	spécifie la dimension horizontale de la zone de contenu d'une fenêtre en pixels.
length	indique le nombre de cadres dans une fenêtre.
location	contient l'information sur l'adresse URL courante.
locationbar	représente la barre d'affichage d'adresse sur le navigateur.
menubar	représente la barre de menu du navigateur.
name	spécifie un nom unique pour la fenêtre.
offscreenBuffering	spécifie si les mises à jour de la fenêtre sont placées en mémoire tampon.
opener	spécifie le nom de fenêtre du document appelant quand une fenêtre est ouverte en employant la méthode open.
outerHeight	spécifie la dimension verticale en pixels, de la bordure extérieure de la fenêtre.
outerWidth	spécifie la dimension horizontale en pixels, de la bordure extérieure de la fenêtre.
pageXOffset	fournit la position x actuelle, en pixels, de la page vue d'une fenêtre.
pageYOffset	fournit la position y actuelle, en pixels, de la page vue d'une fenêtre.
parent	représente le parent du cadre.
personalbar	repérésente la barre personnelle du navigateur.
screenX	spécifie la coordonnée x du bord gauche d'une fenêtre.
screenY	spécifie la coordonnée y du bord supérieure d'une fenêtre.
scrollbars	représente la barre de défilement du navigateur.
self	est un synonyme pour la fenêtre courante.
status	spécifie une priorité ou le message temporaire s'affiche dans la barre d'état de la fenêtre.
statusbar	représente la barre de statut du navigateur.
toolbar	représente la barre d'outils du navigateur.
top	représente la fenêtre associée au cadre.
window	est un synonyme pour la fenêtre courante.

Méthodes

Méthode	Description
alert(texte)	affiche un message dans une boîte de dialogue contenant un bouton OK.
atob(Chaîne_de_données)	décode une chaîne de données qui a été encodées en employant la base 64 d'encodage.
back()	défait la dernière étape de l'historique dans n'importe quel cadre à l'intérieur d'une fenêtre de plus haut niveau.
blur()	enlève le focus sur l'élément window.
btoa(chaîne_de_caractère)	crée une base d'encodage sur 64 bits.
captureEvents(event.TYPE)	permet de capturer tous les types d'événements spécifiés produit dans la fenêtre ou le document.
clearInterval(temps)	stoppe une minuterie qui était lancé par la méthode setInterval.
clearTimeout(temps)	stoppe une minuterie qui était lancé par la méthode setTimeout.
close()	ferme la fenêtre spécifiée.
confirm(texte)	affiche une boîte de dialogue de confirmation contenant les boutons OK et Cancel.
crypto.random(nombre)	retourne une chaîne de caractères pseudo-aléatoire dont la longueur est le nombre indiqué d'octets.
crypto.signText(texte, ask/auto, autorité)	retourne une chaîne de données encodées qui représente un objet signé.
disableExternalCapture()	met hors de service l'événement externe capturé lancé par la méthode enableExternalCapture.
enableExternalCapture()	permet à une fenêtre avec cadre à capturer des événements dans des pages chargées à partir de différents serveurs.
find(texte, bool_cas_sensible, bool_recherche_arrière)	permet de trouver la chaîne de caractère spécifiée dans le contenu de la fenêtre indiquée.
focus()	donne le focus à l'objet spécifié.
forward()	charge la prochaîne adresse URL dans le tableau de l'historique.
handleEvent(événement)	invoque le Handler pour spécifier un événement.
home()	dirige l'URL indiqué dans des favoris comme page d'accueil du navigateur.
moveBy(horizontal, vertical)	déplace la fenêtre à partir d'une valeur spécifiée.
moveTo(x, y)	déplace le coin supérieur gauche de la fenêtre aux coordonnées d'écran spécifiées.
open(URL, Nom, séparateur)	ouvre une nouvelle fenêtre du navigateur.
print()	imprime le contenu d'une fenêtre ou d'un cadre.
prompt(texte, valeur_par_défaut)	affiche une boîte de dialogue avec un message et une zone de saisie.
releaseEvents(envent.TYPE)	cesse la capture du type d'événements spécifié.
resizeBy(horizontal, vertical)	redimensionne une fenêtre entière par le déplacement du coin inférieur droit de la fenêtre par une valeur spécifiée.
resizeTo(largeur, hauteur)	redimensionne une fenêtre entière à la hauteur et la largeur extérieures spécifiées.
routeEvent(événement)	transmet un événement capturé au prochaine gestionnaire.
scroll	permet de faire défiler une fenêtre à partir des coordonnées spécifiées.
scrollBy(horizontal, vertical)	permet de faire défiler une zone d'une fenêtre par une valeur spécifiée.
scrollTo(x, y)	permet de faire défiler une zone visible de la fenêtre par des coordonnées spécifiées, tel que le point spécifié devienne le coin supérieur gauche.
setHotKeys(true/false)	active ou désactive les raccourcis claviers dans une fenêtre.
setInterval(fonction, temps, argumentN)	évalue une expression ou appelle une fonction à intervalle régulier spécifié en millisecondes.
setResizable(true/false)	Indique si on permet à un utilisateur de redimensionner une fenêtre.
setTimeout(fonction, temps, argumentN)	évalue une expression ou appelle une fonction une fois que le temps spécifié en millisecondes se soit écoulé.
setZOptions(option)	contrôle l'empilement de la fenêtre.
stop()	stoppe le téléchargement courant.

Evénements

Evénement	Description
onBlur	la fenêtre perd son statut d'élément actif.
onDragDrop	des éléments sont déposés dans la fenêtre.
onError	erreur au cours du chargement d'une image
onFocus	la fenêtre devient active.
onLoad	le hargement de la fenêtre est opéré.
onMove	déplacement de la fenêtre
onResize	redimensionnement de la fenêtre.
onLoad	chargement de l'image.

Exemple [voir]

<html>
  <head>
    <title>Cadre de Frames</title>
  </head>
  <frameset rows="60,*">
    <frame name="haut" src="frame_haut_ex.html">
    <frame name="bas" src="frame_bas_ex.html">
  </frameset>
</html>

<html>
  <head>
    <title>Frame du Haut</title>
    <script language="Javascript">
      var cadre = "bas";
      function ouverture()
      {
        var index = document.forms[0].elements[0].options.selectedIndex;
        if (index > 0)
        {
          var page = document.forms[0].elements[0].options[index].value;
          parent.frames[cadre].location.href = page;
        }
        return true;
      }
    </script>
  </head>
  <body>
    <form>
      <select name="choisir" onchange="javascript:ouverture()">
        <option>Choisir un site</option>
        <option value="http://developer.netscape.com/">Netscape</option>
        <optionvalue="http://msdn.microsoft.com/>Microsoft</option>
      </select>
    </form>
  </body>
</html>

<html>
  <head>
    <title>Frame du Bas</title>
  </head>
  <body>
    Sélectionner un site ci-dessus...
  </body>
</html>

En savoir plus :