objectNN 6 IE 4 DOM 1

L'objet object représente l'élément object. Celui-ci représente une méthode récente pour incorporer des objets multimédia et des données externes dans un document (à l'aide d´un plug-in, ou dans IE pour Windows, d'un contrôle ActiveX). La profondeur et la qualité de l´implémentation de cet objet (par rapport aux spécifications W3C) sont inégales selon les marques et versions de navigateurs. L´implémentation la plus constante est dans IE pour Windows pour le chargement des contrôles ActiveX.

 
Equivalent HTML
 
<object>
 
Référence de modèle d'objet
 
[window.]document.getElementById("elementID")
 
Propriétés spécifiques à l´objet
 
alignaltaltHtmlarchiveBaseHref
borderclassidcodecodeBasecodeType
contentDocumentdatadataFlddataSrcdeclare
formheighthspacenameobject
standbytypeuseMapvspacewidth
 
Méthodes spécifiques à l´objet

Aucune.

 
Propriétés de gestionnaire d´événements spécifiques à l´objet
 
GestionnaireNNIEDOM
onaborts.os.o2
onerrors.o42
onloads.os.o2
alignNN s.o. IE 4 DOM 1

Lecture/écriture

Définit l'alignement de l'élément par rapport au contenu du texte environnant. La plupart des valeurs définissent la relation verticale existant entre l'élément et le texte environnant. Par exemple, pour aligner le bas de l'élément sur la ligne de base du texte environnant, la valeur de la propriété align doit être baseline. Un élément peut “ flotter ” le long de la marge de gauche ou de droite pour permettre au texte environnant de l'entourer.

 
Exemple
 
document.getElementById("myObject").align = "absmiddle";
 
Valeur

L'une des constantes d´alignement suivantes (sous forme de chaîne): absbottom | absmiddle | baseline | bottom | right | left | none | texttop | top.

 
Par défaut

bottom

altNN s.o. IE 6 (Win) DOM s.o.

Lecture/écriture

Indique si le texte affiché (ou lu) à l'endroit où l'élément object apparaît sur la page lorsque le navigateur ne télécharge pas les graphiques (ou attend que le téléchargement soit terminé). Il est probable que Microsoft ait implémenté cette propriété non standard pour les occasions où l´élément object est utilisé pour l´affichage d´images, au lieu de l´élément img plus courant.

 
Exemple
 
document.getElementById("logoDisplay").alt = "MegaCorp Logo";
 
Valeur

Valeur de chaîne.

 
Par défaut

Aucune.

altHtmlNN s.o. IE 4 DOM s.o.

Lecture/écriture

Fournit le contenu HTML affiché si le chargement de l'objet ou de l´applet échoue. Ce contenu peut être un message, une image statique ou tout autre objet HTML approprié. Il y a des incohérences dans Internet Explorer sur le plan de la casse du nom de cette propriété. La version Win32 requiert altHtml et la version Macintosh requiert altHTML.

 
Exemple
 
document.getElementById("myObject").altHtml = "<img src='objectAlt.gif'>";
 
Valeur

Toute chaîne de caractères entre guillemets, y compris les balises HTML.

 
Par défaut

Aucune.

archiveNN 6 IE 6(Win) DOM 1

Lecture/écriture

Reflète l´attribut archivé de l´élément object, mais les navigateurs de version 6 n´affectent aucune fonctionnalité à l´attribut ou la propriété.

 
Valeur

Valeur de chaîne.

 
Par défaut

Aucune.

BaseHrefNN s.o. IE 4 (Win) DOM s.o.

Lecture seule

Renvoie l´adresse URL du document contenant l´élément object. En général, la valeur est identique à location.href de la fenêtre courante. Remarquez le mélange inhabituel minuscules/majuscules.

 
Exemple
 
var where = document.getElementById("myObject").BaseHref;
 
Valeur

Chaîne URL.

 
Par défaut

L'adresse URL du document courant.

borderNN 6 IE 6(Win) DOM 1

Lecture/écriture

Contrôle l´épaisseur de la bordure en pixels. Pour des raisons de compatibilité entre les navigateurs, utilisez des valeurs sous forme de chaînes.

 
Exemple
 
document.getElementById("myObject").border = "5";
 
Valeur

Nombre sous forme de chaîne.

 
Par défaut

0

classidNN s.o. IE 4 DOM s.o.

Lecture seule

Fournit l´adresse URL de l'implémentation de l'objet. Dans Internet Explorer, l'adresse URL peut pointer sur le répertoire CLSID de l´ordinateur client (avec une adresse URL clsid:) qui stocke tous les ID de contrôles ActiveX enregistrés, tels que DirectX ou Media Player. IE 4 pour Macintosh appelle cette propriété classID, mais dans IE 4.5, le nom apparaît tout en minuscules. Le DOM W3C omet cette propriété, bien que HTML 4 comprenne l´attribut correspondant.

 
Exemple
 
if (document.getElementById("soundObject").classid ==
    "clsid:83A38BF0-B33A-A4FF-C619A82E891D"){
    // process for the desired sound object
}
 
Valeur

Chaîne (incluant le protocole clsid: pour les contrôles ActiveX locaux).

 
Par défaut

Aucune.

codeNN 6 IE 4 DOM 1

Lecture seule

Fournit le nom de fichier de classe applet Java défini sur l´attribut code de l´élément object (lorsque vous utilisez un élément object au lieu d´un élément applet, si pris en charge par vos navigateurs).

 
Exemple
 
if (document.getElementById("clock").code == "Y2Kcounter.class") {
    // process for the found class file
}
 
Valeur

Nom de fichier de classe Applet sous forme de chaîne sensible à la casse.

 
Par défaut

Aucune.

codeBaseNN 6 IE 4 DOM 1

Lecture seule

Chemin du répertoire contenant le fichier de classe défini dans l'attribut code ou classid. L'attribut codebase nomme uniquement le chemin, et non le fichier de classe.

 
Exemple
 
if (document.getElementById("clock").codeBase == "classes") {
    // process for the found class file directory
}
 
Valeur

Nom de chemin sensible à la casse, qui est en général l'adresse relative par rapport au répertoire du document HTML courant.

 
Par défaut

Aucune.

codeTypeNN 6 IE 4 DOM 1

Lecture/écriture

Fournit une indication sur le type de contenu de l'objet auquel réfère l'attribut classid. Un navigateur peut utiliser ces informations, par exemple, pour se préparer à gérer une ressource nécessitant un plug-in ou un lecteur multimédia. Si la propriété codetype est paramétrée sur une chaîne vide, le navigateur recherche ensuite le paramétrage de l'attribut type (bien que ce dernier soit normalement associé au contenu sur lequel pointe l'adresse URL de l'attribut data). Si ces deux attributs n'ont pas de valeur paramétrée (ou ont une valeur nulle), le navigateur récupère les informations sur le type de contenu directement dans la ressource pendant que celle-ci se charge.

 
Exemple
 
document.getElementById("gameTime").codeType = "application/x-crossword";
 
Valeur

Type de MIME insensible à la casse. Un catalogue des types de MIME enregistrés est disponible à l'adresse suivante: ftp://ftp.isi.edu/in-notes/iana/assignments/media-types/.

 
Par défaut

Aucune.

contentDocumentNN 6 IE s.o DOM 2

Lecture seule

Fait référence à un noeud de document créé par l´élément object, le cas échéant.

 
Valeur

Référence de noeud de document ou null.

 
Par défaut

null

dataNN 6 IE 4 DOM 1

Lecture seule

Adresse URL d'un fichier contenant les données nécessaires à l'élément object (par opposition à l'objet lui-même). Les adresses URL relatives sont calculées par rapport à l'attribut codebase s'il est affecté; dans le cas contraire, l'adresse URL est relative à celle du document.

 
Exemple
 
var objDataURL = document.getElementById("soundEffect").data;
 
Valeur

Adresse URL complète ou relative sous forme de chaîne.

 
Par défaut

Aucune.

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

Lecture/écriture

Cet attribut est utilisé avec la liaison de données IE pour associer le nom d'une colonne d'une source de données distante à un attribut de l'élément object déterminé par les propriétés définies dans cet objet. 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("myObject").dataFld = "streamURL";
 
Valeur

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

 
Par défaut

Aucune.

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

Lecture/écriture

Utilisé 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 (un élément object autre que l´élément objet actuel). 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("myObject").dataSrc = "DBSRC3";
 
Valeur

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

 
Par défaut

Aucune.

declareNN 6 IE 6 DOM 1

Lecture/écriture

Reflète l´attribut declare. N´a aucun effet sur le contenu à partir des navigateurs de version 6.

 
Valeur

Valeur booléenne: true | false.

 
Par défaut

false

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). Cette propriété n'est appropriée que si l'objet agit comme contrôle de formulaire. Non disponible dans Internet Explorer 4.0 pour Macintosh.

 
Valeur

Référence objet ou null.

 
Par défaut

Aucune.

height, widthNN 6 IE 4 DOM 1

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.

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

Nombre entier.

 
Par défaut

Aucune.

hspace, vspaceNN 6 IE 4 DOM 1

Lecture/écriture

Fournit une mesure en pixels des marges horizontale et verticale entourant un élément object. La propriété hspace affecte de façon identique les côtés gauche et droit de l'élément; la propriété vspace affecte de façon identique les côtés haut et bas de l'élément. Ces marges diffèrent de celles définies dans les feuilles de style, mais leur aspect visuel est identique.

 
Exemple
 
document.getElementById("myObject").hspace = 5;
document.getElementById("myObject").vspace = 8;
 
Valeur

Nombre entier de pixels sous forme de chaîne.

 
Par défaut

0

nameNN 6 IE 4 DOM 1

Lecture/écriture

Identifiant associé à l´élément object. Si l'objet doit être inséré dans un formulaire, la propriété name est envoyée en tant que moitié de la paire nom/valeur lors de l'envoi du formulaire au serveur.

 
Exemple
 
document.getElementById("myObject").name = "company";
 
Valeur

Identifiant sensible à la casse, sous forme de chaîne, 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.

objectNN s.o. IE 4 DOM s.o.

Lecture seule

Fournit une référence à un conteneur (wrapper) entourant un objet pour permettre l'accès aux propriétés du DOM de l'élément object en cas de risque de confusion entre les noms et la dénomination de propriété interne de l'objet. Par exemple, si le code chargé dans un élément object contient une propriété nommée hspace, l'instruction de script document.getElementById("reader").object.hspace récupère cette propriété interne plutôt que la propriété hspace de l'élément HTML. Le conteneur de propriété object indique à l'interpréteur JavaScript d'obtenir la propriété de l'élément HTML, sans la chercher dans le code de l'objet externe.

 
Exemple
 
var objCode = document.getElementById("reader").object.code;
 
Valeur

Référence d´objet

 
Par défaut

Aucune.

standbyNN 6 IE 5(Mac)/6(Win) DOM 1

Lecture seule

Finira par prendre le rôle de l´attribut alt pour l´affichage d´un message pendant le chargement. N´a actuellement aucun effet sur l´élément.

 
Valeur

Chaîne.

 
Par défaut

Aucune.

typeNN 6 IE 4 DOM 1

Lecture/écriture

Fournit une indication sur le type MIME des données externes à charger dans l'objet. Le navigateur examine la valeur de la propriété type pour déterminer si la valeur de la propriété codeType est null.

 
Exemple
 
if (document.getElementById("myObject").type == "image/jpeg") {
    ...
}
 
Valeur

Type de MIME insensible à la casse. Un catalogue des types de MIME enregistrés est disponible à l'adresse suivante: ftp://ftp.isi.edu/in-notes/iana/assignments/media-types/.

 
Par défaut

Aucune.

useMapNN 6 IE 6 DOM 1

Lecture/écriture

Fournit l´adresse URL de l'élément map dans le document contenant des zones sensibles et des liens de carte image côté client. La valeur contient le caractère # affecté au nom de la carte dans l'attribut usemap de l'élément object.

 
Exemple
 
document.getElementById("logoViewer").useMap = "#altMap";
 
Valeur

Chaîne commençant par le caractère #, suivie du nom de l'élément map.

 
Par défaut

Aucune.

vspace

Voir hspace.

width

Voir height.

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.

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.

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

readyStateNN s.o. IE 4 DOM s.o.

Lecture seule

Renvoie l'état courant du téléchargement du contenu de l'objet. Si un script (en particulier un script déclenché par un événement utilisateur) peut exécuter certaines actions lors du chargement du document, mais doit en éviter d'autres tant que la page n'est pas complètement chargée, cette propriété fournit des informations intermédiaires sur le processus de chargement. Utilisez sa valeur dans des tests de condition. La valeur de cette propriété change de façon dynamique en fonction du progrès du chargement. Toute modification de la valeur de propriété déclenche un événement onReadyStateChange (l'événement ne remonte pas).

 

Lors de son introduction dans IE 4, la propriété n'était disponible que pour les objets document , embed , img , link , object , script et style . IE 5 a élargi la prise en charge à tous les objets éléments HTML.

 
Exemple
 
if (document.readyState == "loading") {
    //statements for alternate handling while loading
}
 
Valeur

Pour tous les éléments sauf object , une des valeurs suivantes, sous forme de chaîne: uninitialized | loading | loaded | interactive | complete . Certains éléments permettent à l'utilisateur d'interagir avec une partie du contenu. Dans ce cas, la propriété peut renvoyer la valeur interactive jusqu'à ce que le chargement soit terminé. Certains types d'éléments ne renvoient pas toutes les valeurs dans l'ordre pendant le processus de chargement. L'élément object renvoie des valeurs numériques pour ces cinq états. Elles vont de 0 (uninitialized ) à 4 (complete ).

 
Par défaut

Aucune.

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

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 .

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 .

langNN 6 IE 4 DOM 1

Lecture/écriture

Indique la langue utilisée pour les valeurs de propriétés et d´attributs de l´élément. D´autres applications et les moteurs de recherche peuvent se servir de ces informations pour aider à la sélection des dictionnaires pour la vérification orthographique et la création d´index.

 
Exemple
 
document.getElementById("elementID").lang = "de";
 
Valeur

Code de langue insensible à la casse.

 
Par défaut

Valeur par défaut du navigateur.

languageNN s.o. IE 4 DOM s.o.

Lecture/écriture

Définit le langage de script des instructions de script définies dans l´élément.

 
Exemple
 
document.getElementById("elementID").language = "vbscript";
 
Valeur

Nom de langage de script non sensible à la casse sous forme de chaîne: javascript | jscript | vbs | vbscript .

 
Par défaut

jscript

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.