ObjetNN 3 IE 4 ECMA 1

En plus d´être la base « silencieuse » de tous les objets JavaScript d´origine, l´objet Object est le modèle d´objet pur JavaScript, y compris pour les objets de scripts personnalisés que vous créez. Utilisez l´objet Object pour générer des choses dans vos scripts avec des comportements définis par des propriétés et/ou des méthodes personnalisées. Généralement, vous commencez par créer un objet vide avec la fonction constructeur, puis vous affectez des valeurs aux nouvelles propriétés de cet objet.

 

Navigator 4, IE 5 et leurs versions ultérieures vous permettent aussi d´affecter des propriétés et des valeurs par le biais d´une syntaxe littérale particulière qui crée aussi l´instance Object dans le processus:

var myObject = {propName1:propValue1[, propName2:propValue2[, 
...propNameN:propValueN]]}
 

Vous pouvez utiliser des objets comme des structures de données pour les données personnalisées et structurées de vos scripts, un peu comme lorsque vous créez un tableau avec des valeurs d´index nommées.

 
Propriétés
 
constructor prototype
 
Méthodes
 
hasOwnProperty()isPrototypeOf()propertyIsEnumerable()
toLocaleString()toString()valueOf()
 
Création d'un objet Object
 
var myObject = new Object();
var myObject = {propName1:propVal1[, propName2:propVal2[,...N]]};
var myObject = new constructorFuncName([propVal1[, propVal2[,...N]]]);
constructorNN 4 IE 4 ECMA 1

Lecture/écriture

Il s´agit d´une référence à la fonction qui a créé l´instance d´un objet Object: la fonction constructeur Object() d´origine dans les navigateurs.

 
Exemple
 
if (myVar.constructor == Object) {
    // process native string
}
 
Valeur

Référence de l´objet de fonction.

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

componentFromPoint(x, y)

Renvoie une chaîne qui dénote où se trouvent les points de coordonnées dans l´élément. Pour les éléments qui affichent des barres de défilement, la valeur renvoyée révèle précisément quelle partie de la barre de défilement se trouve à l´emplacement de la coordonnée. Si vous activez le mode de modification des documents de Microsoft, des parties supplémentaires, telles que les poignées de modification de taille, sont également indiquées dans la valeur renvoyée. Pour les zones des éléments qui n´affichent pas de barres de défilement ou de poignées de modification, vous pouvez aussi déterminer si la coordonnée est à l´intérieur ou à l´extérieur de l´élément, ce qui est pratique pour la détection de collision entre les coordonnées d´événement et l´élément.

 

La source la plus courante pour les valeurs de paramètres de coordonnées est l´objet event , en particulier les propriétés event.clientX et event.clientY . Vous pouvez appliquer ces valeurs directement, comme dans:

 
Paramètres
 
  • Nombre positif ou négatif de pixels par rapport à la partie supérieure de l'écran.
  • Nombre positif ou négatif de pixels par rapport au côté gauche de l'écran
 
Valeur renvoyée

Une des valeurs sous forme de chaîne dans le tableau suivant.

 
Valeurs renvoyées sous forme de chaîneDescription
chaîne videA l´intérieur de la zone de contenu de l´élément
outside A l´extérieur de la zone de contenu de l´élément
handleBottom Poignée de redimensionnement du mode de modification, en bas
handleBottomLeft Poignée de redimensionnement du mode de modification, en bas à gauche
handleBottomRight Poignée de redimensionnement du mode de modification, en bas à droite
handleLeft Poignée de redimensionnement du mode de modification, à gauche
handleRight Poignée de redimensionnement du mode de modification, à droite
handleTop Poignée de redimensionnement du mode de modification, en haut
handleTopLeft Poignée de redimensionnement du mode de modification, en haut à gauche
handleTopRight Poignée de redimensionnement du mode de modification, en haut à droite
scrollbarDown Flèche Bas de la barre de défilement
scrollbarHThumb Commande au pouce de la barre de défilement horizontale
scrollbarLeft Flèche gauche de la barre de défilement
scrollbarPageDown Zone de défilement au-dessous du curseur de la barre de défilement
scrollbarPageLeft Zone de défilement à gauche du curseur de la barre de défilement
scrollbarPageRight Zone de défilement à droite du curseur de la barre de défilement
scrollbarPageUp Zone de défilement au-dessus du curseur de la barre de défilement
scrollbarRight Flèche droite de la barre de défilement
scrollbarUp Flèche Haut de la barre de défilement
scrollbarVThumb Commande au pouce de la barre de défilement verticale
contains()NN s.o. IE 4 DOM s.o.

contains(elementReference)

Indique si l´élément courant contient l´élément spécifié.

 
Paramètres
 
  • Une référence à un objet élément entièrement formée (par exemple document.getElementById("myDIV") ).
 
Valeur renvoyée

Valeur booléenne: true | false .

prototypeNN 4 IE 4 ECMA 1

Lecture/écriture

Propriété de l'objet Object statique. Utilisez la propriété prototype pour affecter de nouvelles propriétés et méthodes aux futures instances d´un Object créées dans le document considéré. Pour des exemples, voir la description de la propriété Array.prototype.

 
Exemple
 
Object.prototype.author = "DG";
 
Valeur

N´importe quelle donnée, y compris des références à des fonctions.

hasOwnProperty()NN 6 IE 5.5(Win) ECMA 3

hasOwnProperty("propertyName")

Renvoie la valeur booléenne true si, au moment où l´instance de l´objet considéré a été créée, son constructeur (ou affectation littérale) contenait une propriété avec un nom correspondant à la valeur du paramètre. Une propriété affectée à un objet par le biais de sa propriété prototype n´est pas considérée comme l´une des propriétés de l´objet.

 
Paramètres
 
  • Chaîne contenant le nom de la propriété d´un objet.
 
Valeur renvoyée

Valeur booléenne: true | false.

isPrototypeOf()NN 6 IE 5.5(Win) ECMA 3

isPrototypeOf(objectReference)

Renvoie la valeur booléenne true s´il y a une correspondance entre l´objet considéré et l´objet transmis comme paramètre à un point de la chaîne d´héritage de prototype de chaque objet. Remarque: IE et Navigator donnent parfois des résultats différents.

 
Paramètres
 
  • Référence à un objet qui partage potentiellement l´héritage du prototype avec l´objet considéré.
 
Valeur renvoyée

Valeur booléenne: true | false.

propertyIsEnumerable()NN 6 IE 5.5(Win) ECMA 3

propertyIsEnumerable("propertyName")

Renvoie la valeur booléenne true si la propriété, dont le nom est transmis comme paramètre, se présente à l´inspection de propriétés for/in par le biais de l´objet.

 
Paramètres
 
  • Chaîne contenant le nom de la propriété d´un objet.
 
Valeur renvoyée

Valeur booléenne: true | false.

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

Désactive le mode de capture d´événements de souris activé précédemment par le biais de la méthode setCapture() . Dans le modèle d´événement IE, la capture des événements de souris est conçue pour une utilisation temporaire, comme le traitement des événements de souris pendant qu´un menu contextuel personnalisé (implémenté comme élément positionné div ) est activé. La capture d´événements IE est aussi désactivée automatiquement par certaines actions de l´utilisateur: activation d´une autre fenêtre, d´un autre cadre ou de la zone d´adresse du navigateur; défilement d´une fenêtre; affichage d´une boîte de dialogue système; ou affichage du vrai menu contextuel.

 
Paramètres

Aucune.

 
Valeur renvoyée

Aucune.

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

setCapture([containerFlag])

Initie le mode de capture de Microsoft Internet Explorer pour tous les événements de souris ayant trait aux clics (onclick , ondblclick , onmousedown , onmousemove , onmouseout , onmouseover , onmouseup ), envoyant le traitement de ces événements à l´élément considéré, quelle que soit la cible réelle de ces événements. Utile pour la modalité de souris nécessaire lors du traitement de menus contextuels personnalisés ou du glissement. Lorsque la capture est activée, la propriété event.srcElement pour chaque événement contient une référence à l´élément qui recevrait normalement l´événement, mais seuls les gestionnaires d´événements de l´élément en mode capture traitent les événements. Lorsque l´effet modal n´est plus nécessaire, désactivez le mode de capture par le biais de la méthode releaseCapture() . La capture d´événements IE est aussi désactivée automatiquement par certaines actions de l´utilisateur: activation d´une autre fenêtre, d´un autre cadre ou de la zone d´adresse du navigateur; défilement d´une fenêtre; affichage d´une boîte de dialogue système; ou affichage du vrai menu contextuel.

 

A partir de Microsoft Internet Explorer 5.5, un paramètre facultatif fournit un meilleur contrôle de la propagation des événements lorsqu´un utilisateur déclenche un événement de souris au-dessus d´un élément dont le parent est en mode capture. Le comportement par défaut (paramètre omis ou défini sur true ) fait que le conteneur parent intercepte les événements, comme vous vous y attendez. Mais si vous définissez le paramètre sur false , vous indiquez aux événements de se diriger initialement vers leurs cibles d´événements (éléments descendant de l´élément en mode capture). De tels événements peuvent alors remonter normalement; tous les autres événements de souris vont directement à l´élément en mode capture. Par exemple, si vous invoquez la méthode setCapture() sur un élément contenant un formulaire avec des contrôles de formulaires sur lesquels il est possible de cliquer, vous voudrez probablement utiliser le paramètre false de façon à ce que les actions de la souris (telles que les clics dans les zones de texte) atteignent leurs cibles même quand le mode de capture est activé. Sinon, les éléments descendants ne répondront pas aux activités de la souris et les contrôles de formulaires se comporteront comme s´ils étaient désactivés.

 
Paramètres
 
  • Valeur booléenne true (valeur par défaut) pour permettre à l´élément considéré (s´il s´agit d´un conteneur) de capturer tous les éléments de souris, ou false pour permettre aux éléments de souris d´atteindre leurs cibles avant de remonter.
 
Valeur renvoyée

Aucune.

toLocaleString()NN 6 IE 5.5(Win) ECMA 3

C´est aux navigateurs de déterminer comment localiser les représentations sous forme de chaînes des instances d´objets. A l´heure actuelle, ils semblent effectuer la même action que la méthode toString(), en renvoyant la valeur [object Object].

 
Paramètres

Aucune.

 
Valeur renvoyée

Chaîne.

toString()NN 4 IE 4 ECMA 1

Renvoie la valeur de l'objet comme type de données sous forme de chaîne. Dans les navigateurs récents, cette valeur est [object Object].

 
Paramètres

Aucune.

 
Valeur renvoyée

Chaîne.

valueOf()NN 4 IE 4 ECMA 1

Renvoie la valeur de l'objet.

 
Paramètres

Aucune.

 
Valeur renvoyée

Référence d´un objet.

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

Renvoie un objet TextRectangle IE qui décrit l´espace rectangulaire occupé par l´élément courant (y compris les éléments autres que du texte, comme les images). Le rectangle (qui a des propriétés pour les coordonnées top , right , bottom et left ) a la largeur du point le plus large du contenu (par exemple, la ligne la plus longue d´un paragraphe avec renvois à la ligne) et la hauteur de la somme de tout le contenu. Pour obtenir les mesures de rectangles pour les lignes individuelles d´un élément de texte, reportez-vous à la méthode getClientRects() .

 
Paramètres

Aucune.

 
Valeur renvoyée

Objet TextRectangle .

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

Renvoie un tableau d´objets TextRectangle IE. Chaque entrée du tableau est un objet TextRectangle pour une seule ligne d´un élément de texte multilignes. Les lignes avec des tailles de polices ou des hauteurs de lignes différentes seront entourées de rectangles de hauteurs différentes. Reportez-vous à l'objet TextRectangle pour ses propriétés. Pour obtenir un objet TextRectangle pour un élément entier, utilisez la méthode getBoundingClientRect() .

 
Paramètres

Aucune.

 
Valeur renvoyée

Tableau d´objets TextRectangle .

isDisabledNN s.o. IE 5,5 (Win) DOM s.o.

Lecture seule

Détermine si l'élément courant est désactivé. Révèle si l´état de désactivation est explicitement défini pour l´élément ou hérité de l´arborescence de ses ancêtres.

 
Exemple
 
if (document.getElementById("elementID").isDisabled) {
		    // process the disabled element
		}
 
Valeur

Valeur booléenne: true | false .

 
Par défaut

false