embed | NN 3 IE 4 DOM s.o.
L'objet embed représente l'élément embed. Bien que l´objet embed se voit remplacé par l´objet object dans les nouvelles générations de navigateurs, les scripts dans les navigateurs tels que Navigator 3, Navigator 4 et IE 4 pour Windows peuvent contrôler les lecteurs multimédia chargés dans une page en réponse au pointeur de l´élément embed à un fichier multimédia sur le serveur. Les propriétés et les méthodes présentées par le lecteur passent dans l´objet embed de façon à ce que les scripts traitent l´objet embed comme si sa liste de capacités définissables par script était élargie. Les propriétés répertoriées ici sont les propriétés que l´objet élément, et non un contrôleur externe, présente aux scripts.
Remarque: IE 5 pour Macintosh traite l´objet embed plus comme l´objet object et présente les propriétés plus alignées avec un objet object ou applet qu´avec un objet embed. Cependant, cela n´a guère d´importance puisque, jusqu´à la version 5.1, IE pour Mac ne laisse pas les scripts communiquer avec les lecteurs ou contrôleurs externes.
Equivalent HTML
    <embed>
Référence de modèle d'objet
    [window.]document.getElementById("elementID")
    [window.]document.embeds[i]
Propriétés spécifiques à l´objet
align | height | hidden | name | palette
pluginspage | src | type | units | width
Méthodes spécifiques à l´objet
Aucune.
Propriétés de gestionnaire d´événements spécifiques à l´objet
Aucune.

align | NN 6 IE 5(Mac) DOM s.o.
| Lecture/écriture
Détermine l'alignement de l'élément dans le conteneur environnant. Reportez-vous à la section 8.1.5 au début du chapitre 8 pour connaître l'incidence des différentes valeurs sur cette propriété.
Exemple
    document.getElementById("audioPlayer").align = "center";
Valeur
L'une des constantes d'alignement suivantes: absbottom | absmiddle | baseline | bottom | left | middle | right | texttop | top.
Par défaut
left

height, width | NN 6 IE 4 DOM s.o.
| Lecture/écriture
Indiquent la hauteur et la largeur de l'élément, en pixels, comme définies par les attributs de la balise. La modification de ces valeurs ne modifie pas nécessairement le rectangle de l´applet une fois le chargement effectué.
Exemple
    var controllerHeight = document.embeds["audioPlayer"].height;
Valeur
Nombre entier.
Par défaut
0

hidden | NN s.o. IE 4 (Win) DOM s.o.
| Lecture/écriture
Indique si le panneau de contrôle du plug-in des données incorporées s'affiche à l'écran. Les modifications apportées à cette propriété entraînent l'actualisation du contenu de la page afin de libérer de l'espace pour le panneau de contrôle du plug-in ou de refermer l'espace autour d'un nouveau tableau caché.
Exemple
    document.embeds["jukebox"].hidden = true;
Valeur
Valeur booléenne: true | false.
Par défaut
false

name | NN 6 IE 4 DOM s.o.
| Lecture/écriture (Internet Explorer)
Représente la valeur d´attribut name de la balise de l´élément.
Exemple
    document.embeds["myEmbed"].name = "tunes";
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.

palette | NN s.o. IE 4 (Win) DOM s.o.
| Lecture seule
Renvoie le paramètre de l'attribut palette de l'objet embed.
Valeur
Chaîne.
Par défaut
Aucune.

pluginspage | NN s.o. IE 4 (Win) DOM s.o.
| Lecture seule
Indique l´adresse URL pour le téléchargement et l'installation du plug-in nécessaire à l'exécution des données incorporées de l'objet courant.
Valeur
Adresse URL complète ou relative sous forme de chaîne.
Par défaut
Aucune n´est renvoyée, mais Internet Explorer possède sa propre adresse URL par défaut concernant les informations de plug-in.

src | NN s.o. IE 4 (Win) DOM s.o.
| Lecture/écriture
Indique l´adresse URL du fichier de contenu externe associé à l'objet. Bien que certains contrôleurs puissent répondre aux modifications de cet attribut, il est plus fiable de charger un fichier différent dans le contrôleur à l´aide de sa propre méthode ou propriété de chargement.
Exemple
    document.embeds["myEmbed"].src = "tunes/dannyboy.wav";
Valeur
Adresse URL complète ou relative, sous forme de chaîne.
Par défaut
Aucune.

type | NN 6 IE s.o. DOM s.o.
| Lecture seule
Indique le type MIME des données externes affectées à l'attribut type de l'élément.
Exemple
    var dataMIME = document.embeds["myEmbed"].type;
Valeur
Tout nom de type MIME valide, sous forme d´une chaîne de caractères entre guillemets, comprenant les parties type et sous-type délimitées par une barre oblique.
Par défaut
Aucune.

units | NN s.o. IE 4 (Win) DOM s.o.
| Lecture/écriture
Spécifie l´unité de mesure représentant la hauteur et la largeur de l'élément. Internet Explorer représente tous les paramètres en pixels.
Exemple
    document.getElementById("myEmbed").units = "ems";
Valeur
L'une des constantes non sensibles à la casse suivantes (sous forme de chaîne): pixels | px | em.
Par défaut
pixels

width |
Voir height.

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.

accessKey | NN 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.

clientHeight, clientWidth | NN 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.
Exemple
    var midHeight = document.body.clientHeight/2;
Valeur
Valeur en pixels (nombre entier).
Par défaut
0

clientLeft, clientTop | NN s.o. IE 4 DOM s.o.
| Lecture seule
En gros, ces propriétés fournissent les coordonnées gauche et supérieure du contenu de l'élément dans le cadre qui inclut le remplissage de l'élément, mais avec des variations mineures selon les versions du système d'exploitation de Microsoft Internet Explorer. Non disponible pour certains types d'éléments dans IE pour Macintosh. Pour en savoir plus, reportez-vous à la section 9.2 au début du présent chapitre. Des informations plus utiles sur le positionnement des éléments internes proviennent généralement des propriétés offsetLeft et offsetTop (y compris dans Netscape 6). Pour les éléments positionnés par CSS (y compris la modification de la position d'un élément), utilisez les propriétés de l'objet style , telles que left et top , et (dans IE uniquement) pixelLeft et pixelTop .
Valeur
Valeur en pixels (nombre entier).
Par défaut
0

readyState | NN 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.

scrollHeight, scrollWidth | NN 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, scrollTop | NN 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

tabIndex | NN 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.