<FRAMESET> | NN 2 IE 3 HTML 4
<FRAMESET>...</FRAMESET> | Balise de fin HTML : obligatoire
Définit la disposition d'une présentation en plusieurs cadres dans la fenêtre principale du navigateur. Le rôle principal de l'élément frameset consiste à spécifier la disposition, exprimée en lignes et en colonnes, de cadres rectangulaires. Les attributs définis dans un élément frameset s'appliquent à tous les éléments frame qu'il contient (sauf si un attribut similaire définit une autre valeur pour un élément frame). Dans un document HTML, une balise d'élément frameset occupe la place normalement occupée par l'élément body. Vous pouvez imbriquer un élément frameset à l'intérieur d'un autre élément frameset. Cette tactique permet de subdiviser le cadre de l'élément frameset extérieur en plusieurs cadres. Par exemple, si vous définissez un élément frameset avec trois lignes et deux colonnes, vous obtenez un total de six cadres Par ailleurs, si vous imbriquez un nouveau jeu de cadres à l'emplacement de la définition d'un cadre, ce dernier est divisé conformément à la définition de ce jeu de cadres imbriqué. Vous pouvez imbriquer des éléments frameset aussi profondément que le requiert la mise en page. Notez toutefois que sur certains systèmes d'exploitation, les cadres monopolisent une partie importante des ressources des navigateurs en mémoire vive. Certains utilisateurs n'apprécient guère la présence de cadres affichant des bordures, même si la mise en page justifie une telle structure. Le document de jeu de cadres père est celui dont l'attribut title régit l'affichage dans la barre de titre de la fenêtre du navigateur. Les documents chargés dans des cadres individuels ne contrôlent pas l'affichage de la barre de titre, bien que l'utilisation de scripts et les applications potentielles dans de futurs navigateurs justifient que l'attribut title soit défini de toute façon. Si vous voulez offrir à l'utilisateur la possibilité de supprimer un jeu de cadres, vous pouvez fournir un lien ou un bouton appelant un script. Le script doit définir la propriété top.location.href de l'adresse URL du principal document des pages chargées dans les cadres (le contenu principal). Les DTD strictes pour HTML 4 et XHTML excluent explicitement la prise en charge des éléments frameset et frame (ainsi que des attributs target d'autres éléments pointant vers des cadres). Ces DTD (Document Type Definition) traitent les cadres comme n'étant pas inclus dans le cadre du marquage pur de document. Vous pouvez valider un jeu de cadres avec les DTD de jeu de cadres et de transition HTML 4 ou la DTD de jeu de cadres XHTML.
Exemple
    <FRAMESET cols="150,*">
        <FRAME name="navbar" id="navbar" src="nav.html">
        <FRAME name="main" id="main" src="page1.html">
    </FRAMESET>
Référence de modèle d'objet
    [window.]document.getElementById(elementID)
Attributs spécifiques à l'élément
border | bordercolor | cols | frameborder | framespacing | rows
Attributs du gestionnaire d´événements spécifiques à l´élément
Gestionnaire | NN | IE | HTML
onload | 2 | 3 | 4
onunload | 2 | 3 | 4

border | NN 4 IE 3 HTML s.o.
border="pixelCount" | Facultatif
Par défaut, les cadres affichent des bordures tridimensionnelles. L'épaisseur par défaut de cette bordure varie selon le navigateur et le système d'exploitation. Vous pouvez régler l'épaisseur en affectant une autre valeur à l'attribut border du jeu de cadres. Seul l'élément frameset parent d'un système de jeux de cadres imbriqués répond au paramétrage de l'attribut border. Cet attribut contrôle les bordures intercadres, non la bordure du jeu de cadres. Navigator 4 est cohérent sur les plates-formes Windows et Macintosh en affichant une bordure par défaut d'une épaisseur correspondant à celle qui est obtenue en paramétrant l'attribut border sur 5. Pour Internet Explorer, la valeur de paramétrage par défaut est de 6 pour Windows et de 1 pour Macintosh (même si, à l'écran, l'épaisseur de la bordure est nettement supérieure à un pixel). Le paramétrage de l'attribut border ne produit donc pas le même effet dans tous les navigateurs. De plus, de faibles valeurs de paramétrage produisent parfois des résultats singuliers. Internet Explorer 6 n'affiche pas de bordure dans Windows si la valeur paramétrée est inférieure ou égale à 4, tandis que Navigator perd sa troisième dimension si la valeur paramétrée est inférieure ou égale à 2. En outre, sur Macintosh, Navigator 4 a la fâcheuse habitude d'afficher une étrange boule au centre des barres de cadre. Ce déploiement chaotique risque de vous dissuader définitivement d'utiliser cet artifice (paramétrez l'attribut border sur 0). Pourtant, les bordures produisent parfois un effet rassurant lorsqu'un cadre contient une barre de défilement. L'affichage d'une barre de défilement flottante dans une fenêtre du navigateur peut en effet déconcerter certains utilisateurs. Le fait que les spécifications HTML 4 ne comportent pas d'attribut border permet de penser que leurs concepteurs ont préféré l'utilisation d'une feuille de style pour définir les bordures, plutôt qu'un paramétrage de bordures liées uniquement aux cadres. Seule exception cependant, un attribut de style CSS relatif aux bordures n'affecte qu'une bordure autour du jeu de cadres complet et il n'a aucune incidence sur les bordures entre les cadres.
Exemple
    <FRAMESET cols="150,*" border="0">...</FRAMESET>
Valeur
Un nombre entier. La valeur zéro supprime totalement la bordure. Bien que la valeur soit censée représenter l'épaisseur précise en pixels des bordures d'un jeu de cadres, tous les systèmes d'exploitation et les navigateurs ne la reconnaissent pas.
Par défaut
Voir description
Référence de modèle d'objet
    [window.]document.getElementById(elementID).border

bordercolor | NN 4 IE 3 HTML s.o.
bordercolor="colorTripletOrName" | Facultatif
Établit la couleur d'affichage des bordures visibles d'un jeu de cadres. Il est toujours possible que l'attribut bordercolor d'un élément frameset imbriqué (uniquement pour les cadres de jeux de cadres imbriqués) ou d'un élément frame individuel modifie le paramétrage bordercolor de l'élément frameset parent. Les navigateurs résolvent les conflits entre couleurs affectées à des cadres adjacents de différentes manières. Testez les combinaisons de couleur que vous voulez utiliser pour les bordures.
Exemple
    <FRAMESET cols="150,*" bordercolor="salmon">...</FRAMESET>
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
Couleur par défaut du navigateur, généralement une nuance de gris avec un filet noir ou bleu pour produire l'effet 3D.
Référence de modèle d'objet
    [window.]document.getElementById(elementID).borderColor

cols | NN 2 IE 3 HTML 4
cols="columnLengthsList" | Facultatif
Définit les tailles et proportions de l'organisation des colonnes de cadres d'un jeu de cadres. Pour utiliser l'élément frameset afin de créer des cadres de plusieurs colonnes, vous devez affecter une liste de valeurs à l'attribut cols (une valeur par colonne). La taille des colonnes peut être définie par l'un des paramètres suivants: Utilisez une taille absolue si vous voulez que la largeur d'un cadre ne varie pas, quelle que soit la dimension de la fenêtre du navigateur affichée. Cette option est particulièrement utile lorsque le cadre doit afficher un objet de largeur fixe, par exemple une image. Utilisez la solution du pourcentage si vous voulez que la largeur du cadre soit proportionnelle à celle du jeu de cadres, quelle que soit la dimension de la fenêtre du navigateur affichée. Si vous utilisez toutes les valeurs de pourcentage pour l'attribut cols, elles doivent totaliser 100 %. Si les valeurs ne totalisent pas 100 %, le navigateur adapte la taille des colonnes à son gré. Enfin, utilisez le caractère générique astérisque comme valeur pour laisser au navigateur le soin de calculer la largeur d'un cadre lorsque tous les autres cadres du jeu de cadres sont affectés d'une valeur fixe ou d'un pourcentage. Dans la chaîne, séparez les valeurs par des virgules. Vous pouvez mêler les trois types de valeurs dans la chaîne de l'attribut. Prenons, par exemple, un jeu de cadres de trois colonnes. Si vous voulez que la largeur de la colonne de gauche soit exactement de 150 pixels, et que celle du centre occupe 50 % de la largeur totale du jeu de cadres, paramétrez la valeur comme suit: La largeur précise des deux cadres de droite différera suivant la largeur de fenêtre du navigateur de chaque visiteur. Dans notre exemple, la largeur du cadre situé le pus à droite est à peu près égale à la moitié de la largeur du jeu de cadres, moins les 150 pixels réservés au cadre de gauche. Vous pouvez définir une colonne invisible à droite. Utilisez les valeurs de pourcentage pour les colonnes visibles et assurez-vous que leur total correspond à 100%. Affectez ensuite la valeur astérisque à la colonne finale. Pour créer une trame de cadres régulière, affectez des valeurs aux attributs cols et rows dans la balise de l'élément frameset. Pour obtenir un tableau non symétrique, vous devez imbriquer des éléments frameset, comme expliqué dans la description de l'élément frameset plus haut dans cette section.
Exemple
    <FRAMESET cols="25%,50%,25%">...</FRAMESET>
Valeur
Liste de valeurs séparées par des virgules, et exprimées en pixels, en pourcentage ou par le caractère générique (*). Internet Explorer 4 pour Macintosh ne fonctionne pas correctement avec certaines combinaisons comprenant un caractère générique.
Par défaut
100%
Référence de modèle d'objet
    [window.]document.getElementById(elementID).cols

frameborder | NN 3 IE 3 HTML s.o.
frameborder="borderSwitch" | Facultatif
Détermine si tous les cadres du jeu de cadres affichent une bordure de séparation. L'attribut frameborder des éléments frame peut prendre le pas sur le paramétrage de l'élément frameset pour cet attribut. Toutefois, certaines organisations de cadres se prêtent mal à l'élimination des cadres de sous-groupes de cadres. Modifiez l'attribut de l'élément frameset avec prudence et testez le résultat sur tous les navigateurs et plates-formes possibles.
Exemple
    <FRAMESET cols="25%,50%,25%" frameborder="no">...</FRAMESET>
Valeur
Les valeurs d'activation et désactivation de cet attribut varient selon les navigateurs. Navigator utilise yes et no. Internet Explorer 4 et versions ultérieures yes | no et 1 | 0. Pour garantir la compatibilité entre les navigateurs, utilisez la paire yes/no.
Par défaut
yes
Référence de modèle d'objet
    [window.]document.getElementById(elementID).frameBorder

framespacing | NN s.o. IE 3 HTML s.o.
framespacing="pixelLength" | Facultatif
L'attribut framespacing de Microsoft Internet Explorer est une version ancienne de l'attribut border. L'ancien attribut est pris en charge par Internet Explorer à fins de compatibilité ascendante. Le comportement de l'attribut framespacing sur les différentes plates-formes est plus uniforme avec les versions de Microsoft Internet Explorer: la bordure générée entre les cadres par un paramétrage de 10 est presque identique dans les versions Windows et Macintosh. Dans Internet Explorer, l'attribut framespacing est la manière la plus précise de créer des bordures présentant un aspect similaire sur les deux systèmes d'exploitation.
Exemple
    <FRAMESET cols="25%,50%,25%" framespacing="7">...</FRAMESET>
Valeur
Tout entier positif. Toutefois, contrairement à l'attribut border, un paramétrage de zéro ne supprime pas la bordure. Utilisez l'attribut frameborder pour masquer totalement les bordures.
Par défaut
2
Référence de modèle d'objet
    [window.]document.getElementById(elementID).frameSpacing

rows | NN 2 IE 3 HTML 4
rows="rowLengthsList" | Facultatif
Définit les tailles ou les proportions de la répartition des lignes d'un cadre dans un jeu de cadres. Pour utiliser l'élément frameset afin de créer des cadres de plusieurs lignes, vous devez affecter une liste de valeurs à l'attribut rows (une valeur par ligne). La taille des lignes peut être définie par l'un des paramètres suivants: Utilisez une taille absolue si vous voulez que la hauteur d'une ligne de cadre ne varie pas, quelle que soit la dimension de la fenêtre du navigateur affichée. Cette option est particulièrement utile lorsque le cadre doit afficher un objet de hauteur fixe, par exemple une image. Utilisez la solution du pourcentage si vous voulez que la hauteur du cadre soit proportionnelle à celle du jeu de cadres, quelle que soit la dimension de la fenêtre du navigateur affichée. Si vous définissez toutes les valeurs de pourcentage pour l'attribut rows, elles doivent totaliser 100 %. Si les valeurs ne totalisent pas 100 %, le navigateur adapte la taille des lignes à son gré. Enfin, utilisez le caractère générique astérisque comme valeur pour laisser au navigateur le soin de calculer la hauteur d'une ligne lorsque toutes les autres lignes du jeu de cadres sont affectées d'une valeur fixe ou d'un pourcentage. Dans la chaîne, séparez les valeurs par des virgules. Vous pouvez mêler les trois types de valeurs dans la chaîne de l'attribut. Prenons, par exemple, un jeu de cadres de trois lignes. Si vous voulez que la hauteur de la ligne inférieure soit exactement de 80 pixels pour accueillir une barre de navigation et que celle du centre occupe 50 % de la hauteur totale du jeu de cadres, paramétrez la valeur comme suit: La hauteur précise des deux cadres supérieurs différera suivant la hauteur de fenêtre du navigateur de chaque visiteur. Dans notre exemple, la hauteur du cadre supérieur est à peu près égale à la moitié de la hauteur du jeu de cadres, moins les 80 pixels réservés au cadre inférieur. Vous pouvez définir une ligne invisible en bas. Utilisez les valeurs de pourcentage pour les lignes visibles et assurez-vous que leur total correspond à 100%. Affectez ensuite la valeur astérisque à la colonne finale. Pour créer une trame de cadres régulière, affectez des valeurs aux attributs cols et rows dans la balise de l'élément frameset. Pour obtenir un tableau non symétrique, vous devez imbriquer des éléments frameset, comme expliqué dans la description de l'élément frameset plus haut dans cette section.
Exemple
    <FRAMESET rows="25%,50%,25%">...</FRAMESET>
Valeur
Liste de valeurs séparées par des virgules, et exprimées en pixels, en pourcentage ou par le caractère générique (*). Internet Explorer 4 pour Macintosh ne fonctionne pas correctement avec certaines combinaisons comprenant un caractère générique.
Par défaut
100%
Référence de modèle d'objet
    [window.]document.getElementById(elementID).rows

style | NN 4 IE 4 HTML 4
style="styleSheetProperties" | Facultatif
Cet attribut permet de définir une ou plusieurs propriétés de style pour l'élément considéré. Vous pouvez utiliser la syntaxe CSS ou (pour Navigator 4 uniquement) JavaScript pour affecter des attributs de style. Utilisez l'attribut style uniquement avec les éléments visibles (affichables).
Exemple
    <span style="color:green; font-size:18px">Big, green, and bold</span>
Valeur
L'ensemble de la règle de feuille de style, qui est conforme à la syntaxe des CSS, est entre guillemets. Les divers attributs de style et leurs valeurs sont séparés par des points-virgules. Les attributs des feuilles de style sont présentés en détail dans le chapitre 11.
Par défaut
Aucune.
Référence de modèle d'objet
    [window.]document.getElementById(elementID).style