area | NN 3 IE 4 DOM 1 | ||||||||||||||
L'objet area représente l'élément area, qui détermine la forme, les coordonnées et la destination d'une zone sensible d´une carte image côté client. Navigator et Internet Explorer considèrent l'objet area comme membre de la collection links, puisqu'un objet area se comporte essentiellement à la manière d'un lien, mais pour un segment d'image. |
|||||||||||||||
Equivalent HTML | |||||||||||||||
<area> |
|||||||||||||||
Référence de modèle d'objet | |||||||||||||||
[window.]document.links[i]
[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 | |||||||||||||||
Aucune. |
alt | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
De futurs navigateurs textuels utiliseront peut-être la propriété alt pour afficher une brève description de la signification des zones réactives (invisibles) de l'image. |
|
Exemple | |
document.getElementById("elementID").alt = "To Next Page";
|
|
Valeur | |
Chaîne de caractères quelconque entre guillemets. |
|
Par défaut | |
Aucune. |
coords | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Détermine le contour de la zone à associer à un lien spécifique ou à une action de script. 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 en pixels, 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. |
hash | NN 2 IE 3 DOM 1 |
Lecture/écriture | |
Partie de l'adresse URL de l'attribut href qui suit le symbole # et 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("mapArea2").hash = "section3"; |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Aucune. |
host | NN 2 IE 3 DOM 1 |
Lecture/écriture | |
Fournit la combinaison du nom d'hôte et du port (éventuel) du serveur du document de destination pour le lien de zone. 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 est automatiquement renvoyé par défaut. |
|
Exemple | |
document.getElementById("mapArea2").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. |
hostname | NN 2 IE 3 DOM 1 |
Lecture/écriture | |
Fournit le 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 de zone. La propriété hostname ne comporte pas le numéro de port. |
|
Exemple | |
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. |
href | NN 2 IE 3 DOM 1 |
Lecture/écriture | |
Adresse URL spécifiée par l'attribut href de l'élément. |
|
Exemple | |
document.links[2].href = "http://www.megacorp.com"; |
|
Valeur | |
Chaîne d'une adresse URL complète ou relative. |
|
Par défaut | |
Aucune. |
noHref | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Indique si un lien est associé ou non à la zone définie par les coordonnées. Lorsque la valeur de cette propriété est true, les navigateurs prenant en charge les scripts ne traitent plus l'élément comme un lien. |
|
Exemple | |
document.links[4].noHref = "true"; |
|
Valeur | |
Valeur booléenne: true | false. |
|
Par défaut | |
false |
pathname | NN 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"; |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Aucune. |
port | NN 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 de domaine. Le signe deux points ne fait pas partie de la valeur de la propriété port. |
|
Exemple | |
document.getElementById("myLink").port = "80"; |
|
Valeur | |
Chaîne (valeur numérique sous forme de chaîne). |
|
Par défaut | |
Aucune. |
protocol | NN 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. Les valeurs typiques sont "http:", "file:", "ftp:" et "mailto:". |
|
Exemple | |
document.getElementById("secureLink").protocol = "https:"; |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Aucune. |
search | NN 2 IE 3 DOM 1 |
Lecture/écriture | |
La partie codée d'une adresse URL affectée à l'attribut href qui commence par le symbole ? Un document trouvé à la suite d'une recherche peut également afficher la formule recherchée dans la propriété window.location. Cette propriété peut être modifiée à l'aide d'un script. L'adresse URL et le critère de recherche sont ainsi envoyés au serveur. Pour accomplir cette opération correctement, vous devez connaître le format des données (généralement des paires nom/valeur) attendues par le serveur. |
|
Exemple | |
document.getElementById("searchLink").search="?p=Tony+Blair&d=y&g=0&s=a&w=s&m=25"; |
|
Valeur | |
Chaîne commençant par le symbole ?. |
|
Par défaut | |
Aucune. |
shape | NN 6 IE 4 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. |
|
Exemple | |
document.getElementById("area51").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 (IE); chaîne vide mais rect implicite (Netscape 6). |
target | NN 2 IE 3 DOM 1 |
Lecture/écriture | |
Nom de la fenêtre ou du cadre qui doit accueillir du contenu à la suite d´un clic sur le lien de la zone. 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, vous pouvez omettre l´attribut target dans le code, mais vous devez affecter une valeur à la propriété target de l´élément area par script, une fois la page chargée. |
|
Exemple | |
document.getElementById("homeArea").target = "_blank"; |
|
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. |
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. |
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. |