link | NN 6 IE 4 DOM 1 | ||||||||||||||
L'objet link représente l'élément link. Notez que bon nombre des propriétés répertoriées ci-dessous sont indisponibles pour les scripts d'objet, sauf si leurs attributs ont été initialement définis dans la balise HTML. De plus, du fait que les attributs de l´élément jouent le rôle de directives pendant le chargement du document, l´affectation de nouvelles valeurs aux propriétés correspondantes n´a généralement aucun effet (bien que les propriétés soient en lecture/écriture). Ceci inclut: href, rel, rev et type. La propriété media n´est pas disponible dans la version Macintosh de Microsoft Internet Explorer 4. Rappel: la propriété disabled (décrite parmi les propriétés partagées précédemment dans ce chapitre) permet à tous les navigateurs la prenant en charge d´activer et désactiver une feuille de style accessible par lien. |
|||||||||||||||
Equivalent HTML | |||||||||||||||
<link> |
|||||||||||||||
Référence de modèle d'objet | |||||||||||||||
[window.]document.getElementById("elementID")
|
|||||||||||||||
Propriétés spécifiques à l´objet | |||||||||||||||
|
|||||||||||||||
Méthodes spécifiques à l´objet | |||||||||||||||
Aucune. |
|||||||||||||||
Propriétés de gestionnaire d´événements spécifiques à l´objet | |||||||||||||||
|
charset | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Définit le jeu de caractères utilisé pour l'encodage du document sur lequel le lien pointe. |
|
Exemple | |
var charCoding = document.getElementById("myLink").charset; |
|
Valeur | |
Alias insensible à la casse pris dans le registre du jeu de caractères (ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets). |
|
Par défaut | |
Aucune. |
href | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Fournit l´adresse URL spécifiée par l'attribut href de l'élément. Dans IE pour Windows, vous pouvez affecter une nouvelle URL à cette propriété pour effectuer le chargement dans une autre feuille de style après coup. |
|
Exemple | |
document.getElementById("styleLink").href = "altStyles.css"; |
|
Valeur | |
Chaîne d'une adresse URL complète ou relative. |
|
Par défaut | |
Aucune. |
hreflang | NN 6 IE 6 DOM 1 |
Lecture/écriture | |
Fournit la langue utilisée dans le document sur lequel le lien pointe. Exige que l'attribut ou la propriété href soit également défini. |
|
Exemple | |
document.getElementById("myLink").hreflang = "DE"; |
|
Valeur | |
Code de langue insensible à la casse. |
|
Par défaut | |
Aucune. |
media | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Définit le périphérique de sortie prévu pour le contenu du document de destination indiqué par l'attribut href. La propriété media sera particulièrement utile le jour où les navigateurs seront capables d'adapter le contenu en fonction du type de périphérique (ordinateur de poche, synthétiseur vocal, téléviseur, etc.) Cette propriété n'est pas disponible dans Internet Explorer 4 pour Macintosh. |
|
Exemple | |
if (document.getElementById("link3").media == "print") { // process for print output } |
|
Valeur | |
L'une des constantes suivantes (sous forme de chaîne): all | print | screen. |
|
Par défaut | |
all |
rel | NN 6 IE 4 DOM 1 | |||||||||||||||
Lecture/écriture | ||||||||||||||||
Définit la relation qui existe entre l'élément courant et l´élément externe sur lequel le lien pointe. Définissant ce que l'on appelle parfois une relation de lien négative, cet attribut ne doit pas être confondu avec le document cible dont l'adresse est définie par l'attribut href. Cette propriété n'est pas entièrement 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 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. |
||||||||||||||||
Exemple | ||||||||||||||||
if (document.getElementById("link3").rel == "alternate stylesheet") { // process for alternate style sheet } |
||||||||||||||||
Valeur | ||||||||||||||||
Types de liens standard HTML 4 (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: |
||||||||||||||||
|
||||||||||||||||
Par défaut | ||||||||||||||||
Aucune. |
rev | NN 6 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 entièrement 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 (sous forme de chaîne unique) non sensibles à la casse, séparés par des espaces dans une liste, applicables à l'élément. Voir la section consacrée à la propriété rel pour plus d'informations sur les types de liens approuvés. |
|
Par défaut | |
Aucune. |
sheet | NN 6 IE s.o DOM 1 |
Lecture seule | |
Renvoie une référence à l´objet styleSheet (objet CSSStyleSheet dans la terminologie du DOM W3C) accessible par lien dans le document courant lorsqu´une feuille de style est spécifiée comme cible de l´élément de lien. IE pour Windows fournit une propriété similaire: styleSheet. |
|
Exemple | |
var extSS = document.getElementById("link3").sheet; |
|
Valeur | |
Référence de l'objet styleSheet. |
|
Par défaut | |
Aucune. |
styleSheet | NN s.o. IE 5 (Win) DOM s.o. |
Lecture seule | |
Cette propriété, qui ne fait pas partie des normes, renvoie une référence à l´objet styleSheet accessible par lien dans le document courant lorsqu´une feuille de style est spécifiée comme cible de l´élément de lien. Netscape 6 fournit une propriété similaire: sheet. |
|
Exemple | |
var extSS = document.getElementById("link3").styleSheet; |
|
Valeur | |
Référence de l'objet styleSheet. |
|
Par défaut | |
Aucune. |
target | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Indique le nom de la fenêtre ou du cadre qui recevra le contenu accessible avec le lien. La valeur par défaut (équivalent de _self) est le paramètre adéquat pour les feuilles de style accessibles par lien. |
|
Exemple | |
document.getElementById("link4").target = "frame2"; |
|
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. |
|
Par défaut | |
Aucune. |
type | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Indique une déclaration d'informations de type MIME concernant les données chargées à partir d'une source externe. Par exemple, une feuille de style externe pourrait être text/css. Ces informations sont généralement définies dans l'attribut type de la balise de l'élément. |
|
Exemple | |
if (document.getElementById("myStyle").type == "text/css") { ... } |
|
Valeur | |
Chaîne de type MIME. |
|
Par défaut | |
Aucune. |
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. |
disabled | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Détermine si l'élément est disponible pour une action interactive de l'utilisateur. S'il est défini sur la valeur true , l'utilisateur ne peut pas activer ni modifier cet élément, qui apparaît généralement en grisé sur cette page. Cette propriété est disponible pour tous les objets éléments dans IE 5.5 pour Windows et versions ultérieures. Pour IE 4 et IE 5, elle ne s'applique qu'aux contrôles de formulaire, alors que Netscape 6 et versions ultérieures reconnaissent cette propriété pour les contrôles de formulaire et l'objet élément style . La paire désactivée nom / valeur d'un contrôle de formulaire n'est pas transmise avec le formulaire. |
|
Exemple | |
document.getElementById("myButton").disabled = true; |
|
Valeur | |
Valeur booléenne: true | false . |
|
Par défaut | |
false |