tableNN 6 IE 4 DOM 1

L'objet table représente l'élément table. Les autres objets liés à l'objet table sont les suivants: caption, col, colgroup, tbody, td, tfoot, thead et tr.

 
Equivalent HTML
 
<table>
 
Référence de modèle d'objet
 
[window.]document.getElementById("elementID")
 
Propriétés spécifiques à l´objet
 
alignbackgroundbgColorborder
borderColorborderColorDarkborderColorLightcaption
cellPaddingcells[]cellSpacingcols
dataPageSizeframeheightrows[]
rulessummarytbodies[]tFoot
tHeadwidth
 
Méthodes spécifiques à l´objet
 
createCaption()createTFoot()createTHead()deleteCaption()
deleteRow()deleteTFoot()deleteTHead()insertRow()
lastPage()moveRow()nextPage()previousPage()
refresh()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

alignNN 6 IE 4 DOM 1

Lecture/écriture

Détermine l'alignement horizontal de l'élément dans le conteneur environnant.

 
Exemple
 
document.getElementById("myTable").align = "center";
 
Valeur

L'une des constantes d'alignement horizontal suivantes: center | left | right.

 
Par défaut

left

backgroundNN s.o. IE 4 DOM s.o.

Lecture/écriture

Fournit l´adresse URL de l'image d'arrière-plan pour le tableau. Si vous définissez également une propriété backgroundColor pour l'élément, la couleur s'affiche si le chargement de l'image échoue. Sinon, l'image recouvre la couleur.

 
Exemple
 
document.getElementById("myTable").background = "images/watermark.jpg";
 
Valeur

Toute adresse URL complète ou relative pointant sur le fichier image d'arrière-plan.

 
Par défaut

Aucune.

bgColorNN 6 IE 4 DOM 1

Lecture/écriture

Définit la couleur d'arrière-plan de l'élément. Cette couleur n'apparaît pas dans la propriété de feuille de style backgroundColor. Même si l'attribut bgcolor ou la propriété bgcolor est défini à l'aide d'un nom de couleur en anglais, la valeur renvoyée est toujours un triplet de couleurs en hexadécimal.

 
Exemple
 
document.getElementById("myTable").bgColor = "yellow";
 
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

Varie selon le navigateur et le système d'exploitation.

borderNN 6 IE 4 DOM 1

Lecture/écriture

Spécifie l´épaisseur de la bordure entourant le tableau (en pixels). Il s'agit de la bordure tridimensionnelle par défaut, à ne pas confondre avec les bordures créées à l'aide de feuilles de style.

 
Exemple
 
document.getElementById("myTable").border = 4;
 
Valeur

Un nombre entier. La valeur zéro supprime totalement la bordure.

 
Par défaut

0

borderColorNN s.o. IE 4 DOM s.o.

Lecture/écriture

Spécifie la couleur de la bordure du tableau. Internet Explorer applique la couleur aux quatre lignes de la bordure d'une cellule. Par conséquent, les couleurs de cellules adjacentes ne se touchent pas.

 
Exemple
 
document.getElementById("myTable").borderColor = "salmon";
 
Valeur

Triplet de couleurs en hexadécimal, ou l'un des noms de couleurs en anglais. Si la valeur de cet attribut n'est pas indiquée, elle sera interprétée comme "#000000" (noir). Reportez-vous à l'annexe A pour connaître les noms de couleurs admises/autorisées.

 
Par défaut

Varie selon le système d'exploitation.

borderColorDark, borderColorLightNN s.o. IE 4 DOM s.o.

Lecture/écriture

L'effet tridimensionnel des bordures d'un tableau dans Internet Explorer est créé par un agencement minutieux de lignes claires et foncées sur le fond ou la couleur par défaut de la page. Vous pouvez contrôler individuellement les couleurs utilisées pour les lignes claires et foncées en affectant des valeurs aux propriétés borderColorDark (bords gauche et supérieur de la cellule) et borderColorLight (bords droit et inférieur).

 

En général, l'utilisateur affecte des couleurs complémentaires à la paire de propriétés. Toutefois rien ne vous oblige à définir une couleur foncée pour borderColorDark. Comme les attributs ne contrôlent qu'un jeu de lignes bien défini, vous pouvez aisément déterminer les lignes de bordure qui changeront avec chaque attribut.

 
Exemple
 
document.getElementById("myTable").borderColorDark = "blue";
document.getElementById("myTable").borderColorLight = "cornflowerblue";
 
Valeur

Triplet de couleurs en hexadécimal, ou l'un des noms de couleurs en anglais. Si la valeur de cet attribut n'est pas indiquée, elle sera interprétée comme "#000000" (noir). Reportez-vous à l'annexe A pour connaître les noms de couleurs admises/autorisées.

 
Par défaut

Varie selon le système d'exploitation.

captionNN 6 IE 4(Win)/5(Mac) DOM 1

Lecture seule

Renvoie une référence à l'objet caption imbriqué dans le tableau. A partir de cette référence, vous pouvez accéder aux propriétés et méthodes de l'objet caption. Dans Netscape 6, vous pouvez créer un nouvel élément caption et affecter la référence de ce nouvel élément à la propriété caption d´un objet table, faisant que la propriété soit en lecture/écriture dans ce navigateur (mais vous devriez vraiment utiliser la méthode createCaption()). Cependant, pour tous les navigateurs, vous pouvez modifier les propriétés de l´objet caption renvoyé par la propriété caption.

 
Exemple
 
var capText = document.getElementById("myTable").caption.innerHTML;
 
Valeur

Référence d´objet

 
Par défaut

Aucune.

cellPaddingNN 6 IE 4 DOM 1

Lecture/écriture

Spécifie la quantité d'espace blanc entre la bordure (visible ou invisible) d´une cellule du tableau et le contenu de cette cellule. Notez que cette propriété s'applique à l'espace à l'intérieur d'une cellule. Les ajustements mineurs de cette propriété ne sont pas aussi perceptibles lorsque les bordures du tableau ne s'affichent pas (dans ce cas, la propriété cellSpacing permet d'ajuster l'espace entre les cellules).

 
Exemple
 
document.getElementById("myTable").cellPadding = "15";
 
Valeur

Valeur, sous forme de chaîne, d'une longueur définie en pixels ou pourcentage.

 
Par défaut

0

cellsNN s.o. IE 5 (Win) DOM s.o.

Lecture seule

Renvoie une collection de tous les objets td du tableau. La collection est triée dans l'ordre du code source des éléments td. Cette propriété est plus couramment disponible pour un élément tr (une ligne à la fois).

 
Exemple
 
var totCells = document.getElementById("myTable").cells.length;
 
Valeur

Référence à un objet de collection cells.

 
Par défaut

Tableau de longueur zéro.

cellSpacingNN 6 IE 4 DOM 1

Lecture/écriture

Spécifie la quantité d´espace vide entre les bords extérieurs de chaque cellule du tableau. Si le tableau a une bordure, cellSpacing permet de définir la largeur des bordures affichées entre les cellules. Même lorsqu´un tableau ne possède pas de bordures visibles, sa lisibilité sera fréquemment améliorée par un espacement des cellules ou par une combinaison d´espacement et de remplissage des cellules.

 
Exemple
 
document.getElementById("myTable").cellSpacing = "5";
 
Valeur

Valeur, sous forme de chaîne, d'une longueur définie en pixels ou pourcentage.

 
Par défaut

0 (sans bordure de tableau); 2 (avec bordure de tableau).

colsNN s.o. IE 4 DOM 1

Lecture/écriture

Spécifie le nombre de colonnes du tableau. L'attribut cols correspondant spécifique à IE aide le navigateur à préparer l'affichage du tableau. En l´absence de cet attribut, le navigateur doit effectuer une interprétation de tous les éléments tr et td chargés pour déterminer la façon dont le tableau doit être divisé. Bien qu´elle soit en lecture/écriture, vous ne pouvez pas modifier la composition des colonnes d´un tableau à partir de cette propriété. Reportez-vous aussi à l´objet col précédemment dans ce chapitre

 
Exemple
 
document.getElementById("myTable").cols = 5;
 
Valeur

Nombre entier.

 
Par défaut

Aucune.

dataPageSizeNN s.o. IE 4 DOM s.o.

Lecture/écriture

Cette propriété est utilisée par IE, dans le cadre d'une liaison de données, pour indiquer au navigateur le nombre de lignes de tableau à afficher compte tenu du nombre d'enregistrements de source de données défini par cet attribut. Reportez-vous aux méthodes lastPage(), nextPage() et previousPage() permettant de parcourir des groupes d'enregistrements.

 
Exemple
 
document.getElementById("inventoryTable").dataPageSize = 10;
 
Valeur

Nombre entier.

 
Par défaut

Aucune.

"> frameNN 6 IE 4 DOM 1

Lecture/écriture

Détermine les côtés (éventuels) de la bordure extérieure d'un tableau (définie avec l'attribut border ou la propriété border) qui s'affichent. Cette propriété n'affecte pas les bords intérieurs entre les cellules.

  Exemple  
document.getElementById("orderForm").frame = "hsides";
  Valeur

Constante de cadre insensible à la casse, sous forme de chaîne:

  above

Affiche uniquement la bordure sur le côté supérieur du tableau

below

Affiche uniquement la bordure sur le côté inférieur du tableau

border

Affiche les quatre côtés de la bordure (comme box)

box

Affiche les quatre côtés de la bordure (comme border)

hsides

Affiche uniquement les bordures sur les côtés supérieur et inférieur du tableau (aspect très propre)

lhs

Affiche uniquement la bordure sur le côté gauche du tableau

rhs

Affiche uniquement la bordure sur le côté droit du tableau

void

Masque toutes les bordures (valeur par défaut en HTML 4)

vsides

Affiche uniquement la bordure sur les côtés gauche et droit du tableau

  Par défaut

void (lorsque border=0); border (lorsque border est défini sur toute autre valeur)

filters[]NN s.o. IE 4 DOM s.o.

Renvoie un tableau de tous les objets filter que contient l´élément courant. Ne s´applique qu´aux objets éléments suivants: bdo , body , button , div , fieldset , img , input , marquee , rt , ruby , span , table , td , textarea et th . Voir l'objet filter pour la syntaxe de référencement.

 
Valeur

Tableau des références des objets filter .

 
Par défaut

Tableau de longueur zéro.

height, widthNN 6 (largeur uniquement) IE 4 DOM 1 (largeur uniquement)

Lecture/écriture

Fournit la hauteur et la largeur de l'élément en pixels. La modification de ces valeurs se reflète immédiatement dans l'actualisation du contenu de la page. Seule la propriété width est disponible dans Netscape 6 (et dans le DOM W3C), puisque la hauteur du tableau est considéré être la somme de la plus haute cellule de chaque ligne.

 
Exemple
 
document.getElementById("myTable").height = 250;
 
Valeur

Nombre entier.

 
Par défaut

Aucune.

rowsNN 6 IE 4 DOM 1

Lecture seule

Renvoie une collection de tous les objets tr du tableau. Vous pouvez aussi obtenir un groupe de lignes pour chaque section de tableau (objets éléments tbody, tfoot et thead).

 
Exemple
 
var allTableRows = document.getElementById("myTable").rows;
 
Valeur

Référence à un objet de collection rows.

 
Par défaut

Tableau de longueur zéro.

"> rulesNN 6 IE 4 DOM 1

Lecture/écriture

Définit si (et, dans ce cas, où) les bordures intérieures entre les cellules sont affichées par le navigateur. Outre le paramétrage du tableau afin d'obtenir le tracé de bordures destinées à convertir les cellules en matrice, vous pouvez paramétrer des bordures uniquement pour séparer des bordures, des colonnes ou tout groupe de cellules choisi (thead, tbody, tfoot, colgroup ou col). L´attribut border doit être présent – soit de façon booléenne par sa seule présence, soit avec une taille de bordure spécifique – pour que les bordures des cellules apparaissent. Ne confondez pas cette propriété avec la collection rules[] d'objets styleSheet. Les modifications apportées à cette propriété par script n´ont pas toujours les résultats escomptés dans les anciennes versions de Netscape 6.

  Exemple  
document.getElementById("myTable").rules = "groups";
  Valeur

Constante insensible à la casse sous forme de chaîne:

  all

Affiche des bordures autour de chaque cellule

cols

Affiche des bordures uniquement entre les colonnes

groups

Affiche les bordures entre les groupes de cellules comme défini par les éléments thead, tfoot, tbody, colgroup ou col

none

Masque toutes les bordures intérieures

rows

Affiche des bordures uniquement entre les lignes

  Par défaut

none (si border=0); all (si border possède une autre valeur).

summaryNN 6 IE 6 DOM 1

Lecture seule

Représente l´attribut summary HTML 4, qui ne fournit pas de fonctionnalité particulière dans les navigateurs courants. Mais vous pouvez lui affecter une valeur dans le code source pour transmettre des données à un script qui lit la propriété.

 
Exemple
 
var data = document.getElementById("myTable").summary;
 
Valeur

Chaîne.

 
Par défaut

Une chaîne vide.

tBodies[]NN 6 IE 4(Win)/5(Mac) DOM 1

Lecture seule

Renvoie une collection d'objets tBody du tableau courant. Chaque élément table a au moins un objet tBody (explicite ou implicite) imbriqué à l´intérieur.

 
Exemple
 
var bodSections = document.getElementById("myTable").tBodies;
 
Valeur

Référence à une collection d´objets tBody.

 
Par défaut

Tableau de longueur un.

tFootNN 6 IE 4(Win)/5(Mac) DOM 1

Lecture seule

Renvoie une référence à l'élément objet tfoot si le tableau en a défini un. En l'absence d'un élément tfoot, la valeur est null. A partir de cette référence, vous pouvez accéder aux propriétés et méthodes de l'objet tfoot. Cette propriété n'est disponible que dans la version Win32 de Microsoft Internet Explorer 4.

 
Exemple
 
var tableFootTxt = document.getElementById("myTable").tFoot.firstChild.nodeValue;
 
Valeur

Référence de l'objet élément tfoot.

 
Par défaut

null

tHeadNN 6 IE 4(Win)/5(Mac) DOM 1

Lecture seule

Renvoie une référence à l'élément objet thead si le tableau en a défini un. En l'absence d'un élément thead, la valeur est null. A partir de cette référence, vous pouvez accéder aux propriétés et méthodes de l'objet thead. Cette propriété n'est disponible que dans la version Win32 de Microsoft Internet Explorer 4.

 
Exemple
 
var tableHeadTxt = document.getElementById("myTable").tHead.firstChild.nodevalue;
 
Valeur

Référence de l'objet élément thead.

 
Par défaut

null

width

Voir height.

createCaption(), deleteCaption()NN 6 IE 4 DOM 1

Ajoutez ou supprimez un élément caption imbriqué dans l´élément table courant. S´il n´existe pas de légende, la méthode de création produit un élément vide, que vos scripts doivent remplir avec du texte de légende (par le biais de techniques de modification du contenu de l´élément courant). S´il y a une légende, la méthode est ignorée et renvoie une référence à l´élément caption existant.

 
Paramètres

Aucune.

 
Valeur renvoyée

Référence au nouvel élément de légende (pour createCaption()); rien pour deleteCaption().

createTFoot(), createTHead(), deleteTFoot(), deleteTHead()NN 6 IE 4 DOM 1

Ajoutez ou supprimez un élément thead imbriqué dans l´élément table courant. S´il n´existe pas de section d´en-tête ou de pied de page, la méthode de création produit un élément vide, que vos scripts doivent remplir avec des lignes (par le biais des méthodes thead.insertRow() and tfoot.insertRow()). Si la section de tableau désirée existe, la méthode est ignorée et renvoie une référence à l´élément thead or tfoot existant.

 
Paramètres

Aucune.

 
Valeur renvoyée

Référence au nouvel élément (for createTFoot() et createTHead()); rien pour deleteTHead() et deleteTFoot().

deleteRow()NN 6 IE 4 DOM 1

deleteRow(index)

Supprime un élément tr imbriqué dans l´élément table courant. La valeur sous forme de nombre entier pointe sur l´élément à base zéro à supprimer dans la collection rows. Pour reremplir un tableau avec du contenu nouveau ou trié, videz le tableau (ou juste une section du tableau) avec des appels itératifs à la méthode deleteRow():

 
Paramètres
 
  • Un nombre entier à base zéro correspondant à l´élément tr spécifié dans l'ordre du code source (imbriqué dans l´élément courant).
 
Valeur renvoyée

Aucune.

insertRow()NN 6 IE 4(Win) DOM 1

insertRow(index)

Insère un élément tr imbriqué dans l´élément table courant. Le paramètre sous forme de nombre entier pointe sur l´endroit de l´index à base zéro dans la collection rows où la nouvelle ligne doit être insérée, mais dans IE vous pouvez aussi ajouter la valeur raccourcie -1 pour ajouter la ligne à la fin d´une collection. L´ajout de la ligne insère un nouvel élément, auquel vous ajoutez des cellules par le biais de la méthode insertCell(). Malheureusement, la définition de scripts pour l´ajout de lignes et de cellules de tableau dans IE pour Macintosh (y compris la version 5.1) ne fonctionne pas du tout et génère des dimensions de cellule et de ligne énormes. Pour les tableaux non imbriqués, vous pourrez peut-être utiliser la création et l´insertion de noeuds d´arborescence de documents à la place des méthodes de l´objet table (et connexes).

 
Paramètres
 
  • Nombre entier à base zéro correspondant à une ligne de la collection rows avant laquelle la nouvelle ligne doit être insérée.
 
Valeur renvoyée

Référence à la ligne nouvellement insérée.

lastPage(), nextPage(), previousPage()NN s.o. IE 4/5 DOM s.o.

Indique à la fonction de liaison de données de charger le dernier groupe d'enregistrements, le précédent ou le suivant de la source de données, pour réunir le nombre d'enregistrements définis par la propriété dataPageSize. La méthode lastPage() n'est pas disponible dans Internet Explorer 5 ou versions ultérieures.

 
Paramètres

Aucune.

 
Valeur renvoyée

Aucune.

moveRow()NN s.o. IE 5 (Win) DOM s.o.

moveRow(indexToMove, destinationIndex)

Déplace une ligne dans le tableau de son emplacement d´origine à une position de ligne différente. Le premier paramètre est un index à base zéro de la ligne (dans la collection rows) que vous voulez déplacer. Le deuxième paramètre est l´index de la ligne avant laquelle vous voulez placer la ligne. En tant que méthode de l´objet table, les paramètres d´index moveRow() comprennent la première ligne, qui peut contenir des éléments th que vous ne voulez pas déplacer. Invoquez la méthode pour l´objet tbody si vous voulez que le comptage ne se fasse que dans une section du tableau.

 
Paramètres
 
  • Un nombre entier à base zéro pointant sur la ligne à déplacer.
  • Un nombre entier à base zéro pointant sur la ligne au-dessus de laquelle la ligne doit être placée.
 
Valeur renvoyée

Référence à la ligne déplacée.

refresh()NN s.o. IE 4 DOM s.o.

Indique aux fonctions de liaison de données de recharger la page active de données à partir de la source de données. Si les données que le tableau puise dans la base de données changent fréquemment, vous pouvez créer une boucle setTimeout() afin que l'utilisateur puisse invoquer document.getElementById("myTable").refresh() lorsqu'il souhaite obtenir des informations actualisées de la base de données.

 
Paramètres

Aucune.

 
Valeur renvoyée

Aucune.

focus()NN 2 IE 3 DOM 1

Donne l'activation à partir de l'objet courant, moment auquel l'événement onfocus de l'objet se déclenche. Remarque: La plage d'éléments capables d'activation et de fondu (l'événement et la méthode) est limitée dans tous les navigateurs sauf dans les versions les plus récentes de Microsoft Internet Explorer (reportez-vous à l'attribut tabindex dans le chapitre 8). Pour une plus grande fiabilité en ce qui concerne la compatibilité ascendante, appliquez la méthode focus() à des éléments qui sont activables de façon évidente, tels que les éléments input et textarea .

 

Pour activer une zone de texte et présélectionner tout le texte de la zone, utilisez la séquence des méthodes focus() et select() sur l'élément. Si cette séquence doit se produire après un changement de fenêtre (par exemple, après la fermeture d'une boîte de dialogue d'alerte), placez les méthodes dans une fonction indépendante et invoquez cette méthode par le biais de la méthode setTimeout() après la méthode alert() de la boîte de dialogue. Cela permet à IE pour Windows d'exécuter les instructions dans l'ordre correct.

 
Paramètres

Aucune.

 
Valeur renvoyée

Aucune.

clientHeight, clientWidthNN 7 IE 4 DOM s.o.

Lecture seule

En gros, ces propriétés fournissent la hauteur et la largeur du contenu de l'élément, mais avec quelques variations mineures dans le remplissage de l'élément selon les versions du système d'exploitation de Microsoft Internet Explorer et les modes de compatibilité contrôlés par la déclaration DOCTYPE . Non disponible pour certains types d'éléments dans IE pour Macintosh. Pour Netscape 7, les valeurs sont de zéro, sauf quand le contenu d'un élément dépasse de la zone visible, auquel cas les valeurs révèlent les dimensions de la zone visible (par exemple, la zone de contenu de la fenêtre du navigateur pour l'élément document.body ). Pour en savoir plus, reportez-vous à la section 9.2 au début de ce chapitre.

while (tableReference.rows.length> 0) {
     tableReference.deleteRow(0);
}
 
Exemple
 
var midHeight = document.body.clientHeight/2;
 
Valeur

Valeur en pixels (nombre entier).

 
Par défaut

0

scrollHeight, scrollWidthNN 7 IE 4 DOM s.o.

Lecture seule

A l'origine, implémentées dans IE 4 pour les éléments qui défilaient ou influençaient le défilement d'un élément (body , button , caption , div , fieldset , legend , marquee et textarea ), ces propriétés renvoient les dimensions en pixels d'un élément, y compris les éléments plus grands que la zone visible de la fenêtre du navigateur. Elles sont donc différentes des propriétés clientHeight et clientWidth pour les éléments pouvant défiler, qui renvoient seulement les dimensions des portions visibles de l'élément. Cependant, IE pour Macintosh interprète différemment le but des propriétés de défilement et renvoie les dimensions de la portion visible.

 

A partir de Microsoft Internet Explorer 5 pour Windows, tous les éléments HTML ont ces propriétés et les valeurs pour les éléments ne défilant pas, sont les mêmes que celles des propriétés offsetHeight et offsetWidth . Netscape 7 implémente ces propriétés pour tous les éléments et renvoie la hauteur et la largeur de l'élément, visible ou non. Pour les éléments clés tels que body , il est important de retenir que ces propriétés peuvent être interprétées différemment et sont donc susceptibles de perturber l'opération sur différentes plates-formes.

 
Exemple
 
var midPoint = document.body.scrollHeight/2;
 
Valeur

Nombre entier positif ou zéro.

 
Par défaut

Aucune.

scrollLeft, scrollTopNN 7 IE 4 DOM s.o.

Lecture/écriture

Fournit la distance en pixels existant entre le côté gauche ou supérieur réel du contenu physique de l'élément et le côté gauche ou supérieur de la partie visible du contenu. Le paramétrage de ces propriétés permet d'utiliser un script pour ajuster le défilement du contenu à l'intérieur d'un conteneur capable de défilement, tel que du texte dans un élément textarea ou un document entier dans une fenêtre ou un cadre de navigateur. Si personne ne fait défiler le contenu, les deux valeurs sont égales à zéro. Si la valeur de la propriété scrollTop est  15, le document défile de 15  pixels dans la fenêtre; la propriété scrollLeft n'est pas affectée, sauf si elle est modifiée. Les valeurs de ces propriétés changent au fur et à mesure que l'utilisateur modifie la position des barres de défilement. Cela est important pour certaines tâches de positionnement basées sur les événements dans IE pour Windows, car le système de coordonnées pour les mesures de décalage d'événements est fonction de la zone visible d'une page dans la fenêtre du navigateur. Vous devez ajouter les facteurs de défilement document.body pour aligner les coordonnées d'événements avec les positions du contenu du corps (reportez-vous à l'exemple de glissement d'un élément dans le chapitre 6). A partir de Microsoft Internet Explorer 5 pour Windows, les propriétés scrollLeft et scrollTop sont disponibles pour tous les objets éléments HTML, mais les valeurs pour les éléments qui ne défilent pas sont de zéro.

 
Exemple
 
document.body.scrollTop = 40;
 
Valeur

Nombre entier positif ou zéro.

 
Par défaut

0

tabIndexNN 6 IE 4 DOM 1

Lecture/écriture

Nombre indiquant la position de cet élément dans l'ordre de tabulation des éléments pouvant être activés dans le document. L'ordre de tabulation suit un ensemble de règles très strictes. Les éléments dont les valeurs affectées aux propriétés tabIndex diffèrent de zéro sont les premiers activés lorsqu'un utilisateur commence à tabuler dans une page. Le premier élément activé est celui dont l'attribut tabIndex a la valeur la plus faible, et ainsi de suite, dans l'ordre croissant, quel que soit l'emplacement physique des éléments sur la page ou dans le document. Si deux éléments ont un attribut tabIndex de valeur identique, c'est celui qui apparaît le premier dans le document qui est activé d'abord. Viennent ensuite les éléments qui ne prennent pas en charge la propriété tabIndex ou dont la valeur est zéro. Ces éléments sont activés dans l'ordre où ils apparaissent dans le document.

 

Le DOM W3C et Netscape 6 limitent la propriété tabIndex aux objets éléments suivants: a , area , button , input , object , select , textarea . A cette liste, IE 4 ajoute applet , body , div , embed , isindex , marquee , span , table , et td . IE 5 ajoute tout autre élément affichable. Une valeur négative dans IE (uniquement) supprime un élément de la séquence de tabulation.

 

Les liens et les ancres ne sont pas activables à l'aide de la touche de tabulation dans la version Macintosh de Microsoft Internet Explorer 4 et la propriété tabIndex des objets éléments a est donc ignorée dans cette version.

 
Exemple
 
document.getElementById("link3").tabIndex = 6;
 
Valeur

Nombre entier.

 
Par défaut

0

blur()NN 2 IE 3 DOM 1

Supprime l'activation de l'objet courant, moment auquel l'événement onblur de l'objet se déclenche. Remarque: La plage d'éléments capables d'activation et de fondu (l'événement et la méthode) est limitée dans tous les navigateurs sauf dans les versions les plus récentes de Microsoft Internet Explorer (reportez-vous à l'attribut tabindex dans le chapitre 8). Pour une plus grande fiabilité en ce qui concerne la compatibilité ascendante, appliquez la méthode blur() à des éléments qui sont activables de façon évidente, tels que les éléments input et textarea . L'affectation de l'attribut onfocus="this.blur();" à un élément input texte, par exemple, est une façon grossière mais efficace en matière de compatibilité ascendante de désactiver un champ pour les navigateurs ne fournissant pas de véritable désactivation d'éléments.

 

Utilisez les méthodes blur() et focus() avec modération sur la même page. Vous pouvez déclencher des boucles d'activation et de fondu infinies par accident si des boîtes de dialogue d'alerte sont impliquées à un moment ou à un autre. De plus, sachez que lorsque vous invoquez la méthode blur() sur un objet, un autre objet (peut-être l'objet window ) reçoit un événement onfocus .

 
Paramètres

Aucune.

 
Valeur renvoyée

Aucune.