Visualisation d'une page Webjax
Ajax.Autocompleter(class)
Cet objet hérite de Autocompleter.Base() .
L'objet Ajax.Autocompleter() permet de mettre en place une recherche intuitive ou en anglais "autocompletion" à partir de données provenant d'un serveur distant.
Cet objet précise un élément de type 'input:text' dont on envoit la valeur à l'url serveur précisée.
Le retour de la requête http envoyée au serveur doit contenir la liste déroulante à présenter dans l'élément DOM précisé pour le retour du serveur.
La syntaxe d'appel de cet objet pourrait s'écrire de la forme suivante :
En raison de sa nature un peu spécifique, Ajax.Autocompleter supporte des options spécifiques
en plus de celles héritées de Autocompleter.Base() .
Le tableau d'options spécifiques est présenté ci après :
Nom de l'option
Type
Défaut
Détails
paramName
String
Attribut HTML 'name' de l'élément source de valeur précisé.
Permet de modifier le nom du paramètre envoyé au serveur.
minChars
Number
1
Option qui définit le nombre minimum de caractères à attendre en saisie
dans l'élément DOM texte précisé comme source de valeur, avant de lancer
la requête HTTP au serveur.
Cela permet d'éviter par exemple une surcharge serveur trop importante du
par exemple à la lenteur de certaines saisies qui provoqueraient des requêtes tous les
caractères (ndr : conséquences à envisager sur une base de millions d'enregistrements etc...)
indicator
String
Id de l'élément DOM image à afficher.
Option qui permet de définir un élément DOM image qui sera affiché pendant le temps de transmission
et de réception des résultats de la requête HTTP récupérant les résultats demandés.
L'objet utilise Element.show() puis Element.hide() afin de gérer l'affichage de l'élément DOM image.
updateElement (item_li_selected)
Function Callback
item_li_selected : identifiant de l'élément 'li' sélectionné
Méthode dite de 'callback' qui permet de définir un événement avec la possibilité
d'utiliser l'identifiant de l'élément DOM 'li' sélectionné.
afterUpdateElement (input_text , item_li_selected)
Function Callback
input_text : champ input autorempli (ndr : 'autocomplété')
item_li_selected : identifiant de l'élément 'li' sélectionné
Méthode dite de 'callback' qui est appellée suite au remplissage des éléments 'li' (ndr : différence
avec la méthode précédente de ce tableau).
Les exemples d'utilisation sont présentés sur la page Ajax.Autocompleter().
L'objet Ajax.Autocompleter() permet de mettre en place une recherche intuitive ou en anglais "autocompletion" à partir de données provenant d'un serveur distant.
Cet objet précise un élément de type 'input:text' dont on envoit la valeur à l'url serveur précisée.
Le retour de la requête http envoyée au serveur doit contenir la liste déroulante à présenter dans l'élément DOM précisé pour le retour du serveur.
La syntaxe d'appel de cet objet pourrait s'écrire de la forme suivante :
En raison de sa nature un peu spécifique, Ajax.Autocompleter supporte des options spécifiques en plus de celles héritées de Autocompleter.Base() .
Le tableau d'options spécifiques est présenté ci après :
| Nom de l'option | Type | Défaut | Détails |
| paramName | String | Attribut HTML 'name' de l'élément source de valeur précisé. | Permet de modifier le nom du paramètre envoyé au serveur. |
| minChars | Number | 1 |
Option qui définit le nombre minimum de caractères à attendre en saisie
dans l'élément DOM texte précisé comme source de valeur, avant de lancer
la requête HTTP au serveur.
Cela permet d'éviter par exemple une surcharge serveur trop importante du par exemple à la lenteur de certaines saisies qui provoqueraient des requêtes tous les caractères (ndr : conséquences à envisager sur une base de millions d'enregistrements etc...) |
| indicator | String | Id de l'élément DOM image à afficher. |
Option qui permet de définir un élément DOM image qui sera affiché pendant le temps de transmission
et de réception des résultats de la requête HTTP récupérant les résultats demandés.
L'objet utilise Element.show() puis Element.hide() afin de gérer l'affichage de l'élément DOM image. |
| updateElement (item_li_selected) | Function Callback | item_li_selected : identifiant de l'élément 'li' sélectionné | Méthode dite de 'callback' qui permet de définir un événement avec la possibilité d'utiliser l'identifiant de l'élément DOM 'li' sélectionné. |
| afterUpdateElement (input_text , item_li_selected) | Function Callback |
input_text : champ input autorempli (ndr : 'autocomplété')
item_li_selected : identifiant de l'élément 'li' sélectionné |
Méthode dite de 'callback' qui est appellée suite au remplissage des éléments 'li' (ndr : différence avec la méthode précédente de ce tableau). |
Les exemples d'utilisation sont présentés sur la page Ajax.Autocompleter().
: 09/01/2007 20:23:17 | 
: Scriptaculous, Scriptaculous.js, Ajax, Ajax.Autocompleter, Autocompleter, Autocompleter.Base, Autocompleter.Local, autocompletion, recherche, intuitive, 
