mozilla

Révision 162619 sur Ajout de moteurs de recherche depuis des pages Web

  • Raccourci de la révision : Ajout_de_moteurs_de_recherche_depuis_des_pages_Web
  • Titre de la révision : Ajout de moteurs de recherche depuis des pages Web
  • ID de la révision : 162619
  • Créé :
  • Créateur : Lapinkiller
  • Version actuelle ? Non
  • Commentaire /* Capacité de détection de moteurs de recherche du navigateur */
Étiquettes : 

Contenu de la révision

{{template.Traduction_en_cours("Adding search engines from web pages")}}

Firefox permet à du code JavaScript d'installer un plugin de moteur de recherche écrit au format OpenSearch ou Sherlock.

Note : Pour Firefox 2 et suivants, il est recommandé d'utiliser le format OpenSearch.

Lorsque du code JavaScript tente d'installer un plugin de recherche, Firefox alerte l'utilisateur en lui demandant sa permission.

Installation de plugins OpenSearch

Pour installer un plugin OpenSearch, vous devez employer la méthode DOM window.external.AddSearchProvider(). La syntaxe de cette méthode est :

window.external.AddSearchProvider(URLmoteur);

URLmoteur est l'URL complète du fichier XML pour le plugin de recherche.

Note : Le support d'OpenSearch n'est disponible qu'à partir de Firefox 2.

Installation de plugins Sherlock

Pour installer un plugin Sherlock, vous devez appeler window.sidebar.addSearchEngine(), dont la syntaxe est :

window.sidebar.addSearchEngine(URLmoteur, URLicone, nomProposé, catégorieProposée);
  • Le paramètre URLmoteur est l'URL du plugin Sherlock (un fichier « .src ») à installer.
  • URLicone est l'URL d'une icône à associer au plugin.
  • Le paramètre nomProposé n'est utilisé que lorsque Firefox demande à l'utilisateur la permission d'installer le plugin, pour pouvoir afficher un message tel que « Voulez-vous installer nomProposé depuis URLmoteur ? ».
  • Le paramètre catégorieProposée n'est pas utilisé. Utilisez soit une chaîne vide (""), soit null.

Pour plus de détails sur Sherlock, consultez http://developer.apple.com/macosx/sherlock/.

Capacité de détection de moteurs de recherche du navigateur

Du fait que le système d'ajout des moteurs de recherche à changer lors du passage de Firefox 1.5 à Firefox 2, et que Firefox 1.5 ne supporte pas les fichiers de description OpenSearch, les webmasters qui veulent aussi permettre l'ajout des moteurs sur les version antérieures ((c'est-à-dire, qui travaillera dans Firefox 1.5,Firefox 2.0 ou IE 7) devront gérer les formats Sherlock et OpenSearch et detecter le navigateur pour utiliser soit l'un soit l'autre. Les lignes ci-dessous en sont un exemple:


function installSearchEngine() {
 if (window.external && ("AddSearchProvider" in window.external)) {
   // Firefox 2 and IE 7, OpenSearch
   window.external.AddSearchProvider("http://example.com/search-plugin.xml");
 } else if (window.sidebar && ("addSearchEngine" in window.sidebar)) {
   // Firefox <= 1.5, Sherlock
   window.sidebar.addSearchEngine("http://example.com/search-plugin.src",
                                  "http://example.com/search-icon.png",
                                  "Search Plugin", "");
 } else {
   // No search engine support (IE 6, Opera, etc).
   alert("No search engine support");
 }
}
{{ wiki.languages( { "ca": "ca/Addici\u00f3_de_motors_de_cerca_a_les_p\u00e0gines_web", "en": "en/Adding_search_engines_from_web_pages", "es": "es/A\u00f1adir_motores_de_b\u00fasqueda_desde_p\u00e1ginas_web", "it": "it/Installare_plugin_di_ricerca_dalle_pagine_web", "ja": "ja/Adding_search_engines_from_web_pages", "pl": "pl/Dodawanie_wyszukiwarek_z_poziomu_stron_WWW" } ) }}

Source de la révision

<p>
{{template.Traduction_en_cours("Adding search engines from web pages")}}
</p><p>Firefox permet à du code JavaScript d'installer un plugin de moteur de recherche écrit au format <a href="fr/Cr%c3%a9ation_de_plugins_OpenSearch_pour_Firefox">OpenSearch</a> ou <a class="external" href="http://developer.apple.com/macosx/sherlock/">Sherlock</a>.
</p>
<div class="note"><b>Note :</b> Pour Firefox 2 et suivants, il est recommandé d'utiliser le format OpenSearch.</div>
<p>Lorsque du code JavaScript tente d'installer un plugin de recherche, Firefox alerte l'utilisateur en lui demandant sa permission.
</p>
<h3 name="Installation_de_plugins_OpenSearch"> Installation de plugins OpenSearch </h3>
<p>Pour installer un plugin OpenSearch, vous devez employer la méthode DOM <code>window.external.AddSearchProvider()</code>. La syntaxe de cette méthode est :
</p>
<pre class="eval">window.external.AddSearchProvider(<i>URLmoteur</i>);
</pre>
<p>où <i>URLmoteur</i> est l'URL complète du fichier XML pour le plugin de recherche.
</p>
<div class="note"><b>Note :</b> Le support d'OpenSearch n'est disponible qu'à partir de Firefox 2.</div>
<h3 name="Installation_de_plugins_Sherlock"> Installation de plugins Sherlock </h3>
<p>Pour installer un plugin Sherlock, vous devez appeler <code>window.sidebar.addSearchEngine()</code>, dont la syntaxe est :
</p>
<pre class="eval">window.sidebar.addSearchEngine(<i>URLmoteur</i>, <i>URLicone</i>, <i>nomProposé</i>, <i>catégorieProposée</i>);
</pre>
<ul><li> Le paramètre <code>URLmoteur</code> est l'URL du plugin Sherlock (un fichier « <code>.src</code> ») à installer.
</li><li> <code>URLicone</code> est l'URL d'une icône à associer au plugin.
</li><li> Le paramètre <code>nomProposé</code> n'est utilisé que lorsque Firefox demande à l'utilisateur la permission d'installer le plugin, pour pouvoir afficher un message tel que « Voulez-vous installer <i>nomProposé</i> depuis <i>URLmoteur</i> ? ».
</li><li> Le paramètre <code>catégorieProposée</code> n'est pas utilisé. Utilisez soit une chaîne vide (<code>""</code>), soit <code>null</code>.
</li></ul>
<p>Pour plus de détails sur Sherlock, consultez http://developer.apple.com/macosx/sherlock/.
</p>
<h2 name="Capacit.C3.A9_de_d.C3.A9tection_de_moteurs_de_recherche_du_navigateur">Capacité de détection de moteurs de recherche du navigateur</h2>
<p>Du fait que le système d'ajout des moteurs de recherche à changer lors du passage de Firefox 1.5 à Firefox 2, et que Firefox 1.5 ne supporte pas les fichiers de description OpenSearch, les webmasters qui veulent aussi permettre l'ajout des moteurs sur les version antérieures ((c'est-à-dire, qui travaillera dans Firefox 1.5,Firefox 2.0  ou IE 7) devront gérer les formats Sherlock et OpenSearch et detecter le navigateur pour utiliser soit l'un soit l'autre. Les lignes ci-dessous en sont un exemple:
</p><p><br>
</p>
<pre class="eval">function installSearchEngine() {
 if (window.external &amp;&amp; ("AddSearchProvider" in window.external)) {
   // Firefox 2 and IE 7, OpenSearch
   window.external.AddSearchProvider("<span class="plain">http://example.com/search-plugin.xml</span>");
 } else if (window.sidebar &amp;&amp; ("addSearchEngine" in window.sidebar)) {
   // Firefox &lt;= 1.5, Sherlock
   window.sidebar.addSearchEngine("<span class="plain">http://example.com/search-plugin.src</span>",
                                  "<span class="plain">http://example.com/search-icon.png</span>",
                                  "Search Plugin", "");
 } else {
   // No search engine support (IE 6, Opera, etc).
   alert("No search engine support");
 }
}
</pre>{{ wiki.languages( { "ca": "ca/Addici\u00f3_de_motors_de_cerca_a_les_p\u00e0gines_web", "en": "en/Adding_search_engines_from_web_pages", "es": "es/A\u00f1adir_motores_de_b\u00fasqueda_desde_p\u00e1ginas_web", "it": "it/Installare_plugin_di_ricerca_dalle_pagine_web", "ja": "ja/Adding_search_engines_from_web_pages", "pl": "pl/Dodawanie_wyszukiwarek_z_poziomu_stron_WWW" } ) }}
Revenir à cette révision