SELFHTML: JavaScript / Référence objet / anchors

SELFHTML/Aides à la navigation

JavaScript/DOM

Référence objet

anchors

anchors: généralités sur l'utilisation

Propriété:

name (nom de l'ancre)
length (nombre d'ancres)
text (texte de l'ancre)
x (position horizontale de l'ancre)
y (position verticale de l'ancre)

anchors: généralités sur l'utilisation

Avec l'objet anchors, qui se trouve sous l'objet document dans la hiérarchie des objets JavaScript, vous avez accès à des ancres de liens définies dans un fichier HTML. Une ancre en HTML, c'est par exemple:
<a name="top">Ici commence la page</a>.
En JavaScript 1.0 il est possible finalement de lire le nombre d'ancres dans un fichier. En JavaScript 1.2 pourtant, d'autres propriétés ont été implémentées.

Les façons suivantes d'adresser une certaine ancre avec JavaScript existent:

Schéma 1 / exemple 1:

document.anchors[#].propri�t�

document.anchors[0].name

Schéma 2 / exemple 2:

document.anchors["nomde_lancre"].propri�t�

document.anchors["haut"].text

Explication:

Vous pouvez adresser une ancre de lien de deux façons:

avec un numéro d'index (comme dans le Schéma 1 / exemple 1)
Lors de l'utilisation de numéros index, mentionnez document.anchors suivi entre crochets, du numéro d'ordre dans le fichier de l'ancre à laquelle vous pensez. Ne perdez pas de vue que le comptage commence à 0, c'est à dire que vous adressez la première ancre avec anchors[0], la deuxième ancre avec anchors[1] etc... Pour le comptage, prévaut l'ordre dans lequel sont notées les ancres dans le fichier.
avec le nom de l'ancre comme nom d'index (comme dans le Schéma 2 / exemple 2)
Ici, vous notez comme pour l'adressage avec un numéro d'index des crochets derrière document.anchors. Dans ces crochets, notez entre guillemets le nom que vous avez mentionné pour la définition de l'ancre dans le repère d'ouverture <a>-Tag avec l'attribut name=.

Attention:

Dans l'Explorer Internet MS il n'est pas possible d'accéder à une ancre de lien avec le schéma 2 . Vous pouvez toutefois accéder à toutes les ancres et à leurs propriétés par l'objet all.

name

Sauvegarde le nom d'une ancre de lien.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title>
</head><body>
<h1><a name="Guitry">L'accroche-cœur</a></h1>
<pre>Marcel: Mais je me servirais, moi, d'un b�illon diff�rent...
qui ne vous endormirait pas, lui, je vous le jure....
Andr�e: Essayons-le...</pre>
<p><a href="javascript:alert(document.anchors[0].name)">Nom de l'ancre</a></p>

</body></html>

Explication:

Avec document.anchors[0].name vous pouvez rechercher le nom d'une ancre de lien dans un fichier HTML. L'exemple contient d'abord un texte HTML et un lien. Lorsqu'on le clique, le nom du lien est sorti avec alert().

Attention:

Actuellement, il n'est possible qu'avec Netscape 6.1 de modifier le nom d'une ancre.

length

Sauvegarde le nombre d'ancres contenues dans un fichier HTML.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title>
</head><body>
<h1><a name="haut">d�but</a></h1>
Au d�but il y avait, voyons soyons honn�tes, nous n'en savons rien.
<h2><a name="milieu">sagesse</a></h2>
Celui qui a de l'eau jusqu'au cou ne doit pas baisser la t�te.
<h2><a name="bas">fin</a></h2>
<script type="text/javascript">
<!--
 document.write("Ont �t� trouv�es: " + document.anchors.length + " ancres")
//-->
</script>
</body></html>

Explication:

Avec document.anchors.length vous pouvez rechercher le nombre d'ancres dans un fichier HTML. L'exemple contient d'abord un texte HTML avec quelques ancres et écrit à la fin le nombre d'ancres trouvées dans le fichier avec document.write().

text

Sauvegarde le texte d'une ancre.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title>
</head><body>
<h1><a name="haut">Imp�ts</a></h1>
L'homme dans sa vie sociale ne peut pas vtaiment profiter de son bien,
sans le partager avec l'�tat.
<h2><a name="milieu">� m�diter</a></h2>
L'œuvre d'un philosophe est beaucoup plus facile � br�ler qu'a r�futer.
<h2><a name="bas">Fin</a></h2>
<p><a href="javascript:alert(document.anchors['milieu'].text)">Texte de l'ancre du milieu</a></p>

</body></html>

Explication:

Avec document.anchors['milieu'].text vous pouvez rechercher le texte d'un lien entre <a> et </a>. L'exemple contient d'abord un texte HTML avec quelques ancres et sort à la fin le texte de l' d'ancre avec alert().

x

Sauvegarde la position horizontale de l'ancre à partir du bord de la fenêtre.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title>
</head><body>
<a name="haut">une ancre</a>
<p><a href="javascript:alert(document.anchors[0].x)">Position � partir de la gauche</a></p>

</body></html>

Explication:

Avec document.anchors[0].x vous pouvez rechercher la position horizontale d'une ancre dans un fichier HTML. L'exemple contient une ancre et un lien. Lorsqu'on le clique, la position de l'ancre à partir du bord gauche de la fenêtre est sortie.

y

Sauvegarde la position verticale de l'ancre à partir du bord de la fenêtre.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title>
</head><body>
<a name="haut">une ancre</a>
<p><a href="javascript:alert(document.anchors[0].y)">Position � partir du haut</a></p>

</body></html>

Explication:

Avec document.anchors[0].y vous pouvez rechercher la position verticale d'une ancre dans un fichier HTML. L'exemple contient une ancre et un lien. . Lorsqu'on le clique, la position de l'ancre à partir du bord supérieur de la fenêtre est sortie.


	applets
	style

SELFHTML/Aides à la navigation

JavaScript/DOM

Référence objet