Extensibilité des moteurs de recherche dans Internet Explorer

Article
02/01/2010

Nouveautés de Windows Internet Explorer 8

Depuis la version 7 d'Internet Explorer, la zone Recherche instantanée fournit une fonctionnalité de saisie automatique qui permet aux utilisateurs de rechercher des termes similaires à ceux utilisés dans les recherches précédentes. Internet Explorer 7 permet également d'ajouter plusieurs moteurs de recherche. Dans Internet Explorer 8, le menu déroulant de la zone Recherche instantanée a été amélioré de façon significative. En outre, cette nouvelle version prend en charge les suggestions de recherche.

Cette rubrique est destinée à la fois aux utilisateurs finaux et aux développeurs de sites Web. Sa première partie traite principalement de l'installation, de la gestion et de l'utilisation des moteurs de recherche. La deuxième partie s'adresse plus particulièrement aux développeurs de sites Web. Elle indique comment promouvoir un moteur de recherche et utiliser des suggestions de recherche pour améliorer l'expérience des utilisateurs.

Les sujets abordés sont les suivants :

Fonctionnalités de recherche destinées à l'utilisateur final
- Ajout de moteurs de recherche
- Gestion des moteurs de recherche
- Recherche à l'aide des moteurs de recherche favoris
- Conseils et astuces
Fonctionnalités de recherche pour les développeurs de sites Web
- Création d'un fichier de description OpenSearch
- Promotion de moteurs de recherche
- Ajout de suggestions de recherche
- Obtention de dimensions pour le menu Rechercher des suggestions
- Identification de l'attribut referrer
- Localisation de suggestions de recherche
- Remarques
Voir aussi

Fonctionnalités de recherche destinées à l'utilisateur final

La fonctionnalité Recherche instantanée d'Internet Explorer 8 permet à l'utilisateur final d'ajouter plusieurs moteurs de recherche favoris et de passer rapidement de l'un à l'autre pendant une recherche. En outre, Internet Explorer 8 prend en charge les suggestions de recherche, qui permettent aux utilisateurs d'optimiser leurs recherches en les rendant plus pertinentes. Les moteurs de recherche peuvent également fournir des réponses immédiates. Outre la zone Recherche instantanée, les utilisateurs peuvent accéder à tous leurs moteurs de recherche via le menu Accélérateurs. Toutes ces fonctionnalités sont conçues pour améliorer l'expérience des utilisateurs lorsqu'ils effectuent une recherche et augmenter leur productivité.

Cette section traite des sujets suivants :

Ajout de moteurs de recherche
Gestion des moteurs de recherche
Recherche à l'aide des moteurs de recherche favoris
Conseils et astuces

Ajout de moteurs de recherche

La zone Recherche instantanée affichée en haut à droite de la fenêtre Internet Explorer (versions 7 et 8) remplace l'Assistant Recherche de Windows (également appelé « volet de recherche »). Pour utiliser un moteur de recherche spécifique, vous devez l'ajouter à votre liste. Pour ce faire, accédez tout d'abord au site Web de ce moteur de recherche. Ensuite, vous pouvez installer ce dernier de deux façons.

La première méthode consiste à ajouter le moteur de recherche à l'aide d'un lien ou d'un bouton affiché sur le site Web correspondant. Lorsque vous cliquez sur ce lien ou ce bouton, la boîte de dialogue Ajouter un moteur de recherche s'affiche pour vous permettre de confirmer votre sélection.

Figure 1. Boîte de dialogue Ajouter un moteur de recherche.

Si ce moteur de recherche est déjà installé, une boîte de dialogue s'affiche pour vous en informer ou pour vous proposer de le mettre à niveau. Par exemple, il est possible que le moteur de recherche offre de nouvelles suggestions de recherche qui n'étaient pas disponibles auparavant.

Pour ajouter un moteur de recherche, vous pouvez également utiliser la fonction de découverte. Lorsque la page Web d'un moteur de recherche est chargée dans le navigateur, la flèche vers le bas de la zone Recherche instantanée devient orange pour indiquer que ce moteur de recherche peut être installé.

Figure 2. Flèche vers le bas affichée en orange dans la zone Recherche instantanée.

Lorsque vous cliquez sur la flèche orange, une liste affiche les moteurs de recherche installés, ainsi que les autres options disponibles. Une icône jaune s'affiche à gauche du nom du moteur de recherche découvert par Internet Explorer 8. Lorsque vous cliquez sur l'option Ajouter des moteurs de recherche, la liste des moteurs de recherche disponibles s'affiche. L'image suivante montre les options Live Search : Produits, Images et Vidéos.

Figure 3. Menu Ajouter un moteur de recherche affichant les moteurs de recherche et les options disponibles.

Remarque Pour commencer, vous pouvez utiliser la liste de moteurs de recherche disponible dans la galerie Internet Explorer. Vous pouvez accéder à la galerie Internet Explorer à tout moment en sélectionnant Rechercher d'autres moteurs de recherche dans le menu déroulant de la zone Recherche instantanée, comme indiqué Figure 3.

Ajout manuel d'un moteur de recherche

Vous pouvez également installer manuellement les moteurs de recherche qui ne peuvent pas être ajoutés directement. Pour ce faire, suivez les instructions de la page Ajouter des moteurs de recherche dans Internet Explorer. Notez que ce widget ajoute uniquement le fournisseur en tant que moteur de recherche, sans suggestions de recherche. Si vous savez que ce fournisseur offre des suggestions de recherche, ajoutez-le en utilisant la méthode appropriée proposée sur son site Web.

Gestion des moteurs de recherche

Internet Explorer 8 vous permet d'installer jusqu'à 200 moteurs de recherche, mais le fait de bénéficier d'un nombre d'options aussi important peut poser quelques problèmes en termes de gestion. Pour gérer vos moteurs de recherche dans Internet Explorer 8, cliquez sur la flèche vers le bas de la zone Recherche instantanée, puis sur Gérer les moteurs de recherche. Vous pouvez réorganiser les moteurs de recherche, en supprimer et changer de moteur par défaut, comme indiqué dans l'image suivante.

Figure 4. Boîte de dialogue Gérer les modules complémentaires d'Internet Explorer.

Pour modifier les attributs d'un moteur de recherche, cliquez sur son nom, effectuez les modifications souhaitées et cliquez sur Fermer.

Remarque Le moteur de recherche qui est utilisé par défaut ne peut pas être supprimé. Pour pouvoir supprimer ce moteur de recherche, vous devez d'abord choisir un autre moteur par défaut. Pour ce faire, ouvrez la boîte de dialogue Gérer les moteurs de recherche, sélectionnez un autre moteur de recherche et cliquez sur le bouton Par défaut. Ensuite, sélectionnez le moteur de recherche à supprimer et cliquez sur Supprimer.

Recherche à l'aide des moteurs de recherche favoris

Pour exécuter une recherche, tapez le terme recherché dans la zone Recherche instantanée. Cette zone était déjà disponible dans Internet Explorer 7, mais les options de recherche fournies dans Internet Explorer 8 ont subi d'importantes améliorations.

Lorsque vous cliquez dans la zone Recherche instantanée, un menu de recherche rapide apparaît. Ce menu affiche les icônes des moteurs de recherche, ce qui vous permet de passer facilement de l'un à l'autre. Le nombre d'icônes affiché varie en fonction de la largeur de la zone Recherche instantanée. Pour afficher plus de moteurs de recherche dans ce menu, redimensionnez la zone Recherche instantanée. Cette fonctionnalité vous permet de lancer une recherche à l'aide de différents moteurs de recherche sans changer de site Web.

Figure 5. Menu de recherche rapide.

Après avoir saisi le terme recherché, vous pouvez appuyer sur ENTRÉE pour utiliser le moteur de recherche actuel ou en sélectionner un autre dans le menu de recherche rapide. Si le moteur de recherche que vous utilisez prend en charge les suggestions de recherche, celles-ci s'affichent au fur et à mesure de votre saisie. Par exemple, si vous recherchez « Xbox » à l'aide du moteur Live Search, les suggestions affichées sont les suivantes.

Figure 6. Menu déroulant des suggestions proposées par Windows Live Search.

La première partie du menu des suggestions affiche une section de saisie automatique qui contient les recherches similaires que vous avez effectuées récemment. La deuxième partie répertorie les suggestions proposées par le moteur de recherche actuel. La troisième partie du menu des suggestions contient un historique répertoriant les sites précédemment visités. Elle indique les titres de sites et les URL correspondant au terme actuellement recherché. Les termes qui correspondent à votre recherche sont mis en surbrillance et peuvent être sélectionnés. Le menu de recherche rapide s'affiche au bas du menu pour vous permettre d'accéder plus rapidement à vos principaux moteurs de recherche.

Dans Internet Explorer 8, les moteurs de recherche peuvent proposer des suggestions visuelles, c'est-à-dire des images de petite taille (accompagnées ou non d'un texte) pouvant être affichées avec les suggestions standard fournies sous forme de texte. L'image suivante montre les suggestions visuelles et textuelles proposées pour le terme « Xbox ».

Figure 7. Suggestions de recherche visuelles et textuelles pour le terme « Xbox ».
Les moteurs de recherche peuvent également proposer des réponses instantanées qui permettent d'accéder directement aux informations que vous recherchez au lieu de passer par une page de résultats. Cette possibilité permet de rendre le processus de recherche plus efficace.

Recherche à l'aide d'accélérateurs

Le concept d'accélérateurs est une nouveauté d'Internet Explorer 8. Les accélérateurs vous permettent d'accéder aux moteurs de recherche à partir de n'importe quel endroit de la page affichée. Chaque fois que vous ajoutez un moteur de recherche dans votre liste, Internet Explorer 8 le convertit automatiquement en accélérateur. Pour utiliser cette fonctionnalité, sélectionnez le texte à rechercher et cliquez sur l'icône des accélérateurs Cc848862.ie8_accelerators_icon (en-nous, VS.85) .gif qui s'affiche. Une liste condensée des services Web que vous avez installés apparaît. Cette liste contient votre moteur de recherche par défaut. Pour utiliser un autre moteur de recherche, cliquez sur Rechercher d'autres accélérateurs. L'image suivante présente le menu correspondant.

Figure 8. Menu Rechercher d'autres accélérateurs affichant les services Web disponibles.

Autre avantage, les accélérateurs permettent également d'afficher un aperçu des résultats de la recherche. Si cette fonctionnalité est prise en charge par votre moteur de recherche, vous pouvez afficher un aperçu des résultats en sélectionnant du texte dans une page Web et en cliquant sur l'icône de l'accélérateur, puis en amenant le pointeur de la souris sur le nom du moteur de recherche. Notez que pour effectuer cette opération, vous devrez peut-être afficher la liste Rechercher d'autres accélérateurs. Cette méthode permet de lancer des recherches rapidement et facilement à l'aide des moteurs de recherche installés. Pour en savoir plus sur les accélérateurs, consultez l'article Accélérateurs OpenService - Guide du développeur (page éventuellement en anglais).

Fonction Rechercher sur la page

La fonctionnalité Rechercher sur la page est une autre amélioration apportée par Internet Explorer 8. Elle permet de démarrer une recherche en cliquant sur l'option Rechercher affichée à droite du menu de recherche rapide ou en utilisant la touche de raccourci CTRL+F. Le système parcourt la page affichée pour rechercher les termes indiqués dans la zone Recherche instantanée. Comme indiqué dans la capture d'écran suivante, toutes les correspondances trouvées sur la page sont mises en surbrillance et la première occurrence est sélectionnée. Le nombre d'occurrences trouvées est également affiché.

Figure 9 : Fonctionnalité Rechercher sur la page

Conseils et astuces

Vous trouverez ci-dessous des informations supplémentaires et des conseils non abordés dans les sections précédentes.

Les termes et les pages correspondant à d'anciennes recherches peuvent être supprimés de l'historique. Cette fonction permet, entre autres, d'éviter que des mots mal orthographiés n'apparaissent dans la section de saisie automatique. Lorsque vous saisissez du texte dans la barre d'adresses ou la zone Recherche instantanée, des suggestions de recherche s'affichent en plus des suggestions de saisie automatique et de l'historique. Pour supprimer un élément de la liste de saisie automatique ou de l'historique, pointez sur cet élément. Un X s'affiche comme indiqué dans l'image suivante. Cliquez sur ce X pour supprimer l'élément de la liste.

Figure 10. Suppression d'un élément dans l'historique
Vous pouvez également lancer des recherches directement à partir de la barre d'adresses. Dans ce cas, le moteur de recherche actuel est utilisé pour proposer des suggestions, mais la recherche en elle-même est exécutée par le moteur de recherche par défaut. Pour lancer une recherche à partir de la barre d'adresses, tapez un point d'interrogation (?) suivi du terme recherché. Par exemple, pour lancer une recherche sur le terme « xbox », tapez « ? xbox ». Si votre moteur de recherche actuel propose des suggestions pour le terme « xbox », elles sont affichées. Si vous sélectionnez un terme ou que vous appuyez sur ENTRÉE, la recherche est lancée à l'aide de votre moteur de recherche par défaut.
La zone Recherche instantanée peut être redimensionnée. Pour ce faire, amenez le pointeur de la souris sur le bord gauche de cette zone. Lorsque le pointeur horizontal apparaît, faites glisser le bord de la zone de façon à obtenir la taille souhaitée.

Fonctionnalités de recherche pour les développeurs de sites Web

Internet Explorer 8 offre désormais une nouvelle fonctionnalité qui permet de promouvoir des moteurs de recherche. Les utilisateurs peuvent ainsi lancer des recherches directement à partir du chrome Internet Explorer sans naviguer sur un autre site. Le moteur de recherche par défaut est également utilisé pour les recherches lancées à partir de la barre d'adresses. Pour promouvoir votre moteur de recherche dans Internet Explorer 8, vous devez tout d'abord permettre aux utilisateurs d'installer votre site Web en tant que moteur de recherche à partir de la zone Recherche. Pour ce faire, vous devez effectuer deux opérations. La première consiste à créer un fichier de description OpenSearch Lien World Wide Web pour votre moteur de recherche, et la seconde à exposer ce fichier sur votre site Web pour permettre aux utilisateurs de l'installer.

Cette section a pour but d'aider les développeurs à comprendre et à tirer avantage des fonctionnalités qui permettent d'optimiser l'utilisation des fonctions de recherche dans Internet Explorer 8. Elle traite des sujets suivants :

Création d'un fichier de description OpenSearch
Promotion de moteurs de recherche
Ajout de suggestions de recherche
Obtention de dimensions pour le menu Rechercher des suggestions
Identification de l'attribut referrer
Localisation de suggestions de recherche
Remarques

Création d'un fichier de description OpenSearch

Avant de promouvoir vos services et de fournir aux utilisateurs différentes options permettant d'installer votre moteur de recherche, vous devez créer un fichier de description OpenSearch Lien World Wide Web . Les fichiers de description OpenSearch sont de petits fichiers XML contenant une description de votre moteur de recherche qui est utilisée par Internet Explorer 8. Le tableau suivant décrit les valeurs incluses dans ces fichiers.

Valeur	Description
ShortName (requis)	Nom du moteur de recherche qui s'affiche lorsque ce dernier est sélectionné dans la zone Recherche instantanée.
URL (Requis)	URL utilisée pour les recherches simples lancées à l'aide de votre moteur de recherche. Il doit s'agir d'une URL absolue.
Image (facultatif)	Pointeur vers le fichier d'icône favorite qui est associé à votre moteur de recherche sur votre site Web. Cette icône est affichée en regard du nom du moteur de recherche dans la zone Recherche instantanée. Le raccourci doit correspondre à un fichier d'icône valide. Dans le cas contraire, une icône générique est utilisée. Pour plus d'informations, consultez la section relative à la création d'icônes dans l'article Ajout d'une icône de raccourci dans une page Web (page éventuellement en anglais).
URL utilisée pour les suggestions (au format JSON) (facultatif)	URL à partir de laquelle les suggestions JSON (JavaScript Object Notation) peuvent être récupérées.
URL utilisée pour les suggestions (au format XML) (facultatif)	URL à partir de laquelle les suggestions XML peuvent être récupérées.
PreviewUrl (facultatif)	URL qui permet d'afficher un aperçu des résultats obtenus suite à l'utilisation d'un accélérateur.

L'exemple de fichier de description OpenSearch suivant définit le type des services de recherche proposés.

<?xml version="1.0" encoding="UTF-8"?>
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/" xmlns:ie="https://schemas.microsoft.com/Search/2008/">
	<ShortName>My Custom Search</ShortName>
	<Image height="16" width="16" type="image/icon">http://example.com/example.ico</Image>
	<Url type="text/html" template="http://example.com/search.aspx?q={searchTerms}&amp;source=IE"/>   
	<Url type="application/x-suggestions+json" template="http://suggestions.example.com/search.aspx?q={searchTerms}"/>
	<Url type="application/x-suggestions+xml" template="http://suggestions.example.com/search.aspx?q={searchTerms}"/>
	<ie:PreviewUrl type="text/html" template="http://suggestions.example.com/search.aspx?q={searchTerms}"/>
</OpenSearchDescription>

Tous les fichiers de description OpenSearch doivent inclure le nom du moteur de recherche et l'URL de recherche. Sans ces éléments, Internet Explorer 8 ne peut pas installer votre moteur de recherche. Pour toutes les URL de recherche, la chaîne de requête doit contenir « {searchTerms} ». Lorsqu'Internet Explorer 8 accède au moteur de recherche pour obtenir des résultats, « {searchTerms} » est remplacé par la chaîne saisie par l'utilisateur dans la zone Recherche instantanée. Notez qu'il est conseillé d'inclure une icône dans le fichier de description OpenSearch. Si Internet Explorer 8 ne trouve pas l'icône définie par l'attribut « Image », il utilise une icône générique pour représenter votre moteur de recherche dans le menu de recherche rapide.

Pour créer rapidement un fichier de description OpenSearch, vous pouvez utiliser un widget accessible dans l'article Ajouter des moteurs de recherche dans Internet Explorer pour créer votre propre fichier XML. Suivez les instructions du widget, puis cliquez sur le lien Afficher la version XML indiqué à l'étape 5. Le widget crée une syntaxe XML similaire à l'extrait de code précédent. Enregistrez la sortie dans un fichier XML et téléchargez ce dernier sur votre serveur Web. Assurez-vous que votre fichier XML est valide et que les caractères « & » inclus dans l'URL sont codés.

Remarque Le widget crée uniquement un fichier XML de base que vous pouvez utiliser et personnaliser, mais il ne génère pas d'URL pour l'icône ou les suggestions. Ces éléments doivent être ajoutés manuellement.

Ajout de suggestions de recherche aux fichiers de description OpenSearch

Dans Internet Explorer 8, les moteurs de recherche peuvent proposer des suggestions aux utilisateurs. Cette fonctionnalité permet d'optimiser les recherches et de les rendre plus pertinentes. Pour proposer des suggestions de recherche dans les formats JSON et XML, ajoutez les éléments suivants à votre fichier de description.

<Url type="application/x-suggestions+json" template="http://suggestions.example.com/search.aspx?q={searchTerms}"/>
<Url type="application/x-suggestions+xml" template="http://suggestions.example.com/search.aspx?q={searchTerms}"/>

Lorsque vous ajoutez des éléments d'URL supplémentaires, vous devez indiquer le type « text/html » en premier à des fins de compatibilité descendante. L'ordre des types indiqués ensuite n'a pas d'importance. Par défaut, Internet Explorer utilise l'URL associée au type « text/html » comme URL de recherche générique lorsque les suggestions ne sont pas disponibles ou qu'elles ne sont pas prises en charge par les versions antérieures. Toutefois, lorsqu'il existe à la fois une URL pour XML et JSON, Internet Explorer 8 utilise l'URL correspondant aux suggestions XML.

Remarque Si les utilisateurs avaient déjà ajouté votre moteur de recherche avant qu'il ne prenne en charge les suggestions, ils doivent l'ajouter de nouveau. Cela permet à Internet Explorer 8 de détecter que votre moteur de recherche était déjà installé mais propose désormais des suggestions. Dans ce cas, la boîte de dialogue Ajouter un moteur de recherche affiche un bouton de mise à niveau et active la case à cocher qui permet d'utiliser les suggestions de recherche.

Prise en charge des aperçus de recherche

Tous les moteurs de recherche installés sont automatiquement convertis en accélérateurs. Étant donné que les accélérateurs prennent en charge les aperçus, vous pouvez également proposer cette fonction aux utilisateurs. Pour ce faire, vous devez ajouter un élément PreviewUrl à votre fichier de description OpenSearch, comme indiqué ci-dessous.

<ie:PreviewUrl type="text/html" template="http://suggestions.example.com/search.aspx?q={searchTerms}/>

L'ajout de cet élément à votre fichier de description OpenSearch permet d'afficher une version allégée de la page de résultats. Cet aperçu s'affiche dans une fenêtre de 320 x 240 pixels lorsque l'utilisateur sélectionne du texte sur une page Web, clique sur l'icône des accélérateurs et pointe sur le nom de votre moteur de recherche. Pour plus d'informations sur les accélérateurs et la fonction d'aperçu, consultez l'article correspondant du Guide du développeur des accélérateurs OpenService (page éventuellement en anglais).

Remarque ie:PreviewUrl utilise l'espace de noms fourni par les déclarations d'espaces de noms d'Internet Explorer. Si vous utilisez cette fonctionnalité, assurez-vous que cette déclaration est définie dans votre balise OpenSearchDescription : xmlns:ie="https://schemas.microsoft.com/Search/2008/".

Promotion de moteurs de recherche

Après avoir créé votre fichier de description OpenSearch, vous pouvez promouvoir vos services auprès des utilisateurs. Pour ce faire, vous disposez de deux méthodes. La première consiste à fournir aux utilisateurs un lien ou un bouton pointant vers votre fichier de description. Dans ce cas, les utilisateurs doivent installer votre moteur de recherche manuellement. La deuxième méthode consiste à rendre votre moteur de recherche détectable en ajoutant une ligne de code en haut de votre page Web. Cette ligne permet à Internet Explorer 8 de découvrir votre moteur de recherche lorsque les utilisateurs naviguent sur votre site.

Le code suivant permet d'ajouter un moteur de recherche lorsque l'utilisateur clique sur un lien.

<a href="#"
   onclick="window.external.AddSearchProvider('http://www.example.com/provider.xml')"
   >Add Search Provider Example</a>

Ce code appelle la méthode AddSearchProvider, qui est disponible dans l'objet external associé à l'élément window. Lorsque ce code est exécuté à partir d'une page HTML dans Internet Explorer 8, la boîte de dialogue Ajouter un moteur de recherche s'affiche.

Promotion d'un moteur de recherche à l'aide de la fonction de découverte

La seconde méthode pouvant être utilisée pour promouvoir un moteur de recherche consiste à le rendre détectable. La spécification OpenSearch définit la procédure à utiliser pour promouvoir un moteur de recherche en ajoutant un élément link à la section head de la page Web. Le code suivant permet à Internet Explorer 8 de détecter votre moteur de recherche.

<link title="My Provider" rel="search"
   type="application/opensearchdescription+xml"
   href="http://www.example.com/provider.xml">

L'attribut rel doit avoir pour valeur « search » et type doit être défini sur « application/opensearchdescription+xml ». La valeur de title est affichée dans le menu déroulant de la zone Recherche instantanée. L'attribut href contient une URL absolue ou relative qui spécifie l'emplacement du fichier de description OpenSearch.

Lorsque la page est chargée dans Internet Explorer 8, la flèche vers le bas de la zone Recherche instantanée devient orange pour indiquer que de nouveaux moteurs de recherche ont été ajoutés au menu déroulant. La liste ne peut contenir que les trois derniers moteurs de recherche découverts. Aucun autre moteur de recherche ne peut être ajouté à la liste tant que les trois premiers n'ont pas été installés. En revanche, si l'utilisateur navigue sur un autre domaine, les moteurs de recherche découverts précédemment sont retirés de la liste. Les utilisateurs ont la possibilité d'essayer les nouveaux moteurs de recherche avant de les ajouter à leur liste. S'ils décident d'installer un moteur de recherche, la boîte de dialogue Ajouter un moteur de recherche s'affiche.

Ajout de suggestions de recherche

Utilisation du format de suggestions JSON
Utilisation du format de suggestions XML
Ajout de suggestions visuelles
Gestion des erreurs

La prise en charge des suggestions dans la zone Recherche instantanée est une nouveauté d'Internet Explorer 8. Cette fonctionnalité permet d'optimiser les recherches et de les rendre plus pertinentes en proposant des suggestions associées aux termes saisis par l'utilisateur dans la zone de recherche. Internet Explorer 8 prend en charge deux formats de suggestion, le format JSON et le format XML. Le format JSON permet d'afficher des suggestions textuelles pouvant contenir des descriptions et des URL. Le format XML prend en charge tous les contenus correspondant aux suggestions JSON, mais il permet également de proposer aux utilisateurs des suggestions visuelles et des titres de section. Plus de détails sur le format de suggestion XML, consultez l'article suivant : Spécification du format XML pour les suggestions de recherche (page éventuellement en anglais).

Remarque Cette section traite uniquement du format des suggestions individuelles. Pour que les suggestions de recherche soient totalement prises en charge, vous devez les créer et fournir les suggestions appropriées pour chaque requête. Cet aspect varie d'un moteur de recherche à l'autre et n'est donc pas traité dans le présent document.

Utilisation du format de suggestions JSON

Les suggestions de recherche JSON sont retournées sous la forme d'un tableau de tableaux Microsoft JScript. Ce tableau contient quatre valeurs :

Valeur	Description
Chaîne de requête (requis)	Terme qui fait l'objet de la recherche. Par exemple, si le navigateur a demandé des suggestions pour « xbox », la chaîne de requête est « xbox ». La chaîne de requête est retournée dans le tableau, ce qui permet de s'assurer que les suggestions correspondent bien au terme recherché.
Tableau des suggestions (requis)	Suggestions proposées pour la chaîne de requête.
Tableau des descriptions (facultatif)	Autres chaînes fournissant des informations supplémentaires ou du contexte pour une suggestion donnée.
Tableau des URL de requêtes (facultatif)	Liste des URL qui doivent être utilisées lorsqu'une suggestion est sélectionnée. L'utilisateur obtient ainsi une réponse immédiate et accède directement à l'URL appropriée sans passer par une page de résultats.

Une réponse JSON doit retourner la chaîne de requête et les suggestions de recherche dans le tableau des suggestions. L'exemple suivant illustre une réponse JSON simple n'incluant aucune description ni URL.

["xbox",
	["Xbox 360", "Xbox cheats", "Xbox 360 games"]]

Remarque Le nombre maximal de suggestions de recherche pouvant être affichées simultanément est de 10. Le fait d'ajouter des descriptions, des suggestions visuelles et des sections limite le nombre de suggestions pouvant être proposées. Il est important que les suggestions les plus pertinentes soient affichées au début du tableau des suggestions.

Les suggestions peuvent être accompagnées de descriptions afin d'aider les utilisateurs à affiner leurs recherches en les rendant plus pertinentes. En outre, il est possible de fournir des réponses immédiates sous forme d'URL. Lorsqu'une URL de requête est proposée dans Internet Explorer 8, il suffit à l'utilisateur de cliquer sur la suggestion pour accéder à cette URL directement, sans passer par une page de résultats. L'exemple suivant présente une réponse JSON détaillée.

["xbox",
	["Xbox 360", "Xbox cheats", "Xbox 360 games"], 
	["The official Xbox website from Microsoft", "Codes and walkthroughs", "Games and accessories"],	
	["https://www.xbox.com","http://www.example.com/xboxcheatcodes.aspx", "http://www.example.com/games"]]

Dans cette réponse JSON, la première suggestion de recherche contient les éléments suivants :

Premier élément du premier tableau ("Xbox 360")
Premier élément du deuxième tableau ("The official Xbox website from Microsoft")
Premier élément du troisième tableau ("https://www.xbox.com").

La réponse précédente génère les résultats suivants :

Suggestions de recherche JSON.
Figure 11. Suggestions de recherche JSON

Utilisation du format de suggestions XML

La réponse JSON précédente peut être représentée au format XML, comme indiqué dans l'exemple suivant. Ce code permet de proposer les mêmes suggestions que l'exemple précédent illustrant le format JSON.

<?xml version="1.0"?>
<SearchSuggestion xmlns="https://schemas.microsoft.com/Search/2008/suggestions">
    <Query>xbox</Query>
    <Section>
	<Item>
		<Text>Xbox 360</Text>
		<Description>The official Xbox website from Microsoft</Description>
		<Url>http://www.xbox.com</Url>
	</Item>
	<Item>
		<Text>Xbox cheats</Text>
		<Description>Codes and walkthroughs</Description>
		<Url>http://www.example.com/xboxcheatcodes.aspx</Url>
	</Item>
	<Item>
		<Text>Xbox 360 games</Text>
		<Description>Games and accessories</Description>
		<Url>http://www.example.com/games</Url>
	</Item>
    </Section>
</SearchSuggestion>

Le format de suggestion JSON ne permet pas de proposer des titres de section dans le menu des suggestions. Dans Internet Explorer 8, le titre de section correspond au nom de votre moteur de recherche, accompagné du mot « Suggestions ». Par exemple, si votre moteur de recherche s'appelle « Joe's Search », vos suggestions seront intitulées « Joe's Search Suggestions ». Dans l'exemple suivant, le moteur de recherche est nommé « My Custom Search » et le titre affiché est « My Custom Search Suggestions ». Si vous souhaitez organiser vos suggestions dans plusieurs sections, utilisez le format XML. En plus des titres de section, le format de suggestion XML permet également de proposer des suggestions visuelles. Plus de détails sur le format de suggestion XML, consultez l'article suivant : Spécification du format XML pour les suggestions de recherche (page éventuellement en anglais).

Les suggestions de recherche XML prennent en charge les mêmes fonctionnalités que les suggestions JSON, ainsi que des fonctions supplémentaires qui ne sont pas disponibles avec ce dernier. Ces fonctionnalités supplémentaires sont les suivantes :

Personnalisation du titre de la section Suggestions
Fractionnement des suggestions à l'aide de séparateurs de sections
Suggestions visuelles

Pour personnaliser les titres de section, vous pouvez soit ajouter un attribut « title » à l'élément Section, soit ajouter un séparateur. Les séparateurs peuvent avoir un titre, mais cela n'est pas obligatoire. L'exemple suivant ajoute un séparateur pour « My Text Suggestions », ainsi qu'un autre séparateur sans titre.

<?xml version="1.0"?>
<SearchSuggestion xmlns="https://schemas.microsoft.com/Search/2008/suggestions">
    <Query>xbox</Query>
    <Section>
	<Separator title="My Text Suggestions"/>
	<Item>
		<Text>Xbox 360</Text>
		<Description>The official Xbox website from Microsoft</Description>
 		<Url>http://www.xbox.com</Url>
	</Item>
	<Item>
		<Text>Xbox cheats</Text>
		<Description>Codes and walkthroughs</Description>
		<Url>http://www.example.com/xboxcheatcodes.aspx</Url>
	</Item>
	<Item>
		<Text>Xbox 360 games</Text>
		<Description>Games and accessories</Description>
		<Url>http://www.example.com/games</Url>
	</Item>
	<Separator />
	<Item>
		<Text>xbox 360 lowest price</Text>
	</Item>
	<Item>
		<Text>xbox 360 news</Text>
	</Item>
    </Section>
</SearchSuggestion>

Le code ci-dessus produit le résultat suivant.

Figure 12. Suggestions de recherche XML avec un titre et des séparateurs de section personnalisés

Ajout de suggestions visuelles

Les suggestions de recherche sont généralement des expressions ou des termes proches du terme recherché par l'utilisateur. Dans Internet Explorer 8, elles peuvent inclure une chaîne de recherche, un lien ou une suggestion visuelle incluant une image. Votre moteur de recherche peut proposer des suggestions contenant uniquement du texte ou une image accompagnée de texte. Pour ajouter une suggestion visuelle aux réponses proposées, ajoutez un élément Image à l'élément Item de cette suggestion. Veillez à définir également les dimensions de l'image en largeur et en hauteur. Par exemple, pour proposer une suggestion visuelle pour le terme « Xbox », vous pouvez utiliser le code suivant :

 <Separator title="My Visual Suggestions" />
  <Item>
  	<Text>Xbox 360 Game Consoles</Text>
  	<Description>Game console systems and packages at a great deal.</Description>
  	<Image source="http://www.example.com/xboxconsole.jpg" alt="Xbox 360 Consoles" width="75" height="75"/> 
  	<Url>http://www.example.com/</Url>
  </Item>
  <Item>
  	<Text>Xbox 360 Wireless Controller</Text> 
  	<Image source="http://www.example.com/xboxcontroller.jpg" alt="Xbox 360 Wireless Controller" width="75" height="75"/> 
  </Item>
  <Item>
  	<Text>Xbox 360 Live Games</Text> 
  	<Image source="http://www.example.com/live.jpg" alt="Xbox 360 Live Games" width="75" height="75"/> 
  	<Url>http://www.example.com/games.aspx?q="Xbox 360"</Url> 
  </Item>

Le code précédent produit les résultats suivants.

Figure 13. Suggestions visuelles pour le terme « Xbox »

Cet exemple permet de proposer une URL accompagnée de deux suggestions. Internet Explorer 8 permet à l'utilisateur d'accéder directement à la page spécifiée par l'URL. Si aucune URL n'est proposée, la valeur de l'élément Text (« Xbox 360 Wireless Controller ») est utilisée comme terme recherché. Pour proposer une suggestion visuelle sans texte ni description, vous devez indiquer une URL pour qu'Internet Explorer 8 sache vers quelle adresse l'utilisateur doit être redirigé.

Par défaut, si vous incluez une image accompagnée de texte, ce dernier est centré verticalement en regard de l'image. En associant la valeur « top », « middle » ou « bottom » à l'attribut align, vous pouvez définir l'alignement des éléments Text et Description associés à l'image.

Pour aligner le texte, ajoutez l'attribut align à l'élément image. Dans l'exemple ci-dessous, l'attribut align a pour valeur « top ».

<Image source="http://www.example.com/xboxconsole.jpg" alt="Xbox 360 Consoles" width="75" height="75" align="top"/>

Gestion des erreurs

Dans certains cas, il est possible que vous n'ayez aucune suggestion à proposer pour le terme recherché ou que ce dernier ne soit pas reconnu. Vous devez cependant renvoyer une réponse XML valide, sans quoi les utilisateurs obtiendront un message d'erreur. Pour éviter cela, définissez une réponse XML valide qui sera retournée s'il n'y a aucune suggestion pour le terme recherché. L'extrait de code ci-dessous renvoie une réponse si aucune suggestion n'est disponible pour le terme « xbox ». Il permet d'afficher un message indiquant qu'il n'y a aucun résultat.

<?xml version="1.0"?>
<SearchSuggestion xmlns="https://schemas.microsoft.com/Search/2008/suggestions">
    <Query>xbox</Query>
</SearchSuggestion>

Pour une réponse au format JSON, utilisez le code suivant :

 ["xbox"]

Le message d'erreur peut également s'afficher alors que des suggestions sont disponibles. Si cela se produit, vérifiez le code de la requête. Par défaut, les termes recherchés sont codés en UTF-8 à l'aide de la méthode HTTP GET. Cela signifie que si l'utilisateur tape des caractères accentués, ils sont convertis en un équivalent ASCII (texte). Par exemple, le terme café est renvoyé sous la forme q=caf%c3%a9 car le e accentué a été remplacé par l'équivalent ASCII %c3%a9.

Remarque Les moteurs de recherche doivent utiliser la méthode de requête HTTP GET car la méthode POST n'est pas prise en charge.

Lorsque vous proposez une suggestion visuelle, vous devez indiquer la largeur et la hauteur de l'image. Si vous n'incluez pas ces valeurs, Internet Explorer 8 alloue un espace par défaut à l'image et la redimensionne en conséquence. La quantité d'espace par défaut utilisée dans ce cas est l'équivalent vertical d'une ligne de texte.

La zone Recherche instantanée peut être redimensionnée. Par conséquent, les dimensions du menu déroulant des suggestions de recherche sont variables. Pour connaître les dimensions de ce menu, vous pouvez ajouter des paramètres à l'URL du fichier de description OpenSearch. Les paramètres disponibles sont décrits ci-dessous.

Paramètre	Description
{maxWidth}	Largeur du menu déroulant en pixels.
{sectionHeight}	Hauteur totale de la section contenant les suggestions.
{rowHeight}	Hauteur correspondant à une ligne de texte.

L'exemple suivant montre ces paramètres ajoutés à l'URL du fichier de description OpenSearch.

<Url type="application/x-suggestions+xml" 
	template="http://suggestions.example.com/search.aspx?q={searchTerms}&amp;
	maxwidth={maxWidth}&amp;rowheight={rowHeight}&amp;sectionHeight={sectionHeight}" 
/>

L'image suivante identifie la zone correspondant à chaque paramètre.

Figure 14. Paramètres du menu Rechercher des suggestions

Identification de l'attribut referrer

L'extension OpenSearch Referrer Lien World Wide Web est prise en charge depuis la version 7 d'Internet Explorer. Lorsque l'utilisateur effectue une recherche, Internet Explorer ajoute un attribut « referrer » à la requête pour indiquer si cette dernière été lancée à partir de la zone Recherche instantanée ou de la barre d'adresses. Si la recherche a été lancée à partir de la zone Recherche instantanée, l'attribut « referrer » est associé à la valeur « IE-SearchBox ». Si elle a été lancée à partir de la barre d'adresses (par saisie au clavier ou au moyen d'un favori), l'attribut « referrer » est défini sur « IE-Address ».

Localisation de suggestions de recherche

Si vous proposez vos services dans plusieurs langues, vous pouvez ajouter l'attribut {Language} à la chaîne de requête afin de définir la langue dans laquelle les suggestions doivent être affichées. L'exemple ci-dessous indique comment obtenir des informations sur la langue de l'utilisateur :

<Url type="application/x-suggestions+xml" 
	template="http://suggestions.example.com/search.aspx?
	q={searchTerms}&amp;language={Language}" 
/>

Lorsqu'Internet Explorer demande des suggestions, il remplace {Language} par la langue définie dans les paramètres régionaux de l'utilisateur. Les paramètres régionaux du système peuvent être définis à l'aide du Panneau de configuration ou dans les paramètres de langue d'Internet Explorer (boîte de dialogue Options Internet).

Remarque Consultez la section « Gestion des erreurs » ci-dessus pour plus d'informations sur les codages de caractères pouvant avoir une incidence sur les réponses localisées.

Remarques

Gardez à l'esprit les points suivants :

Un site Web ne peut pas ouvrir automatiquement la boîte de dialogue Ajouter un moteur de recherche. Cette boîte de dialogue est verrouillée à l'aide d'un processus similaire à celui qui est utilisé par les bloqueurs de fenêtres publicitaires. Elle ne peut être ouverte que suite à une action de l'utilisateur.
Les titres doivent être courts et comprendre de préférence un maximum de 16 caractères. Cette chaîne est utilisée par la zone Recherche instantanée. Si le titre est plus long la zone de recherche, il est possible qu'il soit tronqué.
Le titre indiqué dans la balise link doit être identique à celui qui est utilisé dans le fichier de description XML. Le fait que ces chaînes soient identiques permet à la fonction de découverte de détecter si un moteur de recherche est déjà installé. Cela évite que la flèche vers le bas de la zone Recherche instantanée devienne orange et qu'un moteur de recherche déjà installé ne soit ajouté à la liste de découverte.
Si l'utilisateur restaure les paramètres par défaut d'Internet Explorer, tous les moteurs de recherche personnalisés sont supprimés.
Si vous utilisez des scripts pour ajouter un moteur de recherche, vous pouvez appeler la méthode d'assistance IsSearchProviderInstalled pour vérifier si un moteur est déjà installé ou non.
Lorsque vous créez un fichier de description, vous devez vous assurer que la syntaxe XML de ce fichier est valide, que tous les caractères des chaînes de requête sont codés et que tous les caractères « & » sont remplacés par « & ».
La zone Recherche instantanée peut être redimensionnée par les utilisateurs. Pour obtenir les dimensions du menu déroulant des suggestions de recherche dans Internet Explorer 8, vous pouvez ajouter des paramètres à l'URL du fichier XML de description OpenSearch.

Voir aussi

Spécification du format XML pour les suggestions de recherche (page éventuellement en anglais)
AddSearchProvider
IsSearchProviderInstalled (page éventuellement en anglais)
Ajouter des moteurs de recherche dans Internet Explorer
Description OpenSearch (page éventuellement en anglais)

Partager via