aNN 6 IE 4 DOM 1

L'objet a représente l'élément a, qu'il soit configuré comme une ancre, un lien ou les deux. Les anciennes versions de Navigator et Microsoft Internet Explorer considèrent cet objet uniquement comme un membre des tableaux links[] et/ou anchors[] d'un document. A partir de Microsoft Internet Explorer 4 et Netscape 6, vous pouvez accéder à l´objet à partir de la syntaxe de référence de l´objet élément (par exemple, la collection document.all[] pour IE ou document.getElementById() pour IE 5 et versions ultérieures, ainsi que Netscape 6).

 
Equivalent HTML
 
<a>
 
Référence de modèle d'objet
 
[window.]document.links[i]
[window.]document.anchors[i]
[window.]document.getElementById("elementID")
 
Propriétés spécifiques à l´objet
 
charsetcoordsdataFlddataFormatAsdataSrchash
hosthostnamehrefhreflangMethodsmimeType
namenameProppathnameportprotocolprotocolLong
revsearchshapetargettexttype
urn
 
Méthodes spécifiques à l´objet

Aucune.

 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Les objets a ancres uniquement n´ont pas de gestionnaires d´événements dans Navigator jusqu´à la version 4.

 
GestionnaireNNIEDOM
onblurs.o4s.o
onclick232
ondblclick44s.o
onfocuss.o4s.o
onhelps.o4s.o
onmousedown442
onmousemove642
onmouseout342
onmouseover232
onmouseup442
charsetNN 6 IE 6 DOM 1

Lecture/écriture

Encodage de caractère du contenu du document.

 
Exemple
 
if (document.getElementById("myAnchor").charset == "csISO5427Cyrillic") {
    // process for Cyrillic charset
}
 
Valeur

Alias non sensible à la casse pris dans le registre du jeu de caractères (ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets).

 
Par défaut

Déterminée par le navigateur.

coordsNN 6 IE 6 DOM 1

Lecture/écriture

Détermine le contour d´une zone à associer à un lien spécifique ou à une action de script. Cette propriété est un élément de l´objet a, mais fait vraiment partie de l´objet area, qui hérite des propriétés de l´objet a. Les coordonnées sont spécifiées sous forme de liste dont les valeurs sont séparées par une virgule. Si les points sensibles de deux zones doivent se superposer, la première zone définie dans le code a la priorité.

 
Exemple
 
document.getElementById("mapArea2").coords = "25, 5, 50, 70";
 
Valeur

La valeur de chaque coordonnée est une longueur, mais le nombre de coordonnées et leur ordre dépendent de la forme définie par l'attribut shape qui peut être éventuellement associé à l'élément. L'attribut shape="rect" possède quatre coordonnées (gauche, haut, droite, bas); l'attribut shape="circle" possède trois coordonnées (X centre, Y centre, rayon); l'attribut shape="poly" possède deux coordonnées pour chaque point définissant la forme du polygone.

 
Par défaut

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 lien une valeur de colonne provenant d'une source de données distante au lieu d'un attribut href. L'attribut datasrc doit être également défini 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. Fonctionne uniquement avec les sources de données de fichiers textes dans IE 5/Mac.

 
Exemple
 
document.getElementById("hotlink").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("hotlink").dataFormatAs = "HTML";
 
Valeur

IE reconnaît deux valeurs possibles: 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 à insérer dans l´élément texte a est spécifié par la propriété datafld. 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. Fonctionne uniquement avec les sources de données de fichiers textes dans IE 5 pour Mac.

 
Exemple
 
document.all.hotlink.dataSrc = "#DBSRC3";
 
Valeur

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

 
Par défaut

Aucune.

hashNN 2 IE 3 DOM 1

Lecture/écriture

Fournit la partie de l'adresse URL de l'attribut href suivant le symbole # qui fait référence à l'emplacement d'une ancre dans un document. N'insérez pas le symbole # lorsque vous définissez la propriété.

 
Exemple
 
document.getElementById("myLink").hash = "section3";
document.links[2].hash = "section3";
 
Valeur

Chaîne.

 
Par défaut

Aucune.

hostNN 2 IE 3 DOM 1

Lecture/écriture

Combinaison du nom d'hôte et du port (éventuel) du serveur du document de destination pour le lien. Si le port fait explicitement partie de l'adresse URL, le nom d'hôte et le port sont séparés par le signe deux points, tout comme dans l'adresse URL. Si le numéro de port n'est pas spécifié dans une adresse URL HTTP pour Internet Explorer, le port 80 (par défaut) est automatiquement renvoyé.

 
Exemple
 
document.getElementById("myLink").host = "www.megacorp.com:80";
document.links[2].host = "www.megacorp.com:80";
 
Valeur

Chaîne du nom d'hôte pouvant être suivie par le signe deux points et un numéro de port.

 
Par défaut

Dépend du serveur.

hostnameNN 2 IE 3 DOM 1

Lecture/écriture

Nom d'hôte du serveur du document de destination (par exemple une adresse « à deux points », comprenant le nom du serveur et le domaine) pour le lien. La propriété hostname ne comporte pas le numéro de port.

 
Exemple
 
document.getElementById("myLink").hostname = "www.megacorp.com";
document.links[2].hostname = "www.megacorp.com";
 
Valeur

Chaîne du nom d'hôte (serveur et domaine).

 
Par défaut

Dépend du serveur.

hrefNN 2 IE 3 DOM 1

Lecture/écriture

Fournit l´adresse URL spécifiée par l'attribut href de l'élément.

 
Exemple
 
document.getElementById("myLink").href = "http://www.megacorp.com";
document.links[2].href = "http://www.megacorp.com";
 
Valeur

Chaîne d'une adresse URL complète ou relative.

 
Par défaut

Aucune.

hreflangNN 6 IE 6 DOM 1

Lecture/écriture

Fournit le code de langue utilisée dans le document vers lequel le lien pointe. Exige que l'attribut ou la propriété href soit également défini(e).

 
Exemple
 
document.getElementById("myLink").hreflang = "DE";
 
Valeur

Code de langue insensible à la casse.

 
Par défaut

Aucune.

MethodsNN s.o. IE 4 DOM s.o.

Lecture/écriture

Fournit un attribut comportant des informations sur le comportement de la cible d'un lien. Un navigateur pourrait utiliser ces informations pour afficher des couleurs ou des images adaptées au contenu de l'élément, en fonction de l'action effectuée par la page de destination. Il semble cependant qu´Internet Explorer ne traite pas ces informations.

 
Exemple
 
document.links[1].Methods = "post";
 
Valeur

Toute méthode HTTP valide sous forme de chaîne.

 
Par défaut

Aucune.

mimeTypeNN s.o. IE 4 DOM s.o.

Lecture seule

Renvoie en anglais le type MIME du document de destination à l'autre extrémité du lien spécifié par l'attribut href. Vous pouvez utiliser ces informations pour définir le type de curseur de souris affiché lors du passage au-dessus d'un élément. Ne confondez pas cette propriété avec le tableau navigator.mimeTypes[] et les objets mimeType individuels désignés par Netscape Navigator. Cette propriété n'est pas disponible dans Internet Explorer 4 pour Macintosh.

 
Exemple
 
if (document.getElementById("myLink").mimeType == "GIF Image") {
    ...
}
 
Valeur

Référence en anglais du type MIME sous forme de chaîne.

 
Par défaut

Aucune.

nameNN 2 IE 3 DOM 1

Lecture/écriture

Identifiant associé à un élément qui se transforme en ancre. Vous pouvez également utiliser le nom comme faisant partie de la référence d'objet.

 
Exemple
 
if (document.links[12].name == "section3") {
    ...
}
 
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.

namePropNN s.o. IE 4 DOM s.o.

Lecture seule

Renvoie uniquement le nom de fichier (au lieu de l'adresse URL complète) de l'attribut href défini pour l'élément. Non disponible dans Internet Explorer 4 pour Macintosh.

 
Exemple
 
if (document.getElementById("myLink").nameProp == "logo2.gif") {
    ...
}
 
Valeur

Chaîne.

 
Par défaut

Aucune.

pathnameNN 2 IE 3 DOM 1

Lecture/écriture

Fournit le composant « nom de chemin » de l'adresse URL affectée à l'attribut href de l'élément. Il comprend toutes les données de l'adresse URL qui suivent le dernier caractère du nom de domaine, y compris la barre oblique initiale.

 
Exemple
 
document.getElementById("myLink").pathname = "/images/logoHiRes.gif";
document.links[2].pathname = "/images/logoHiRes.gif";
 
Valeur

Chaîne.

 
Par défaut

Aucune.

portNN 2 IE 3 DOM 1

Lecture/écriture

Fournit le composant port de l'adresse URL affectée à l'attribut href de l'élément. Il se compose de tous les éléments de l'adresse URL qui suivent le signe deux points après le dernier caractère du nom du domaine. Le signe deux points ne fait pas partie de la valeur de la propriété port.

 
Exemple
 
document.getElementById("myLink").port = "80";
document.links[2].port = "80";
 
Valeur

Chaîne (valeur numérique sous forme de chaîne).

 
Par défaut

Aucune.

protocolNN 2 IE 3 DOM 1

Lecture/écriture

Fournit le composant « protocole » de l'adresse URL affectée à l'attribut href de l'élément. Il comprend tous les éléments de l'adresse URL jusqu'au premier signe deux points inclus. Quelques valeurs types: "http:", "file:", "ftp:" et "mailto:".

 
Exemple
 
document.getElementById("secureLink").protocol = "https:";
 
Valeur

Chaîne.

 
Par défaut

Aucune.

protocolLongNN s.o. IE 4 DOM s.o.

Lecture seule

Fournit une description détaillée du protocole dicté par l'adresse URL de l'attribut href ou de la propriété href. Non pris en charge par Internet Explorer 4 pour Macintosh et semble être délaissé.

 
Exemple
 
if (document.getElementById("myLink").protocolLong ==
    "HyperText Transfer Protocol") {
    // statements for treating document as server file
}
 
Valeur

Chaîne.

 
Par défaut

Aucune

relNN 6 IE 4 DOM 1

Lecture/écriture

Définit la relation qui existe entre l'élément actuel et la cible du lien. Définissant ce que l'on appelle parfois une relation de lien négative , cet attribut ne doit absolument pas être confondu avec le document cible dont l'adresse est définie par l'attribut href. Cet attribut pour l´élément a n'est pas encore utilisé dans les navigateurs courants, mais il peut être considéré comme une sorte de paramètre à activer et/ou modifier par script. Reportez-vous à la section consacrée à l´attribut rel de l´élément a dans le chapitre 8 pour un aperçu de la façon dont cette propriété risque d´être utilisée dans le futur.

 
Valeur

Types de liens standard HTML 4.0 (sous forme de chaîne unique) non sensibles à la casse, séparés par des espaces dans une liste, applicables à l'élément. Les types de liens approuvés sont les suivants:

 
alternateappendixbookmarkchaptercontents
copyrightglossaryhelpindexnext
prevsectionstartstylesheetsubsection
 
Par défaut

Aucune.

revNN s.o. IE 4 DOM 1

Lecture/écriture

Définit la relation qui existe entre l'élément actuel et la cible du lien. Egalement connu sous le nom de lien inversé. Cette propriété n'est pas encore utilisée dans les navigateurs courants, mais l'attribut peut être considéré comme une sorte de paramètre à activer et/ou modifier par script. Reportez-vous à la section consacrée à l´attribut rev de l´élément a dans le chapitre 8 pour un aperçu de la façon dont cette propriété risque d´être utilisée dans le futur.

 
Valeur

Types de liens standard HTML 4.0 (sous forme de chaîne unique) non sensibles à la casse, séparés par des espaces dans une liste, applicables à l'élément. Reportez-vous à la section consacrée à la propriété rel pour plus d'informations sur les types de liens approuvés.

 
Par défaut

Aucune.

shapeNN 6 IE 6 DOM 1

Lecture/écriture

Indique la forme d'une zone de carte image côté serveur, dont les coordonnées sont définies par l'attribut COORDS. Destinée à être utilisé par l´objet area, qui hérite des propriétés de l´objet a.

 
Exemple
 
document.getElementById("myLink").shape = "circle";
 
Valeur

Constante de forme sous forme de chaîne non sensible à la casse: default | rect | rectangle | circle | poly | polygon.

 
Par défaut

rect

targetNN 2 IE 3 DOM 1

Lecture/écriture

Fournit le nom de la fenêtre ou du cadre devant accueillir le contenu après avoir suivi un lien. Ces noms sont affectés aux cadres par l'attribut name de l'élément frame; pour les sous-fenêtres, le nom est affecté par le deuxième paramètre de la méthode window.open(). Si vous avez besoin des services d´un attribut target pour ouvrir une page à l´aide d´un lien dans une fenêtre de navigateur vide et si vous avez aussi besoin de HTML pour valider sous des DTD HTML ou XHTML strictes (reportez-vous au chapitre 1), vous pouvez omettre l´attribut target dans le code, mais vous devez affecter une valeur à la propriété target de l´élément a par script, une fois la page chargée.

 
Exemple
 
document.getElementById("homeLink").target = "_top";
document.links[3].target = "_top";
 
Valeur

Valeur du nom de fenêtre ou de cadre sous forme de chaîne, ou l'une des constantes suivantes (sous forme de chaîne): _parent | _self | _top | _blank. La valeur _parent pointe sur le jeu de cadres dont le document courant fait partie; la valeur _self pointe sur la fenêtre courante; la valeur _top pointe sur la fenêtre principale du navigateur, éliminant ainsi tous les cadres; la valeur _blank crée une nouvelle fenêtre ayant la taille par défaut.

 
Par défaut

Aucune.

textNN 4 IE s.o. DOM s.o.

Lecture seule

Renvoie le texte qui figure entre les balises de début et de fin de l´élément a. Cette propriété est antérieure au DOM W3C et ne doit être utilisée que si elle est nécessaire pour Navigator 4.

 
Valeur

Valeur de chaîne.

 
Par défaut

Aucune.

typeNN 6 IE 6 DOM 1

Lecture/écriture

Le type MIME du document de destination à l'autre extrémité du lien spécifié par l'attribut href. 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.

 
Exemple
 
if (document.getElementById("myLink").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.

urnNN s.o. IE 4 DOM s.o.

Lecture/écriture

Indique la version de nom de ressources universel (URN, Uniform Resource Name) du document de destination spécifié dans l'attribut href. Cet attribut a pour but d'offrir une prise en charge future du format URN des adresses URI; cette recommandation en cours de développement fait l'objet de discussions par l'IETF (voir RFC 2141). Bien qu'il soit pris en charge par IE, cet attribut ne remplace pas l'attribut href.

 
Exemple
 
document.getElementById("link3").urn = "http://www.megacorp.com";
 
Valeur

URN relatif ou complet sous forme de chaîne.

 
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.

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.

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

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.