buttonNN 6 IE 4 DOM 2

Lecture seule

Identifie quel bouton de la souris a été enfoncé pour déclencher l´événement de souris. N´oubliez pas qu´un Macintosh typique a une souris à un seul bouton. De plus, si vous voulez intercepter le menu contextuel du bouton droit de la souris dans IE pour Windows, utilisez le gestionnaire d´événements oncontextmenu.

 

Il existe une incohérence importante entre les spécifications et implémentations DOM par rapport aux nombres renvoyés pour cette propriété. Le DOM W3C, tel qu´il est implémenté dans Netscape 6, spécifie une valeur zéro pour indiquer le bouton gauche (principal). IE pour Windows prend en charge des valeurs supplémentaires pour les combinaisons de boutons de la souris.

 
Exemple
 
if (evt.button == 2) {
		    // handle event for right button
		}
 
Valeur

Valeur, sous forme de nombre entier, selon le tableau suivant.

 
Bouton(s)IENN 6DOM W3C
Aucun bouton0nullnull
Gauche (principal)100
Milieu411
Droit222
Gauche + droit3s.os.o
Gauche + milieu5s.os.o
Droit + milieu6s.os.o
Gauche + milieu + droit7s.os.o
 
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.

dataFldNN s.o. IE 4 DOM s.o.

Lecture/écriture

Utilisée avec la fonction de liaison de données de Microsoft Internet Explorer pour associer un nom de colonne provenant d'une source de données distante à l'étiquette de l'objet button. Vous devez également définir un attribut datasrc pour l'élément. Le paramétrage des deux propriétés dataFld et dataSrc sur des chaînes vides rompt la liaison entre l'élément et la source de données.

 
Exemple
 
document.getElementById("myButton").dataFld = "linkURL";
 
Valeur

Identifiant de la colonne de la source de données, sensible à la casse.

 
Par défaut

Aucune.

dataFormatAsNN s.o. IE 4 DOM s.o.

Lecture/écriture

Utilisée avec la fonction de liaison de données de Microsoft Internet Explorer, cette propriété indique au navigateur si le matériel source provenant de la source de données doit être interprété en texte brut ou en langage HTML avec balises.

 
Exemple
 
document.getElementById("myButton").dataFormatAs = "html";
 
Valeur

Valeurs constantes sous forme de chaîne : text | html.

 
Par défaut

text

dataSrcNN s.o. IE 4 DOM s.o.

Lecture/écriture

Utilisée 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 de la source de données est déterminé par l'attribut datafld dans l'élément button. Le paramétrage des deux propriétés dataFld et dataSrc sur des chaînes vides rompt la liaison entre l'élément et la source de données.

 
Exemple
 
document.getElementById("myButton").dataSrc = "DBSRC3";
 
Valeur

Identifiant de l´élément object, sensible à la casse.

 
Par défaut

Aucune.

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.

formNN 6 IE 4 DOM 1

Lecture seule

Renvoie une référence à l'élément form qui contient l'élément courant (le cas échéant).

 
Exemple
 
var theForm = event.srcElement.form;
 
Valeur

Référence d´objet

 
Par défaut

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.

nameNN 6 IE 4 DOM 1

Lecture/écriture

Identifiant associé à l'élément lorsque ce dernier est utilisé sous forme de contrôle de formulaire. Lors de l'envoi du formulaire au serveur, la valeur de cette propriété est envoyée comme une moitié de la paire nom / valeur. Les noms sont invisibles pour l'utilisateur, les étiquettes de contrôle étant affectées par d'autres moyens, en fonction du type de contrôle. Les noms de contrôle de formulaire peuvent également être utilisés dans des instructions de script faisant référence aux objets.

 
Exemple
 
document.forms[0].compName.name = "company";
 
Valeur

Identifiant sensible à la casse, conforme aux règles de dénomination des identifiants: il ne peut pas contenir d'espace blanc ni de signe de ponctuation, à l'exception du caractère de soulignement, et ne peut pas commencer par un chiffre.

 
Par défaut

Aucune.

statusNN s.o. IE 4 DOM s.o.

Lecture/écriture

Contrairement à la propriété status d'autres types de contrôles de formulaire, cette propriété n'affecte pas l'aspect ou la fonction du bouton.

 
Valeur

Valeur booléenne: true | false ou null.

 
Par défaut

null

typeNN 6 IE 4 DOM 1

Lecture seule

Détermine si l'élément button est utilisé comme bouton de style button, reset ou submit.

 
Exemple
 
if (evt.target.type == "button") {
    // process button element
}
 
Valeur

Une des trois constantes suivantes sous forme de chaîne : button | reset | submit.

 
Par défaut

button

valueNN 6 IE 4 DOM 1

Lecture seule

Fournit la valeur courante associée au contrôle de formulaire envoyé avec la paire nom/valeur de cet élément. Contrairement à l´objet élément input de type bouton, la valeur de cette propriété value n´est pas visible pour l´utilisateur ; l´étiquette est définie par le contenu de l´élément (propriété innerHTML ou nœud imbriqué).

 
Exemple
 
var val = document.getElementById("myButton").value;
 
Valeur

Chaîne.

 
Par défaut

Aucune.

createTextRange()NN s.o. IE 4 (Win) DOM s.o.

Crée un objet TextRange contenant le texte de l´étiquette du bouton. Reportez-vous à l'objet TextRange.

 
Paramètres

Aucune.

 
Valeur renvoyée

Objet TextRange.

accessKeyNN s.o. IE 4 DOM 1

Lecture/écriture

Une seule touche de caractère qui active un élément (dans certains navigateurs) ou active un contrôle de formulaire ou une action de lien. Le navigateur et le système d'exploitation déterminent si l'utilisateur doit appuyer sur une touche de modification (par exemple Ctrl, Alt ou Commande) en même temps que sur la touche d'accès pour activer le lien. Dans IE 5 pour Windows et versions ultérieures ainsi que Netscape 6, il doit obligatoirement s'agir de la touche Alt et celle-ci est insensible à  la casse. Dans IE 5 pour Macintosh et versions ultérieures ainsi que Netscape 6, il doit obligatoirement s'agir de la touche Ctrl.

 

Bien que répertorié ici comme attribut largement partagé, ce n'est pas toujours le cas dans toutes les implémentations. Netscape 6 (par le biais du DOM W3C) reconnaît cette propriété pour les éléments suivants uniquement  : a , area , button , input , label , legend et textarea . A cette liste, IE 4 ajoute applet , body , div , embed , isindex , marquee , object , select , span , table et td (mais supprime label et legend ). IE 5 ajoute tout autre élément affichable, mais attention  : à  l'exception de l'élément input et d'autres éléments ayant trait aux formulaires, vous devez aussi affecter un attribut tabindex ou une propriété tabIndex à  l'élément dans IE 5 et versions ultérieures (même s'il ne s'agit que d'une valeur de zéro pour tous) pour permettre à  la combinaison de touches d'accélération d'activer l'élément. A partir de Netscape 7, Netscape ne modifie pas le comportement de l'interface utilisateur si un script modifie la valeur de la propriété.

 
Exemple
 
document.links[3].accessKey = "n";
 
Valeur

Caractère unique du clavier alphanumérique (y compris les signes de ponctuation).

 
Par défaut

Une chaîne vide.

disabledNN 6 IE 4 DOM 1

Lecture/écriture

Détermine si l'élément est disponible pour une action interactive de l'utilisateur. S'il est défini sur la valeur true , l'utilisateur ne peut pas activer ni modifier cet élément, qui apparaît généralement en grisé sur cette page. Cette propriété est disponible pour tous les objets éléments dans IE 5.5 pour Windows et versions ultérieures. Pour IE 4 et IE 5, elle ne s'applique qu'aux contrôles de formulaire, alors que Netscape 6 et versions ultérieures reconnaissent cette propriété pour les contrôles de formulaire et l'objet élément style . La paire désactivée nom  /  valeur d'un contrôle de formulaire n'est pas transmise avec le formulaire.

 
Exemple
 
document.getElementById("myButton").disabled = true;
 
Valeur

Valeur booléenne: true | false .

 
Par défaut

false

recordNumberNN s.o. IE 4 DOM s.o.

Lecture seule

Utilisée avec la fonction de liaison de données IE, renvoie un nombre entier représentant l'enregistrement dans le jeu de données ayant généré l'élément (par exemple un élément dont le contenu provient d'une liaison de données). Vous pouvez utiliser les valeurs de cette propriété pour extraire un enregistrement donné d'un ensemble d'enregistrements Active Data Objects (ADO) (voir la propriété recordset ). Bien que cette propriété soit définie pour tous les objets éléments de Microsoft Internet Explorer, les autres propriétés associées à  la liaison de données appartiennent à  un sous-ensemble d'éléments.

 
Exemple
 
<script for="tableTemplate" event="onclick">
    myDataCollection.recordset.absoluteposition = this.recordNumber;
    ...
</script>
 
Valeur

Nombre entier.

 
Par défaut

null

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