location | NN 2 IE 3 DOM s.o. | |||||||
Chaque fenêtre ou cadre contient un objet location. Cet objet stocke toutes les informations sur l'adresse URL du document en cours de chargement dans la fenêtre ou le cadre. En affectant une nouvelle adresse URL à la propriété href de l'objet location, vous indiquez au navigateur qu'il doit charger une nouvelle page dans cette fenêtre ou ce cadre. Voici la principale méthode pour charger une nouvelle page par script: location.href = "newPage.html"; |
||||||||
Pour charger un nouveau document dans un autre cadre, un script de cadre peut faire référence à l'objet location contenu dans cet autre cadre: parent.otherFrameName.location.href = "newPage.html"; |
||||||||
Pour des raisons de sécurité, un script de cadre ne peut pas accéder aux informations de l'objet location d'un autre cadre si le document présent dans ce dernier ne provient pas du même domaine (et du même serveur, à moins que les propriétés document.domain des deux documents correspondent) que le document du script en question. De cette façon, le script ne peut pas surveiller la navigation, à partir d'un autre cadre, vers des sites Web externes. Dans Navigator 4 et les versions ultérieures, vous pouvez utiliser des scripts signés pour contourner ces restrictions de sécurité, mais l'utilisateur doit toujours donner son autorisation pour permettre à un script d'accéder aux informations relatives à l'objet location, situées en dehors du domaine du script. |
||||||||
En tant qu´objet ayant trait aux fenêtres, l´objet location ne fait pas partie des spécifications du DOM W3C DOM niveau 1 ou 2 (les fenêtres seront donc à traiter dans les versions futures). Mais l´objet location et ses propriétés sont bien enracinées dans la création de scripts et devrait être pris en charge pendant encore longtemps. |
||||||||
Référence de modèle d'objet | ||||||||
[windowRef.]location
|
||||||||
Propriétés spécifiques à l´objet | ||||||||
|
||||||||
Méthodes spécifiques à l´objet | ||||||||
|
||||||||
Propriétés de gestionnaire d´événements spécifiques à l´objet | ||||||||
Aucune. |
hash | NN 2 IE 3 DOM s.o. |
Lecture/écriture | |
Indique la partie de l'adresse URL suivant le symbole #, qui désigne l'emplacement d'une ancre dans un document. Cette propriété ne contient de données que si l'utilisateur a volontairement cliqué sur une ancre, au lieu de se déplacer vers celle-ci. N'insérez pas le symbole # lorsque vous définissez la propriété. |
|
Exemple | |
location.hash = "section3"; |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Aucune. |
host | NN 2 IE 3 DOM s.o. |
Lecture/écriture | |
Fournit la combinaison du nom d'hôte et du port du serveur (s'il existe) qui héberge le document courant. 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. |
|
Exemple | |
if (location.host == "www.megacorp.com:80") { ... } |
|
Valeur | |
Chaîne du nom d'hôte, éventuellement suivie par deux points et le numéro du port. |
|
Par défaut | |
Dépend du serveur. |
hostname | NN 2 IE 3 DOM s.o. |
Lecture/écriture | |
Fournit la combinaison du nom d'hôte du serveur (par exemple une adresse « à deux points » comprenant le nom du serveur et le domaine) qui héberge le document courant. La propriété hostname ne comporte pas le numéro de port. |
|
Exemple | |
if (location.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 s.o. |
Lecture/écriture | |
Fournit l´adresse URL complète du document chargé dans la fenêtre ou le cadre. En affectant une adresse URL à cette propriété, vous créez un script indiquant comment naviguer pour charger un nouveau document dans la fenêtre ou le cadre (pour ce faire, Internet Explorer permet également d'utiliser la méthode window.navigate()). |
|
Exemple | |
location.href = "http://www.megacorp.com"; |
|
Valeur | |
Chaîne d'une adresse URL complète ou relative. |
|
Par défaut | |
Aucune. |
pathname | NN 2 IE 3 DOM s.o. |
Lecture/écriture | |
Fournit le composant de nom de chemin de l'adresse URL. 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 | |
location.pathname = "/images/logoHiRes.gif"; |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Aucune. |
port | NN 2 IE 3 DOM s.o. |
Lecture/écriture | |
Fournit le composant de port de l'adresse URL, s'il existe. 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 | |
location.port = "80"; |
|
Valeur | |
Chaîne (valeur numérique sous forme de chaîne). |
|
Par défaut | |
Aucune. |
protocol | NN 2 IE 3 DOM s.o. |
Lecture/écriture | |
Fournit le composant du protocole de l'adresse URL. 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 | |
if (location.protocol == "file:") { // statements for treating document as local file } |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Aucune. |
search | NN 2 IE 3 DOM s.o. |
Lecture/écriture | |
Fournit la partie codée d'une adresse URL qui commence par le signe ?. 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. Vous pouvez aussi transmettre des chaînes de données entre plusieurs pages en ajoutant une chaîne de recherche à l´URL de la page suivante. Bien que l´ajout de chaîne de recherche n´affecte pas la récupération de la page, la chaîne arrive avec la nouvelle page dans l´objet location de la nouvelle page. Un script dans la nouvelle page peut lire et analyser la propriété location.search pour placer les valeurs transmises dans des variables que les scripts de la page peuvent utiliser pour le traitement. |
|
Exemple | |
location.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. |
assign() | NN 2 IE 3 DOM s.o. |
assign("adresse_URL") | |
A l'origine, cette méthode était censée être masquée à la vue des auteurs de script, mais elle est toujours disponible pour le moment. Elle produit le même effet que lorsque vous affectez une adresse URL à la propriété location.href. La méthode assign() est mentionnée ici à titre d'informations et ne devrait pas être utilisée. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Aucune. |
reload() | NN 3 IE 4 DOM s.o. |
reload([inconditionnel]) | |
Recharge complètement le document associé à l'objet location. Lors de cette opération, les valeurs par défaut des éléments de formulaires sont rétablies (pour un rechargement partiel, utilisez history.go(0)). Par défaut, la méthode reload() exécute une action get conditionnelle; le fichier est dès lors récupéré dans la mémoire cache du navigateur s'il s'y trouve encore (et si la mémoire cache est activée). Pour forcer un rechargement depuis le serveur, exécutez une action get inconditionnelle en ajoutant le paramètre booléen true. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Aucune. |
replace() | NN 3 IE 4 DOM s.o. |
replace("adresse_URL") | |
Charge un nouveau document dans la fenêtre de référence et remplace l'entrée du document dans la liste d'historique du navigateur par l'entrée du nouveau document. De cette façon, les pages intermédiaires que vous ne souhaitez pas garder dans l'historique (afin que le bouton Précédente n'y revienne plus) peuvent être supprimées de l´historique et remplacées par l'entrée du nouveau document chargé. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Aucune. |