From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/location/assign/index.md | 68 ++++------- files/fr/web/api/location/index.md | 183 +++++++++++++---------------- files/fr/web/api/location/reload/index.md | 38 +++--- files/fr/web/api/location/replace/index.md | 87 ++++++-------- 4 files changed, 165 insertions(+), 211 deletions(-) (limited to 'files/fr/web/api/location') diff --git a/files/fr/web/api/location/assign/index.md b/files/fr/web/api/location/assign/index.md index 3e0476b3be..e12848af11 100644 --- a/files/fr/web/api/location/assign/index.md +++ b/files/fr/web/api/location/assign/index.md @@ -10,62 +10,42 @@ tags: - WebAPI translation_of: Web/API/Location/assign --- -

{{ APIRef("Location") }}

+{{ APIRef("Location") }} -

La méthode Location.assign() charge et affiche dans la fenêtre le document situé à l'URL spécifiée.

+La méthode **`Location.assign()`** charge et affiche dans la fenêtre le document situé à l'URL spécifiée. -

Si l'action est impossible à cause d'une violation de sécurité, une {{domxref("DOMException")}} de type SECURITY_ERROR est lancée. Cela se produit si l'origine du script appelant est différente de l'origine de la page initialement désignée par l'objet {{domxref("Location")}}, principalement quand le script est hébergé sur un autre domaine.

+Si l'action est impossible à cause d'une violation de sécurité, une {{domxref("DOMException")}} de type `SECURITY_ERROR` est lancée. Cela se produit si l'origine du script appelant est différente de l'origine de la page initialement désignée par l'objet {{domxref("Location")}}, principalement quand le script est hébergé sur un autre domaine. -

Si l'URL spécifiée n'est pas valide, une {{domxref("DOMException")}} de type SYNTAX_ERROR est lancée.

+Si l'URL spécifiée n'est pas valide, une {{domxref("DOMException")}} de type `SYNTAX_ERROR` est lancée. -

Syntaxe

+## Syntaxe -
object.assign(url);
-
+ object.assign(url); -

Paramètres

+### Paramètres -
-
url
-
Une {{domxref("DOMString")}} contenant l'URL de la page vers laquelle naviguer.
-
+- _url_ + - : Une {{domxref("DOMString")}} contenant l'URL de la page vers laquelle naviguer. -

Examples

+## Examples -
// Navigue vers l'article Location.reload
-document.location.assign('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');
+```js +// Navigue vers l'article Location.reload +document.location.assign('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload'); +``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{SpecName('HTML WHATWG', "history.html#dom-location-assign", "Location.assign()")}}{{Spec2('HTML WHATWG')}}Pas de différence avec {{SpecName("HTML5 W3C")}}.
{{SpecName('HTML5 W3C', "browsers.html#dom-location-assign", "Location.assign()")}}{{Spec2('HTML5 W3C')}}Définition initiale.
+| Spécification | Statut | Commentaires | +| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------- | +| {{SpecName('HTML WHATWG', "history.html#dom-location-assign", "Location.assign()")}} | {{Spec2('HTML WHATWG')}} | Pas de différence avec {{SpecName("HTML5 W3C")}}. | +| {{SpecName('HTML5 W3C', "browsers.html#dom-location-assign", "Location.assign()")}} | {{Spec2('HTML5 W3C')}} | Définition initiale. | -

Compatibilité

+## Compatibilité +{{Compat("api.Location.assign")}} +## Voir aussi -

{{Compat("api.Location.assign")}}

- -

Voir aussi

- - +- L'interface {{domxref("Location")}} à laquelle appartient cette méthode. +- Méthodes similaires : {{domxref("Location.replace()")}} et {{domxref("Location.reload()")}}. diff --git a/files/fr/web/api/location/index.md b/files/fr/web/api/location/index.md index dc4e6e6a36..3766646973 100644 --- a/files/fr/web/api/location/index.md +++ b/files/fr/web/api/location/index.md @@ -10,19 +10,22 @@ tags: - Reference translation_of: Web/API/Location --- -
{{APIRef("HTML DOM")}}
+{{APIRef("HTML DOM")}} -

L'interface Location représente l'emplacement de l'objet auquel elle est liée. Les changements effectués dessus sont reflétés sur l'objet lié. Les deux interfaces {{domxref("Document")}} et {{domxref("Window")}} sont liées à une Location, accessible via {{domxref("Document.location")}} et {{domxref("Window.location")}} respectivement.

+L'interface **`Location`** représente l'emplacement de l'objet auquel elle est liée. Les changements effectués dessus sont reflétés sur l'objet lié. Les deux interfaces {{domxref("Document")}} et {{domxref("Window")}} sont liées à une `Location`, accessible via {{domxref("Document.location")}} et {{domxref("Window.location")}} respectivement. -

Anatomie d'une Location

+## Anatomie d'une Location -

HTML

+### HTML -
<span id="href" title="href"><span id="protocol" title="protocol">http:</span>//<span id="host" title="host"><span id="hostname" title="hostname">example.org</span>:<span id="port" title="port">8888</span></span><span id="pathname" title="pathname">/foo/bar</span><span id="search" title="search">?q=baz</span><span id="hash" title="hash">#bang</span></span>
+```html +http://example.org:8888/foo/bar?q=baz#bang +``` -

CSS

+### CSS -
html, body {height:100%;}
+```css
+html, body {height:100%;}
 html {display:table; width:100%;}
 body {display:table-cell; text-align:center; vertical-align:middle; font-family:georgia; font-size:230%; line-height:1em; white-space:nowrap;}
 
@@ -36,11 +39,13 @@ body {display:table-cell; text-align:center; vertical-align:middle; font-family:
 [title] [title] [title]:before {margin-top:3em;}
 
 [title]:hover,
-:target {position:relative; z-index:1; outline:50em solid rgba(255,255,255,.8);}
+:target {position:relative; z-index:1; outline:50em solid rgba(255,255,255,.8);} +``` -

JavaScript

+### JavaScript -
[].forEach.call(document.querySelectorAll('[title][id]'), function (node) {
+```js
+[].forEach.call(document.querySelectorAll('[title][id]'), function (node) {
   node.addEventListener("click", function(e) {
     e.preventDefault();
     e.stopPropagation();
@@ -53,59 +58,57 @@ body {display:table-cell; text-align:center; vertical-align:middle; font-family:
     e.stopPropagation();
     window.location.hash = '';
   });
-});
- -

Result

- -

{{EmbedLiveSample('Anatomy_Of_Location')}}

- -

Propriétés

- -

L'interface Location n'hérite d'aucune propriété, mais implémente celles de {{domxref("URLUtils")}}.

- -
-
{{domxref("Location.href")}}
-
Une {{domxref("DOMString")}} contenant l'URL entière.
-
{{domxref("Location.protocol")}}
-
Une {{domxref("DOMString")}} contenant le schéma de protocole de l'URL, incluant le ':' final.
-
{{domxref("Location.host")}}
-
Une {{domxref("DOMString")}} contenant l'hôte, c'est-à-dire le domaine, un ':', et le numéro de port de l'URL.
-
{{domxref("Location.hostname")}}
-
Une {{domxref("DOMString")}} contenant le domaine de l'URL.
-
{{domxref("Location.port")}}
-
Une {{domxref("DOMString")}} contenant le numéro de port de l'URL.
-
{{domxref("Location.pathname")}}
-
Une {{domxref("DOMString")}} contenant un '/' initial suivi du chemin de l'URL.
-
{{domxref("Location.search")}}
-
Une {{domxref("DOMString")}} contenant un '?' suivi des paramètres de l'URL. Les navigateurs moderne fournissent URLSearchParams et URL.searchParams pour faciliter l'analyse des paramètres de la chaîne de requête (querystring).
-
{{domxref("Location.hash")}}
-
Une {{domxref("DOMString")}} contenant un '#' suivi de l'identifiant de fragment de l'URL.
-
{{domxref("Location.username")}} {{Obsolete_Inline}}
-
Une {{domxref("DOMString")}} contenant le nom d'utilisateur spécifié avant le nom de domaine.
-
{{domxref("Location.password")}} {{Obsolete_Inline}}
-
Une {{domxref("DOMString")}} contenant le mot de passe spécifié avant le nom de domaine.
-
{{domxref("Location.origin")}} {{readOnlyInline}}
-
Retourne une {{domxref("DOMString")}} contenant la forme canonique de l'origine de la location.
-
- -

Méthodes

- -

L'interface Location n'hérite d'aucune méthode, mais implémente celles de {{domxref("URLUtils")}}.

- -
-
{{domxref("Location.assign()")}}
-
Charge la ressource située à l'URL passée en paramètre.
-
{{domxref("Location.reload()")}}
-
Recharge la ressource depuis l'URL actuelle. Son unique paramètre facultatif est un Boolean, qui, s'il est true, implique que la page est toujours rechargée depuis le serveur. Si ce paramètre est false ou non spécifié, le navigateur peut éventuellement recharger la page depuis son cache.
-
{{domxref("Location.replace()")}}
-
Remplace la ressource actuelle par celle à l'URL passée en paramètre. la différence avec la méthode assign() est que, après avoir utilisé replace(), la page actuelle ne sera pas enregistrée dans l'historique de session {{domxref("History")}}, ce qui signifie que l'utilisateur ne pourra pas utiliser le bouton précédent pour y revenir.
-
{{domxref("Location.toString()")}}
-
Retourne une {{domxref("DOMString")}} contenant l'URL entière. C'est un synonyme de {{domxref("URLUtils.href")}}, sauf que toString() ne peut être utilisée pour modifier la valeur.
-
- -

Exemples

- -
// Crée un élèment ancre et utilise la propriété href dans le but de cet exemple
+});
+```
+
+### Result
+
+{{EmbedLiveSample('Anatomy_Of_Location')}}
+
+## Propriétés
+
+_L'interface `Location` n'hérite d'aucune propriété, mais implémente celles de {{domxref("URLUtils")}}._
+
+- {{domxref("Location.href")}}
+  - : Une {{domxref("DOMString")}} contenant l'URL entière.
+- {{domxref("Location.protocol")}}
+  - : Une {{domxref("DOMString")}} contenant le schéma de protocole de l'URL, incluant le `':'` final.
+- {{domxref("Location.host")}}
+  - : Une {{domxref("DOMString")}} contenant l'hôte, c'est-à-dire le _domaine_, un `':'`, et le _numéro de port_ de l'URL.
+- {{domxref("Location.hostname")}}
+  - : Une {{domxref("DOMString")}} contenant le domaine de l'URL.
+- {{domxref("Location.port")}}
+  - : Une {{domxref("DOMString")}} contenant le numéro de port de l'URL.
+- {{domxref("Location.pathname")}}
+  - : Une {{domxref("DOMString")}} contenant un `'/'` initial suivi du chemin de l'URL.
+- {{domxref("Location.search")}}
+  - : Une {{domxref("DOMString")}} contenant un `'?'` suivi des paramètres de l'URL. Les navigateurs moderne fournissent [URLSearchParams](/en-US/docs/Web/API/URLSearchParams/get#Example) et [URL.searchParams](/en-US/docs/Web/API/URL/searchParams#Example) pour faciliter l'analyse des paramètres de la chaîne de requête (querystring).
+- {{domxref("Location.hash")}}
+  - : Une {{domxref("DOMString")}} contenant un `'#'` suivi de _l'identifiant de fragment_ de l'URL.
+- {{domxref("Location.username")}} {{Obsolete_Inline}}
+  - : Une {{domxref("DOMString")}} contenant le nom d'utilisateur spécifié avant le nom de domaine.
+- {{domxref("Location.password")}} {{Obsolete_Inline}}
+  - : Une {{domxref("DOMString")}} contenant le mot de passe spécifié avant le nom de domaine.
+- {{domxref("Location.origin")}} {{readOnlyInline}}
+  - : Retourne une {{domxref("DOMString")}} contenant la forme canonique de l'origine de la location.
+
+## Méthodes
+
+_L'interface `Location` n'hérite d'aucune méthode, mais implémente celles de {{domxref("URLUtils")}}._
+
+- {{domxref("Location.assign()")}}
+  - : Charge la ressource située à l'URL passée en paramètre.
+- {{domxref("Location.reload()")}}
+  - : Recharge la ressource depuis l'URL actuelle. Son unique paramètre facultatif est un [Boolean](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Boolean), qui, s'il est `true`, implique que la page est toujours rechargée depuis le serveur. Si ce paramètre est `false` ou non spécifié, le navigateur peut éventuellement recharger la page depuis son cache.
+- {{domxref("Location.replace()")}}
+  - : Remplace la ressource actuelle par celle à l'URL passée en paramètre. la différence avec la méthode `assign()` est que, après avoir utilisé `replace()`, la page actuelle ne sera pas enregistrée dans l'historique de session {{domxref("History")}}, ce qui signifie que l'utilisateur ne pourra pas utiliser le bouton _précédent_ pour y revenir.
+- {{domxref("Location.toString()")}}
+  - : Retourne une {{domxref("DOMString")}} contenant l'URL entière. C'est un synonyme de {{domxref("URLUtils.href")}}, sauf que `toString()` ne peut être utilisée pour modifier la valeur.
+
+## Exemples
+
+```js
+// Crée un élèment ancre et utilise la propriété href dans le but de cet exemple
 // Une alternative plus correcte est de naviguer vers l'URL et d'utiliser document.location ou window.location
 var url = document.createElement('a');
 url.href = 'https://developer.mozilla.org:8080/en-US/search?q=URL#search-results-close-container';
@@ -117,39 +120,21 @@ console.log(url.port);      // 8080
 console.log(url.pathname);  // /en-US/search
 console.log(url.search);    // ?q=URL
 console.log(url.hash);      // #search-results-close-container
-console.log(url.origin);    // https://developer.mozilla.org:8080
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{SpecName('HTML WHATWG', "history.html#the-location-interface", "Location")}}{{Spec2('HTML WHATWG')}}Pas de différence avec {{SpecName("HTML5 W3C")}}.
{{SpecName('HTML5 W3C', "browsers.html#the-location-interface", "Location")}}{{Spec2('HTML5 W3C')}}Définition initiale.
- -

Compatibilité

- - - -

{{Compat("api.Location")}}

- -

Voir aussi

- - +console.log(url.origin); // https://developer.mozilla.org:8080 +``` + +## Spécifications + +| Spécification | Statut | Commentaires | +| -------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------- | +| {{SpecName('HTML WHATWG', "history.html#the-location-interface", "Location")}} | {{Spec2('HTML WHATWG')}} | Pas de différence avec {{SpecName("HTML5 W3C")}}. | +| {{SpecName('HTML5 W3C', "browsers.html#the-location-interface", "Location")}} | {{Spec2('HTML5 W3C')}} | Définition initiale. | + +## Compatibilité + +{{Compat("api.Location")}} + +## Voir aussi + +- Deux méthodes qui créent un objet `location` : {{domxref("Window.location")}} et {{domxref("Document.location")}}. +- Interfaces liées aux URL: {{domxref("URL")}}, {{domxref("URLSearchParams")}} et {{domxref("HTMLHyperlinkElementUtils")}}. diff --git a/files/fr/web/api/location/reload/index.md b/files/fr/web/api/location/reload/index.md index 76d94b1efd..2b38ab6b28 100644 --- a/files/fr/web/api/location/reload/index.md +++ b/files/fr/web/api/location/reload/index.md @@ -4,39 +4,37 @@ slug: Web/API/Location/reload translation_of: Web/API/Location/reload browser-compat: api.Location.reload --- -
{{ APIRef("HTML DOM") }}
+{{ APIRef("HTML DOM") }} -

La méthode Location.reload() recharge la ressource depuis l'URL actuelle.

+La méthode **`Location.reload()`** recharge la ressource depuis l'URL actuelle. -

Le rechargement peut être bloqué avec une exception DOMException SECURITY_ERROR. Cela se produit si l'origine du script qui invoque location.reload() est différente de l'origine de la page qui possède l'objet Location. Voir les règles sur l'origine pour plus d'informations.

+Le rechargement peut être bloqué avec une exception [`DOMException`](/fr/docs/Web/API/DOMException) `SECURITY_ERROR`. Cela se produit si [l'origine](/fr/docs/Glossary/Origin) du script qui invoque `location.reload()` est différente de l'origine de la page qui possède l'objet [`Location`](/fr/docs/Web/API/Location). Voir [les règles sur l'origine](/fr/docs/Web/Security/Same-origin_policy) pour plus d'informations. -

Syntaxe

+## Syntaxe -
+```js
 location.reload();
-
+``` -

location.reload() n'a pas de paramètre

+## location.reload() n'a pas de paramètre -

Firefox prend en charge un paramètre booléen non-standard forceGet pour la méthode location.reload(), qui permet à Firefox de passer outre le cache et d'effectuer un rafraîchissement forcé du document. Toutefois, pour tous les autres navigateurs, tout argument utilisé en appelant location.reload() sera ignoré et n'aura aucun effet.

+Firefox prend en charge un paramètre booléen non-standard [`forceGet`](https://searchfox.org/mozilla-central/source/dom/base/Location.cpp#551) pour la méthode `location.reload()`, qui permet à Firefox de passer outre le cache et d'effectuer un rafraîchissement forcé du document. Toutefois, pour tous les autres navigateurs, tout argument utilisé en appelant `location.reload()` sera ignoré et n'aura aucun effet. -

Il est toutefois possible que vous rencontriez des occurrences de location.reload(true) dans du code existant basé sur l'hypothèse que ce rafraîchissement forcé aurait lieu dans tous les navigateurs. Une recherche GitHub "location.reload(true)" renvoie plusieurs centaines de milliers de résultats.

+Il est toutefois possible que vous rencontriez des occurrences de `location.reload(true)` dans du code existant basé sur l'hypothèse que ce rafraîchissement forcé aurait lieu dans tous les navigateurs. Une recherche GitHub "`location.reload(true)`" renvoie [plusieurs centaines de milliers de résultats](https://github.com/search?q=%22location.reload%28true%29%22&type=code). -

Historiquement, une version de Netscape Navigator a introduit la prise en charge de cet argument et cela s'est retrouvé dans Firefox. À un moment, le groupe de travail du W3C sur les API Web a ouvert le sujet pour étudier son ajout à la spécification pour location.reload(). Toutefois, il n'a jamais été ajouté formellement.

+Historiquement, une version de Netscape Navigator a introduit la prise en charge de cet argument et cela s'est retrouvé dans Firefox. À un moment, le groupe de travail du W3C sur les API Web [a ouvert le sujet](https://www.w3.org/2005/06/tracker/webapi/issues/69) pour étudier son ajout à la spécification pour `location.reload()`. Toutefois, il n'a jamais été ajouté formellement. -

En résumé, ce paramètre booléen ne fait pas partie de la spécification actuelle location.reload() et n'en a en fait jamais fait partie.

+En résumé, ce paramètre booléen ne fait pas partie de la spécification actuelle `location.reload()` et n'en a en fait jamais fait partie. -

Spécifications

+## Spécifications -

{{Specifications}}

+{{Specifications}} -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat}}

+{{Compat}} -

Voir aussi

+## Voir aussi - +- L'interface [`Location`](/fr/docs/Web/API/Location) à laquelle appartient cette méthode. +- Des méthodes semblables : [`Location.assign()`](/fr/docs/Web/API/Location/assign) et [`Location.replace()`](/fr/docs/Web/API/Location/replace). diff --git a/files/fr/web/api/location/replace/index.md b/files/fr/web/api/location/replace/index.md index 90fa954e20..0811c18b61 100644 --- a/files/fr/web/api/location/replace/index.md +++ b/files/fr/web/api/location/replace/index.md @@ -8,51 +8,42 @@ tags: - Reference translation_of: Web/API/Location/replace --- -

{{APIRef("Location")}}

-

La méthode Location.replace() remplace la ressource actuelle par celle présente à l'URL donnée. La différence avec la méthode {{domxref("Location.assign","assign()")}} est que, après avoir utilisé replace(), la page actuelle ne sera pas enregistrée dans l'historique de session {{domxref("History")}}, ce qui signifie que l'utilisateur ne sera pas en mesure d'utiliser le bouton précédent pour y revenir.

-

Si le remplacement est impossible à cause d'une violation de sécurité, une {{domxref("DOMException")}} de type SECURITY_ERROR est lancée. Ceci se produit si l'origine du script appelant est différente de l'origine de la page originellement désignée par l'objet {{domxref("Location")}}, principalement quand le script est hébergé sur un autre domaine.

-

Si l'URL donnée n'est pas valide, une {{domxref("DOMException")}} de type SYNTAX_ERROR est lancée.

-

Syntaxe

-
object.replace(url);
-
-

Paramètres

-
-
- url
-
- {{domxref("DOMString")}} contenant l'URL de la page vers laquelle naviguer.
-
-

Exemples

-
// Navigue vers l'article Location.reload en remplaçant la page actuelle
-document.location.replace('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');
-

Spécifications

- - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{SpecName('HTML WHATWG', "history.html#dom-location-replace", "Location.replace()")}}{{Spec2('HTML WHATWG')}}Pas de différence avec {{SpecName("HTML5 W3C")}}.
{{SpecName('HTML5 W3C', "browsers.html#dom-location-replace", "Location.replace()")}}{{Spec2('HTML5 W3C')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.IDBIndex")}}

- -

Voir aussi

- - +{{APIRef("Location")}} + +La méthode **`Location.replace()`** remplace la ressource actuelle par celle présente à l'URL donnée. La différence avec la méthode {{domxref("Location.assign","assign()")}} est que, après avoir utilisé `replace()`, la page actuelle ne sera pas enregistrée dans l'historique de session {{domxref("History")}}, ce qui signifie que l'utilisateur ne sera pas en mesure d'utiliser le bouton _précédent_ pour y revenir. + +Si le remplacement est impossible à cause d'une violation de sécurité, une {{domxref("DOMException")}} de type `SECURITY_ERROR` est lancée. Ceci se produit si l'origine du script appelant est différente de l'origine de la page originellement désignée par l'objet {{domxref("Location")}}, principalement quand le script est hébergé sur un autre domaine. + +Si l'URL donnée n'est pas valide, une {{domxref("DOMException")}} de type `SYNTAX_ERROR` est lancée. + +## Syntaxe + + object.replace(url); + +### Paramètres + +- _url_ + - : {{domxref("DOMString")}} contenant l'URL de la page vers laquelle naviguer. + +## Exemples + +```js +// Navigue vers l'article Location.reload en remplaçant la page actuelle +document.location.replace('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload'); +``` + +## Spécifications + +| Spécification | Statut | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------- | +| {{SpecName('HTML WHATWG', "history.html#dom-location-replace", "Location.replace()")}} | {{Spec2('HTML WHATWG')}} | Pas de différence avec {{SpecName("HTML5 W3C")}}. | +| {{SpecName('HTML5 W3C', "browsers.html#dom-location-replace", "Location.replace()")}} | {{Spec2('HTML5 W3C')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.IDBIndex")}} + +## Voir aussi + +- L'interface {{domxref("Location")}} à laquelle appartient cette méthode. +- Méthodes similaires : {{domxref("Location.assign()")}} et {{domxref("Location.reload()")}}. -- cgit v1.2.3-54-g00ecf