<FRAME>NN 2 IE 3 HTML 4  

<FRAME>

Balise de fin HTML : interdite  

L'élément frame définit les propriétés d'un espace individuel correspondant à une fraction de la fenêtre du navigateur. L'élément frame doit être défini dans le contexte d'un élément frameset. C'est l'élément frameset qui définit la disposition en lignes et colonnes d'un groupe de cadres apparentés.

Un navigateur traite un cadre comme une fenêtre de navigateur distincte à l'intérieur de la fenêtre du navigateur. Chaque cadre peut donc charger son propre contenu indépendamment des autres cadres. Bien qu'aucun des attributs de l'élément frame ne soit obligatoire, l'affectation d'une valeur à l'attribut name est fortement recommandée si vous avez des formulaires ou des liens dont le document de retour ou de destination doit s'afficher dans un autre cadre. L'utilisation de scripts pour contrôler plusieurs cadres bénéficie également beaucoup de l'affectation de noms aux cadres, car celle-ci facilite la compréhension des références à ces cadres (et à leur contenu) lors de la lecture du code du script. Dans les DTD W3C récentes, l'élément frame est uniquement validé dans la DTD de transition HTML 4.01 et les DTD de jeux de cadres pour HTML 4.01 et XHTML 1.0. Reportez-vous à l'annexe  E.

 
Exemple
 
<FRAMESET cols="150,*">
    <FRAME name="navbar" src="nav.html">
    <FRAME name="main" src="page1.html">
</FRAMESET>
 
Référence de modèle d'objet
 
[window.]frameName
[window.]frames[i]
[window.]document.getElementById(elementID)
 
Attributs spécifiques à l'élément
 
allowtransparencybordercolordataflddatasrc
frameborderheightlongdescmarginheight
marginwidthnamenoresizescrolling
securitysrcwidth
 
Attributs du gestionnaire d´événements spécifiques à l´élément

Aucune.

allowtransparencyNN s.o. IE 5.5 HTML s.o.  

allowtransparency="featureSwitch"

Facultatif  

Mieux applicable à l'élément iframe, l'attribut allowtransparency, lorsque vous l'activez, convertit l'arrière-plan du cadre en un arrière-plan transparent. Reportez-vous à l'élément iframe.

bordercolorNN 4 IE 3 HTML s.o.  

bordercolor="colorTripletOrName"

Facultatif  

Si votre jeu de cadres affiche des bordures (définies à l'aide de l'attribut border de l'élément frameset) et si vous voulez qu'un sous-ensemble de cadres du jeu de cadres s'affiche avec une couleur de bordure différente, vous pouvez affecter une couleur à l'attribut bordercolor de chaque élément frame. Le mélange des couleurs de bordure dans un jeu de cadres expose votre code HTML aux risques liés à l'hétérogénéité des techniques d'affichage des différents navigateurs et systèmes d'exploitation. Outre les variantes dans la composition précise des pixels des bordures, les différents navigateurs et systèmes d'exploitation n'utilisent pas nécessairement la même méthode pour résoudre les conflits de couleurs entre bordures. Si vous affectez une couleur uniquement à certains cadres d'un jeu de cadres, contrôlez le résultat sur le plus grand nombre possible de versions et de systèmes d'exploitation, afin d'apprécier l'effet visuel des couleurs choisies. IE 6 pour Windows ignore cet attribut.

 
Exemple
 
<FRAME name="navbar" src="nav.html" bordercolor="salmon">
 
Valeur

Triplet de couleurs en hexadécimal ou l'un des noms de couleurs en anglais. Reportez-vous à l'annexe A pour connaître les noms de couleurs admises/autorisées.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).borderColor
datafldNN s.o. IE 4 HTML s.o.  

datafld="columnName"

Facultatif  

Cet attribut est utilisé avec Internet Explorer dans le cadre d'une liaison de données, pour associer le nom d'une colonne d'une source de données distante à un élément frame, à la place de l'attribut src. Cette colonne doit contenir une adresse URI valide (relative ou absolue). Vous devez également définir un attribut datasrc pour l'élément. S'applique uniquement aux sources de données de fichier texte dans IE 5/Mac.

 
Exemple
 
<FRAME datasrc="DBSRC3" datafld="newsURL">
 
Valeur

Identifiant sensible à la casse.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).dataFld
datasrcNN s.o. IE 4 HTML s.o.  

datasrc="dataSourceName"

Facultatif  

Utilisé avec la fonction de liaison de données de Microsoft Internet Explorer pour spécifier l'ID de l'élément object de la page, qui charge l'objet de source de données pour l'accès distant aux données. Le contenu à extraire de la source de données est spécifié à l'aide de l'attribut datafld. S'applique uniquement aux sources de données de fichier texte dans IE 5/Mac.

 
Exemple
 
<FRAME datasrc="DBSRC3" datafld="newsURL">
 
Valeur

Identifiant sensible à la casse.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).dataSrc
frameborderNN 6 IE 3 HTML 4  

frameborder="borderSwitch"

Facultatif  

Contrôle l'affichage ou non d'une bordure pour un cadre individuel au sein d'un jeu de cadres. Ce paramétrage prend normalement le pas sur celui de l'attribut frameborder de l'élément parent frameset. Le contrôle des bordures de cadres individuels est délicat pour la plupart des navigateurs dans la majorité des systèmes d'exploitations. La désactivation des bordures d'un cadre peut ne pas produire d'effet si les bordures sont activées pour tous les cadres adjacents. Activez certaines bordures et désactivez-en d'autres à titre d'essai, mais n'oubliez pas de tester l'effet final dans tous les navigateurs et sur tous les systèmes d'exploitation utilisés. L'attribut frameborder du frameset complet est plus fiable.

 
Exemple
 
<FRAME name="navbar" src="nav.html" frameborder="0">
 
Valeur

Les valeurs d'activation et désactivation de cet attribut varient selon les sources. HTML 4 spécifie des valeurs de 1 (activée) et 0 (désactivée). Navigator 3 et 4 utilisent yes et no. Internet Explorer 4 et versions ultérieures et Netscape 6 acceptent les deux jeux de valeurs.

 
Par défaut

1

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).frameBorder
height, widthNN s.o. IE 4 HTML s.o.  

height="length" width="length"

Facultatif  

La documentation HTML de Microsoft pour Internet Explorer indique que les attributs height et width contrôlent la taille d'un cadre. En pratique, dans Internet Explorer, ces attributs ne contrôlent pas directement l'aspect des cadres d'un jeu de cadres. En effet, ce sont les attributs cols et rows du frameset conteneur qui déterminent la géométrie initiale du cadre. Vous ne devez pas utiliser ces attributs.

longdescNN 6 IE 6 HTML 4  

longdesc="URL"

Facultatif  

Permet de spécifier l'adresse URL d'un document contenant une description de l'élément plus longue que celle qui apparaît dans l'attribut title. Une application de cet attribut, dans de futures versions des navigateurs, pourra consister à recevoir une description annotée de l'élément, pour les utilisateurs qui ne peuvent pas lire l'écran du navigateur. La sélection de Properties pour le menu contextuel de Netscape 6 de cet élément affiche une petite fenêtre qui inclut un lien actif vers l'URL assigné à l'attribut. Les navigateurs de la Version 6 ne proposent aucune autre fonctionnalité pour cet attribut.

 
Exemple
 
<FRAME longdesc="navDesc.html" title="Navigation Bar" src="navbar.html">
 
Valeur

Toute adresse URI et URL valide (complète ou relative).

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).longDesc
marginheight, marginwidthNN 6 IE 3 HTML 4  

marginheight="pixelCount" marginwidth="pixelCount"

Facultatif  

Nombre de pixels entre le bord intérieur d'un cadre et le contenu affiché dans ce cadre. L'attribut marginheight contrôle l'espace le long des bords supérieur et inférieur (en cas de défilement) du cadre; l'attribut marginwidth contrôle l'espace le long des bords gauche et droit. Les spécifications HTML 4 laissent le comportement par défaut à la discrétion des développeurs du navigateur.

En l'absence de toute spécification, Internet Explorer insère automatiquement une marge de 14  pixels (Windows) ou de 8  pixels (Macintosh) à l'intérieur du cadre. Mais si vous tentez d'intervenir sur ce comportement par défaut, n'oubliez pas que le paramétrage d'un seul de ces deux attributs provoque le passage à la valeur zéro de l'autre attribut. C'est pourquoi des valeurs doivent être affectées pour ces deux attributs à la fois, sauf si vous désirez que le contenu soit aligné absolument sur les bords de divers cadres.

 
Exemple
 
<FRAME src="navbar.html" marginheight="20" marginwidth="14">
 
Valeur

Tout entier positif, ou zéro.

 
Par défaut

14 (IE pour Windows) ou 8 (IE pour Macintosh).

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).marginHeight
[window.]document.getElementById(elementID).marginWidth
nameNN 2 IE 3 HTML 4  

name="elementIdentifier"

Facultatif  

Lorsque des liens ou des formulaires doivent charger leurs documents de destination ou de retour dans d'autres cadres que celui qui les contient, l'attribut target de ces éléments permet d'indiquer le cadre qui doit recevoir le nouveau contenu. Pour que le contenu soit inséré dans un cadre précis, une valeur doit être affectée à l'attribut name de ce cadre. Cette même valeur est ensuite affectée à l'attribut target de l'élément a ou form. Les scripts exécutés par le navigateur client utilisent également le nom des cadres pour référencer d'autres cadres ou le contenu d'autres cadres. Il est conseillé de donner un nom (identifiant) unique à tous les cadres.

L'attribut name est délaissé dans XHTML. Pour effectuer la validation en fonction de la DTD XHTML du jeu de cadres, affectez le même identifiant aux attributs name et id de l'élément.

 
Exemple
 
<FRAME name="navbar" id="navbar" src="nav.html">
 
Valeur

Identifiant sensible à la casse.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]frameName.name
[window.]frames[i].name
[window.]document.getElementById(elementID).name
noresizeNN 2 IE 3 HTML 4  

noresize

Facultatif  

L'utilisateur peut redimensionner les cadres en tirant sur leurs bordures, perpendiculairement à leur axe. Lorsqu'il est présent, l'attribut noresize indique au navigateur d'empêcher le redimensionnement manuel des bords du cadre par l'utilisateur. Toutes les bordures de l'élément frame affecté sont alors verrouillées, ce qui signifie que toutes les bordures des autres cadres adjacents du jeu de cadres sont verrouillées.

 
Exemple
 
<FRAME src="navbar.html" noresize>
 
Valeur

La présence de cet attribut dans HTML empêche le redimensionnement du cadre.

 
Par défaut

Par défaut, les cadres sont redimensionnables.

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).noResize
scrollingNN 2 IE 3 HTML 4  

scrolling="auto" | "no" | "yes"

Facultatif  

Par défaut, les navigateurs ajoutent des barres de défilement vertical et  /  ou horizontal lorsque le contenu d'un cadre déborde de la zone visible du cadre. Les barres de défilement peuvent fréquemment affecter la présentation du contenu, car elles occupent un espace normalement dévolu à ce contenu (les dimensions extérieures du cadre ne changent pas en fonction de la présence ou non de barres de défilement). De plus, en raison des différences de taille des polices de caractères par défaut selon le navigateur et le système d'exploitation, un texte donné s'affichera de façon différente dans différents navigateurs. Pour empêcher le cadre d'afficher des barres de défilement, donnez la valeur no à l'attribut scrolling; à l'inverse, pour que les barres de défilement soient présentes en permanence dans ce cadre, donnez à cet attribut la valeur yes. Dans ce dernier cas, si le contenu ne nécessite pas de défilement, les barres seront désactivées. Dans les anciennes versions de Navigator, les barres de défilement automatiques restent visibles, même si le contenu chargé dans le cadre ne le justifie pas. Dans Navigator 4 et versions ultérieures (et toutes les versions de Microsoft Internet Explorer), les barres de défilement automatiques s'affichent uniquement si nécessaire.

Il est conseillé de ne donner la valeur no à l'attribut scrolling qu'après avoir testé avec tous les navigateurs et toutes les plates-formes qu'un contenu important est toujours visible dans le cadre. Faute de quoi, si l'attribut noresize est défini en l'absence de barres de défilement, certains utilisateurs pourraient ne pas être en mesure de voir tout le contenu du cadre.

 
Exemple
 
<FRAME src="navbar.html" scrolling="no">
 
Valeur

Constantes: auto | no | yes.

 
Par défaut

auto

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).scrolling
securityNN s.o. IE 6 HTML s.o.  

security="restricted"

Facultatif  

Si vous l'activez, cet attribut accroît le niveau de sécurité du cadre au niveau Restreint dans les préférences de sécurité de Windows. Le contenu d'un tel cadre ne pourra peut-être pas exécuter des scripts.

 
Exemple
 
<FRAME src="navbar.html" security="restricted">
 
Valeur

Constante: restricted.

 
Par défaut

Aucune.

srcNN 2 IE 3 HTML 4  

src="URL"

Facultatif  

Définit l'adresse URL du contenu qui doit être chargé dans l'élément frame. Cette adresse URL peut être absolue, ou relative à celle du document qui contient les spécifications du jeu de cadres. Vous pouvez également utiliser la pseudo URL javascript: pour faire apparaître dans le cadre la valeur renvoyée par le script ainsi appelé. Par exemple, si vous voulez que le cadre soit vide pendant le chargement du jeu de cadres, vous pouvez définir dans le document du jeu de cadres une fonction qui renvoie une page HTML vierge. L'attribut src de chaque cadre à vider appelle la fonction depuis sa position avantageuse de cadre enfant:

Un autre type de page vierge est disponible avec certains navigateurs, via l'adresse URL about:blank, qui correspond à une page vierge résidant sur le disque dur de l'utilisateur. Toutefois, Navigator  2 et 3 pour Macintosh affichent un message indésirable avec l'adresse URL dans une fenêtre ou un cadre.

 
Exemple
 
<FRAME src="navbar.html">
 
Valeur

Une adresse URL complète ou relative, ou la pseudo-URL javascript: .

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).src
width  

  

Voir height.