Objet | NN 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 | ||||||
|
||||||
Méthodes | ||||||
|
||||||
Création d'un objet Object | ||||||
var myObject = new Object(); var myObject = {propName1:propVal1[, propName2:propVal2[,...N]]}; var myObject = new constructorFuncName([propVal1[, propVal2[,...N]]]); |
constructor | NN 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 | ||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||
Valeur renvoyée | ||||||||||||||||||||||||||||||||||||||||||
Une des valeurs sous forme de chaîne dans le tableau suivant. |
||||||||||||||||||||||||||||||||||||||||||
|
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 | |
|
|
Valeur renvoyée | |
Valeur booléenne: true | false . |
prototype | NN 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 | |
|
|
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 | |
|
|
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 | |
|
|
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 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 . |
isDisabled | NN 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 |