aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/navigator/registerprotocolhandler
diff options
context:
space:
mode:
authorjulieng <julien.gattelier@gmail.com>2021-10-02 17:20:24 +0200
committerSphinxKnight <SphinxKnight@users.noreply.github.com>2021-10-02 17:30:20 +0200
commit1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch)
tree30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/navigator/registerprotocolhandler
parentc05efa8d7ae464235cf83d7c0956e42dc6974103 (diff)
downloadtranslated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip
convert content to md
Diffstat (limited to 'files/fr/web/api/navigator/registerprotocolhandler')
-rw-r--r--files/fr/web/api/navigator/registerprotocolhandler/index.md44
-rw-r--r--files/fr/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md146
2 files changed, 89 insertions, 101 deletions
diff --git a/files/fr/web/api/navigator/registerprotocolhandler/index.md b/files/fr/web/api/navigator/registerprotocolhandler/index.md
index 25df0e4c12..b44da6ad1f 100644
--- a/files/fr/web/api/navigator/registerprotocolhandler/index.md
+++ b/files/fr/web/api/navigator/registerprotocolhandler/index.md
@@ -5,42 +5,36 @@ tags:
- Firefox 3
translation_of: Web/API/Navigator/registerProtocolHandler
---
-<p>{{ ApiRef() }}</p>
+{{ ApiRef() }}
-<h3 id="R.C3.A9sum.C3.A9">Résumé</h3>
+### Résumé
-<p>Permet aux sites web de s'enregistrer en tant que gestionnaires possibles pour des protocoles particuliers.</p>
+Permet aux sites web de s'enregistrer en tant que gestionnaires possibles pour des protocoles particuliers.
-<p>{{ Note("Un site web ne peut enregistrer de gestionnaires de protocoles que pour lui-même. Pour des raisons de sécurité, il n\'est pas possible pour une extension ou un site d\'enregistrer des gestionnaires de protocoles ciblant d\'autres sites.") }}</p>
+{{ Note("Un site web ne peut enregistrer de gestionnaires de protocoles que pour lui-même. Pour des raisons de sécurité, il n\'est pas possible pour une extension ou un site d\'enregistrer des gestionnaires de protocoles ciblant d\'autres sites.") }}
-<h3 id="Syntaxe">Syntaxe</h3>
+### Syntaxe
-<pre class="eval">window.navigator.registerProtocolHandler(<em>protocole</em>,<em>uri</em>,<em>titre</em>);
-</pre>
+ window.navigator.registerProtocolHandler(protocole,uri,titre);
-<ul>
- <li><code>protocole</code> est le protocole que le site désire gérer, sous la forme d'une chaîne.</li>
- <li><code>uri</code> est l'URI du gestionnaire sous la forme d'une chaîne. Il peut contenir « %s » pour indiquer où insérer l'URI échappée du document à gérer, comme montré dans l'exemple plus bas.</li>
- <li><code>titre</code> est le titre du gestionnaire présenté à l'utilisateur, sous la forme d'une chaîne.</li>
-</ul>
+- `protocole` est le protocole que le site désire gérer, sous la forme d'une chaîne.
+- `uri` est l'URI du gestionnaire sous la forme d'une chaîne. Il peut contenir « %s » pour indiquer où insérer l'URI échappée du document à gérer, comme montré dans l'exemple plus bas.
+- `titre` est le titre du gestionnaire présenté à l'utilisateur, sous la forme d'une chaîne.
-<h3 id="Exemple">Exemple</h3>
+### Exemple
-<p>Si votre application web est située à <code>http://www.example.com</code>, vous pouvez enregistrer un gestionnaire de protocole lui permettant de gérer « mailto » comme ceci :</p>
+Si votre application web est située à `http://www.example.com`, vous pouvez enregistrer un gestionnaire de protocole lui permettant de gérer « mailto » comme ceci :
-<pre class="eval">navigator.registerProtocolHandler("mailto",
- "<a href="https://www.example.com/?to=%s">https://www.example.com/?to=%s</a>",
- "Example Mail");
-</pre>
+ navigator.registerProtocolHandler("mailto",
+ "https://www.example.com/?to=%s",
+ "Example Mail");
-<p>Ceci crée un gestionnaire permettant aux liens <code>mailto</code> de diriger l'utilisateur vers l'application web, en insérant l'adresse spécifiée dans le lien dans l'URL.</p>
+Ceci crée un gestionnaire permettant aux liens `mailto` de diriger l'utilisateur vers l'application web, en insérant l'adresse spécifiée dans le lien dans l'URL.
-<h3 id="Sp.C3.A9cification">Spécification</h3>
+### Spécification
-<p>Spécifié dans le <a href="http://whatwg.org/specs/web-apps/current-work/#custom-handlers">brouillon de travail Web Applications 1.0</a> du WHATWG.</p>
+Spécifié dans le [brouillon de travail Web Applications 1.0](http://whatwg.org/specs/web-apps/current-work/#custom-handlers) du WHATWG.
-<h3 id="Voir_.C3.A9galement">Voir également</h3>
+### Voir également
-<ul>
- <li><a href="/fr/docs/Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers">Gestionnaires de protocoles web</a></li>
-</ul>
+- [Gestionnaires de protocoles web](/fr/docs/Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers)
diff --git a/files/fr/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md b/files/fr/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md
index 3ab6522963..efb4ff023c 100644
--- a/files/fr/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md
+++ b/files/fr/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md
@@ -3,109 +3,103 @@ title: Gestionnaires de protocoles web
slug: Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers
translation_of: Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers
---
+### Introduction
+Il est relativement courant de voir des pages web lier des ressources utilisant des protocoles non-`http`. Prenons par exemple le protocole `mailto:` :
-<h3 id="Introduction">Introduction</h3>
+ <a href="mailto:webmaster@example.com">Webmestre</a>
-<p>Il est relativement courant de voir des pages web lier des ressources utilisant des protocoles non-<code>http</code>. Prenons par exemple le protocole <code>mailto:</code> :</p>
+Les auteurs web peuvent utiliser un lien `mailto:` lorsqu'ils veulent fournir aux utilisateurs une manière pratique d'envoyer un courrier électronique, directement depuis la page web. Lorsque le lien est activé, le navigateur est supposé lancer l'application par défaut du bureau pour le courrier électronique. On pourrait appeler cela un gestionnaire de protocole*du bureau*.
-<pre>&lt;a href="mailto:webmaster@example.com"&gt;Webmestre&lt;/a&gt;
-</pre>
+Les gestionnaires de protocoles web permettent à des applications web de participer également à ce processus. Leur importance va grandissant au fur et à mesure que différents types d'applications migrent vers le web. De fait, un grand nombre d'applications de courrier déjà basées sur le web pourraient traiter un lien `mailto`.
-<p>Les auteurs web peuvent utiliser un lien <code>mailto:</code> lorsqu'ils veulent fournir aux utilisateurs une manière pratique d'envoyer un courrier électronique, directement depuis la page web. Lorsque le lien est activé, le navigateur est supposé lancer l'application par défaut du bureau pour le courrier électronique. On pourrait appeler cela un gestionnaire de protocole<em>du bureau</em>.</p>
+### Enregistrement
-<p>Les gestionnaires de protocoles web permettent à des applications web de participer également à ce processus. Leur importance va grandissant au fur et à mesure que différents types d'applications migrent vers le web. De fait, un grand nombre d'applications de courrier déjà basées sur le web pourraient traiter un lien <code>mailto</code>.</p>
+La définition d'une application web comme gestionnaire de protocole n'est pas un processus difficile. En gros, l'application web utilise [`registerProtocolHandler()`](/fr/DOM/window.navigator.registerProtocolHandler) pour s'enregistrer auprès du navigateur comme gestionnaire potentiel pour un protocole donné. Par exemple :
-<h3 id="Enregistrement">Enregistrement</h3>
+ navigator.registerProtocolHandler("mailto",
+ "https://www.example.com/?uri=%s",
+ "Example Mail");
-<p>La définition d'une application web comme gestionnaire de protocole n'est pas un processus difficile. En gros, l'application web utilise <code><a href="/fr/DOM/window.navigator.registerProtocolHandler">registerProtocolHandler()</a></code> pour s'enregistrer auprès du navigateur comme gestionnaire potentiel pour un protocole donné. Par exemple :</p>
+Où les paramètres sont :
-<pre>navigator.registerProtocolHandler("mailto",
- "https://www.example.com/?uri=%s",
- "Example Mail");
-</pre>
+- Le protocole.
+- Le modèle d'URL, utilisé comme gestionnaire. Le « %s » sera remplacé par le `href` du lien et une requête GET sera exécutée sur l'URL résultante.
+- Le nom du gestionnaire de protocole tel que présenté à l'utilisateur.
-<p>Où les paramètres sont :</p>
+Lorsqu'un navigateur exécutera ce code, il devra demander à l'utilisateur la permission d'autoriser l'application web à s'enregistrer comme gestionnaire du protocole. Firefox affichera une question dans une barre de notification :
-<ul>
- <li>Le protocole.</li>
- <li>Le modèle d'URL, utilisé comme gestionnaire. Le « %s » sera remplacé par le <code>href</code> du lien et une requête GET sera exécutée sur l'URL résultante.</li>
- <li>Le nom du gestionnaire de protocole tel que présenté à l'utilisateur.</li>
-</ul>
+![](protocolregister.png)
-<p>Lorsqu'un navigateur exécutera ce code, il devra demander à l'utilisateur la permission d'autoriser l'application web à s'enregistrer comme gestionnaire du protocole. Firefox affichera une question dans une barre de notification :</p>
+{{ Note() }}
-<p><img alt="" src="protocolregister.png"></p>
+#### Exemple
-<p>{{ Note() }}</p>
-
-<h4 id="Exemple">Exemple</h4>
-
-<pre class="brush: html">&lt;!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"&gt;
-&lt;html lang="fr"&gt;
-&lt;head&gt;
- &lt;title&gt;Web Protocol Handler Sample - Register&lt;/title&gt;
- &lt;script type="text/javascript"&gt;
+```html
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<html lang="fr">
+<head>
+ <title>Web Protocol Handler Sample - Register</title>
+ <script type="text/javascript">
navigator.registerProtocolHandler("fake", "http://starkravingfinkle.org/projects/wph/handler.php?value=%s", "Protocole fake");
- &lt;/script&gt;
-&lt;/head&gt;
-&lt;body&gt;
- &lt;h1&gt;Exemple de gestionnaire de protocole web&lt;/h1&gt;
- &lt;p&gt;Cette page va installer un gestionnaire de protocole web pour le protocole &lt;code&gt;fake:&lt;/code&gt;.&lt;/p&gt;
-&lt;/body&gt;
-&lt;/html&gt;
-</pre>
+ </script>
+</head>
+<body>
+ <h1>Exemple de gestionnaire de protocole web</h1>
+ <p>Cette page va installer un gestionnaire de protocole web pour le protocole <code>fake:</code>.</p>
+</body>
+</html>
+```
-<h3 id="Activation">Activation</h3>
+### Activation
-<p>À présent, chaque fois que l'utilisateur activera un lien utilisant le protocole enregistré, le navigateur dirigera l'action vers l'URL spécifiée lors de l'enregistrement de l'application web. Firefox, par défaut, demandera à l'utilisateur avant d'effectuer cette action.</p>
+À présent, chaque fois que l'utilisateur activera un lien utilisant le protocole enregistré, le navigateur dirigera l'action vers l'URL spécifiée lors de l'enregistrement de l'application web. Firefox, par défaut, demandera à l'utilisateur avant d'effectuer cette action.
-<h4 id="Exemple_2">Exemple</h4>
+#### Exemple
-<pre class="brush: html">&lt;!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"&gt;
-&lt;html lang="fr"&gt;
-&lt;head&gt;
- &lt;title&gt;Exemple de gestionnaire de protocole web — test&lt;/title&gt;
-&lt;/head&gt;
-&lt;body&gt;
- &lt;p&gt;Hola, avez-vous déjà vu &lt;a href="fake:ceci%20est%20un%20faux%20protocole"&gt;ceci&lt;/a&gt; auparavant ?&lt;/p&gt;
-&lt;/body&gt;
-&lt;/html&gt;
-</pre>
+```html
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<html lang="fr">
+<head>
+ <title>Exemple de gestionnaire de protocole web — test</title>
+</head>
+<body>
+ <p>Hola, avez-vous déjà vu <a href="fake:ceci%20est%20un%20faux%20protocole">ceci</a> auparavant ?</p>
+</body>
+</html>
+```
-<h3 id="Traitement">Traitement</h3>
+### Traitement
-<p>La phase suivante est le traitement de l'action. Le navigateur extrait le <code>href</code> du lien activé, le combine avec le modèle d'URL fourni lors de l'enregistrement et effectue une requête HTTP GET sur l'URL. Ainsi, avec les exemples précédents, le navigateur effectuerait une requête GET sur cette URL :</p>
+La phase suivante est le traitement de l'action. Le navigateur extrait le `href` du lien activé, le combine avec le modèle d'URL fourni lors de l'enregistrement et effectue une requête HTTP GET sur l'URL. Ainsi, avec les exemples précédents, le navigateur effectuerait une requête GET sur cette URL :
-<pre>http://starkravingfinkle.org/projects/wph/handler.php?value=fake:ceci%20est%20un%20faux%20protocole
-</pre>
+ http://starkravingfinkle.org/projects/wph/handler.php?value=fake:ceci%20est%20un%20faux%20protocole
-<p>Un code côté serveur peut extraire les paramètres de la chaîne de requête et effectuer l'action désirée.</p>
+Un code côté serveur peut extraire les paramètres de la chaîne de requête et effectuer l'action désirée.
-<p>{{ Note("Le code côté serveur reçoit le contenu <strong>entier</strong> de l\'attribut <code>href</code>. Cela signifie qu\'il devra traiter la chaîne pour retirer l\'indication de protocole des données.") }}</p>
+{{ Note("Le code côté serveur reçoit le contenu <strong>entier</strong> de l\'attribut <code>href</code>. Cela signifie qu\'il devra traiter la chaîne pour retirer l\'indication de protocole des données.") }}
-<h4 id="Exemple_3">Exemple</h4>
+#### Exemple
-<pre class="brush: html">&lt;?php
+```html
+<?php
$value = "";
if ( isset ( $_GET["value"] ) ) {
$value = $_GET["value"];
}
-?&gt;
-
-&lt;!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"&gt;
-&lt;html lang="fr"&gt;
-&lt;head&gt;
- &lt;title&gt;Exemple de gestionnaire de protocole web&lt;/title&gt;
-&lt;/head&gt;
-&lt;body&gt;
- &lt;h1&gt;Exemple de gestionnaire de protocole web — Gestionnaire&lt;/h1&gt;
- &lt;p&gt;Cette page est appelée lors de la gestion d'une action utilisant le protocole &lt;code&gt;fake:&lt;/code&gt;. Voici les données reçues :&lt;/p&gt;
- &lt;textarea&gt;
-&lt;?php echo(urldecode($value)) ?&gt;
- &lt;/textarea&gt;
-&lt;/body&gt;
-&lt;/html&gt;
-</pre>
-
-<p> </p>
+?>
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<html lang="fr">
+<head>
+ <title>Exemple de gestionnaire de protocole web</title>
+</head>
+<body>
+ <h1>Exemple de gestionnaire de protocole web — Gestionnaire</h1>
+ <p>Cette page est appelée lors de la gestion d'une action utilisant le protocole <code>fake:</code>. Voici les données reçues :</p>
+ <textarea>
+<?php echo(urldecode($value)) ?>
+ </textarea>
+</body>
+</html>
+```