SELFHTML/Quickbar  JavaScript  Référence objet

location
Cette page est un document avec du texte et des informations

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

Propriétés:

  hash (nom d'ancre à l'intérieur d'une URL)
  host (nom de domaine à l'intérieur d'une URL)
  hostname (nom de domaine à l'intérieur d'une URL)
  href (URL / lien à une URL)
  pathname (nom de chemin à l'intérieur d'une URL)
  port (mention du port à l'intérieur d'une URL)
  protocol (mention du protocole à l'intérieur d'une URL)
  search (paramètre à l'intérieur d'une URL)

Méthodes:

  reload() (recharger)
  replace() (écraser l'élément de l'historique)
 

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

Par l'objet location, qui se trouve dans la hiérarchie objet JavaScript sous l'objet  window, vous avez accès à l'adresse URL complète de la page WWW affichée actuellement. Vous pouvez questionner pour traitement et modifier l'adresse URL ou des parties de celle ci. Lors d'une modification, le navigateur exécute un saut à la nouvelle adresse URL, exactement comme s'il s'agissait d'un lien.

Exemples:

window.location.href = "datei2.htm";
mondomaine = location.host;

parent.frames[1].location.href = "fichier2.htm";
secondefenetre.host = "www.teamone.de";

Explication:

Vous pouvez appeler avec location les méthodes de l'objet location. Vous pouvez également noter window. devant. Étant donné qu'il s'agit là de l'adresse de la fenêtre actuelle, la mention du nom de fenêtre n'est pas absolument indispensable. Il en va autrement pour l'accès à d'autres fenêtres ou à des fenêtres frames. Dans ces cas là vous devez adresser la fenêtre correctement. Lisez pour les fenêtres supplémentaires la partie sur l'  utilisation de l'objet window et pour les fenêtres frames la partie sur l' utilisation de l'objet frame.

 

JavaScript 1.0Netscape2.0MS IE3.0Lecture/Écriture hash

Sauvegarde l'  ancre (cible du lien) à l'intérieur de l' adresse URL.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
function montre()
{ alert(window.location.hash); }
</script>
</head><body>
<a href="#a2">atteindre a2. Veuillez cliquer d'abord ici</a>
<p>
<a name="a2" href="javascript:montre()">Ici a2 - Cliquez ensuite ici</a>
</body></html>

Explication:

L'exemple définit deux liens. En cliquant sur le premier lien la cible a2 dans le fichier est atteinte. Elle représente elle-même un lien. En cliquant sur ce second lien la fonction montre() est appelée et donne le nom de l'ancre. Pensez que le signe dièse # fait partie de la valeur renvoyée par hash.
Si vous modifiez cette mention, vous actionnez un lien dans le fichier à l'ancre indiquée. Là aussi, il vous faut ajouter le signe dièse devant le nom de l'ancre.

 

JavaScript 1.0Netscape2.0MS IE3.0Lecture/Écriture host

Sauvegarde le nom de l'ordinateur serveur à l'intérieur de l'adresse URL actuelle ou d'une adresse de fenêtre spécifique.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 alert("Vous vous trouvez sur le serveur " + window.location.host);
</script>
</head><body>
</body></html>

Explication:

L'exemple donne à la lecture du fichier le nom du serveur sur lequel l'utilisateur se trouve. S'il s'agit d'un nom d'adresse comme par exemple www.teamone.de ,celle ci est sortie. S'il s'agit d'une adresse IP numérique comme par exemple 195.201.34.18, c'est celle là qui est sortie.
Vous pouvez modifier la propriété. Il est pourtant plus sûr dans ce cas de travailler avec la propriété  href.

 

JavaScript 1.0Netscape2.0MS IE3.0Lecture/Écriture hostname

Sauvegarde le nom de l'ordinateur serveur à l'intérieur de l'adresse URL actuelle ou d'une adresse de fenêtre spécifique. À la différence de  host également sous-domaines et numéros de port.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 alert("Vous vous trouvez sur le serveur " + window.location.hostname);
</script>
</head><body>
</body></html>

Explication:

L'exemple donne à la lecture du fichier le nom du serveur sur lequel se trouve l'utilisateur. S'il s'agit d'un nom d'adresse comme par exemple www.teamone.de, celle ci est sortie. S'il s'agit d'une adresse IP numérique comme par exemple 195.201.34.18, c'est celle là qui est sortie. Si par exemple un numéro de port en fait partie comme par exemple www.xy.de:5080, celui ci est également sauvegardé.
Vous pouvez modifier la propriété. Il est pourtant plus sûr dans ce cas de travailler avec la propriété  href.

 

JavaScript 1.0Netscape2.0MS IE3.0Lecture/Écriture href

Sauvegarde l'adresse URL complète de la fenêtre actuelle ou d'une adresse de fenêtre spécifique.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
function souhait()
{
 cible = window.prompt("Votre URL souhaitée:","");
 window.location.href = cible ;
}
</script>
</head><body>
<a href="javascript:souhait()">Lien souhaité</a>
</body></html>

Explication:

L'exemple contient un lien qui lorsqu'on le clique appelle la fonction souhait(). Cette fonction ouvre une boite de dialogue dans laquelle l'utilisateur peut entrer une adresse URL de son choix. La valeur entrée est enregistrée dans la variable cible. Enfin, en affectant la valeur de cible à window.location.href, un lien à cette adresse URL est exécuté.
Vous n'êtes pas obligés de noter ici une adresse URL complète. Un nom de fichier suffit, si le saut doit simplement mener à un autre fichier du projet dans le même répertoire.

 

JavaScript 1.0Netscape2.0MS IE3.0Lecture/Écriture pathname

Sauvegarde le nom de chemin dans l'adresse URL complète de la fenêtre actuelle ou d'une adresse de fenêtre spécifique. Pour une utilisation locale (sans protocole HTTP) l'adresse locale complète est sauvegardée.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 alert("Chemin actuel: " + window.location.pathname);
</script>
</head><body>
</body></html>

Explication:

L'exemple sort à la lecture du fichier dans une boite de dialogue le nom de chemin de l'adresse URL du fichier.
Vous pouvez modifier la propriété. Il est pourtant plus sûr dans ce cas de travailler avec la propriété  href.

 

JavaScript 1.0Netscape2.0Lecture/Écriture port

Sauvegarde le port dans l'adresse URL complète de la fenêtre actuelle ou d'une adresse de fenêtre spécifique. Une adresse avec des ports est par exemple http://www.xy.de:5080/ - la propriété port ne contient une valeur que si une mention de port figure réellement dans l'adresse URL actuelle

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
if(window.location.port != "")
 alert(window.location.port);
</script>
</head><body>
</body></html>

Explication:

L'exemple recherche à la lecture du fichier s'il y a une mention de port. Si oui, elle est sortie dans une boite de dialogue.
Vous pouvez modifier la propriété. Cela peut toutefois entraîner des messages d'erreur si le serveur ne connaît pas le port. Le "port normal" pour des adresses HTTP est 80.

 

JavaScript 1.0Netscape2.0Lecture/Écriture protocol

Sauvegarde le protocole utilisé dans l'adresse URL complète de la fenêtre actuelle ou d'une adresse de fenêtre spécifique. Pour des adresse HTTP http: est sauvegardé. Pour une utilisation locale (sans protocole HTTP) file: est sauvegardé.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 alert(window.location.protocol);
</script>
</head><body>
</body></html>

Explication:

L'exemple donne à la lecture du fichier le protocole appartenant à l'adresse URL actuelle.
Vous pouvez modifier la propriété. Cela peut toutefois entraîner des messages d'erreur si le protocole mentionné n'est pas supporté avec la même adresse.

 

JavaScript 1.0Netscape2.0Lecture/Écriture search

Sauvegarde une chaîne de caractères qui, séparée par un point d'interrogation, est ajoutée à l'adresse URL actuelle, par exemple:
http://www.xy.de/index.htm?Browser=Netscape.
Dans ce cas, la propriété contient la valeur ?Browser=Netscape.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
if(window.location.search != "")
 alert(window.location.search);
</script>
</head><body>
</body></html>

Explication:

L'exemple recherche à la lecture du fichier si une mention supplémentaire avec un point d'interrogation existe dans l'adresse URL. Si oui, elle est sortie dans une boite de dialogue.
Vous pouvez (ne fonctionne qu'avec Netscape) appeler un autre fichier avec  href et accrocher à l'adresse URL, en les séparant par un point d'interrogation, des informations, par exemple du genre de celles que vous avez recherchées avec JavaScript - entrées de formulaires ou similaires. Le fichier appelé peut lire ce genre d'informations et les traiter. De cette façon la "communication" entre fichiers est possible.

 

JavaScript 1.1Netscape3.0MS IE4.0 reload()

Recharge une page WWW. A le même effet que le bouton recharger du navigateur.

Exemple:

<a href="javascript:location.reload()">Recharger</a>

Explication:

L'exemple définit un lien qui lorsqu'on le clique recharge à nouveau la page actuelle.

 

JavaScript 1.1Netscape3.0MS IE4.0 replace()

Charge une autre adresse URL sur l'élément actuel dans la liste des pages visitées (historique). A ainsi un effet semblable à celui de la propriété  href. La différence réside en ce que l'adresse URL actuelle ne figure ensuite plus dans la liste des pages visitées.

Exemple:

<a href="javascript:location.replace('fichier2.htm')">fichier 2</a>

Explication:

L'exemple définit un lien qui lorsqu'on le clique charge fichier2.htm. Ce faisant, l'adresse URL actuelle disparaît de la liste des pages visitées.

après: Array
avant: history
 

SELFHTML/Quickbar  JavaScript  Référence objet

© 1998 Stefan Münz / © 2001 Traduction  Serge François, 13405@free.fr