Différences
Ci-dessous, les différences entre deux révisions de la page.
|
clients:sctsugg [2010/05/08 17:03] vincent |
clients:sctsugg [2013/04/05 17:12] |
||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| - | ====== 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 [[http://bassistance.de/jquery-plugins/jquery-plugin-autocomplete/|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 : | ||
| - | |||
| - | <code html> | ||
| - | <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> | ||
| - | </code> | ||
| - | |||
| - | **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. | ||
