ScrutariSuggestion

ScrutariSuggestion est une extension de la bibliothèque JQuery qui permet de suggérer des mots-clés lorsque l'internaute utilise un champ de recherche. Cette extension interroge le serveur Scrutari en lui soumettant les caractères que l'utilisateur est en train de saisir et le serveur retourne les mots-clés qui les contiennent. L'extension affiche alors les mots-clés sous forme d'une liste. Si l'utilisateur sélectionne un des mots-clés de la liste, celui est placé dans le champ de recherche entre guillemets, l'internaute peut alors valider la recherche.

ScrutariSuggestion doit beaucoup à l'extension Autocomplete de Jörn Zaefferer, qu'il en soit remercié. Comme Autocomplete, ScrutariSuggestion est sous double licence MIT et GPL.

Installation

Cette extension nécessite JQuery (testé avec 1.3 et 1.4) ainsi que les extensions AjaxQueue et éventuellement Bgiframe pour la compatibilité avec Internet Explorer 6. Ces différents fichiers sont disponibles sur à l'adresse http://jquery.exemole.fr/

Il suffit d'ajouter les lignes suivantes :

<script src="http://jquery.exemole.fr/jquery-1.4.2.min.js" type="text/javascript"></script>
<script src="http://jquery.exemole.fr/jquery.ajaxqueue-1.0.js" type="text/javascript"></script>
<script src="http://jquery.exemole.fr/jquery.bgiframe-2.1.1.min.js" type="text/javascript"></script>
<script src="http://jquery.exemole.fr/jquery.scrutarisuggestion-1.0.js" type="text/javascript"></script>

Note : pour un site en production, il est conseillé de faire ses propres copies des fichiers.

Par ailleurs, dans le répertoire http://jquery.exemole.fr/jquery.scrutarisuggestion-1.0/, se trouvent deux fichiers : jquery.scrutarisuggestion.css et sctsug_indicator.gif. jquery.scrutarisuggestion.css contient les instructions de mise en forme de la liste de mots-clés. Ce fichier doit être récupéré et adapté à la charte du site, on peut aussi copier son contenu dans une feuille de style existante. Toutes les classes définies par ce fichier commence par « sctsugg_ ». sctsug_indicator.gif est une image placée par la feuille de style dans le champ de saisie pour indiquer qu'une recherche est en cours.

Configuration

La configuration minimale est la suivante. En prenant l'hypothèse que votre champ de recherche a comme identifiant CHAMP_RECHERCHE et que votre serveur Scrutari est accessible à l'adresse http://monsite.net/sct/monserveur//, il suffit d'ajouter les lignes suivantes dans une balise <script> : <code html> $(function() { $(“#CHAMP_RECHERCHE”).scrutarisuggestion(“http://monsite.net/sct/monserveur/JSon”); }); </code> $(function() est le raccourci de JQuery pour les instructions à lancer à la fin du chargement par le navigateur. L'extension ScrutariSuggestion a rajouté la méthode scrutarisuggestion à l'objet JQuery standard. Cette méthode prend au moins un argument qui est l'URL d'interrogation du protocole JSon du serveur (donc, ne pas oublier de rajouter /Json après l'adresse de votre serveur.