blob: 25df0e4c12bb24a6c330f83a95ac80f9cd878243 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
---
title: window.navigator.registerProtocolHandler
slug: Web/API/Navigator/registerProtocolHandler
tags:
- Firefox 3
translation_of: Web/API/Navigator/registerProtocolHandler
---
<p>{{ ApiRef() }}</p>
<h3 id="R.C3.A9sum.C3.A9">Résumé</h3>
<p>Permet aux sites web de s'enregistrer en tant que gestionnaires possibles pour des protocoles particuliers.</p>
<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>
<h3 id="Syntaxe">Syntaxe</h3>
<pre class="eval">window.navigator.registerProtocolHandler(<em>protocole</em>,<em>uri</em>,<em>titre</em>);
</pre>
<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>
<h3 id="Exemple">Exemple</h3>
<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>
<pre class="eval">navigator.registerProtocolHandler("mailto",
"<a href="https://www.example.com/?to=%s">https://www.example.com/?to=%s</a>",
"Example Mail");
</pre>
<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>
<h3 id="Sp.C3.A9cification">Spécification</h3>
<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>
<h3 id="Voir_.C3.A9galement">Voir également</h3>
<ul>
<li><a href="/fr/docs/Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers">Gestionnaires de protocoles web</a></li>
</ul>
|
