Présentation
Le tag AutoComplete vous permet de faire un "input" pour votre formulaire qui bénéficiera de l'autocompletion, facilement paramétrable.
Forme Smarty
{*avec view*}
{autocomplete dao="ma_table" field="caption" view="caption;champ1;champ2"}
{*sans view*}
{autocomplete dao="ma_table" field="caption"}
Forme PHP
Paramétrage
Seuls deux paramètres sont obligatoires :
- dao
- field
la source de données pour l'autocompletion : datasource
Le tag autocomplete utilise des "datasources" comme sources de données. Par défaut, le datasource est positionné à "dao" pour indiquer que la source de données est un DAO.
Aujourd'hui, seul le datasource "dao" est pris en compte.
le DAO à utiliser : dao
Pour spécifier le DAO, il suffit de donner un paramètre "dao" au tag.
exemple :
{autocomplete dao="ma_table" field="caption"}
Spécifier une connexion autre que celle par défaut avec ct
Si vous utilisez un DAO comme source de données (datasource), vous pouvez demander à Copix d'utiliser une connexion différente de celle par défaut avec le paramètre optionnel ct.
{autocomplete dao="ma_table" field="caption" ct="nom_connexion"}
le champ à utiliser : field
Pour spécifier à quel champ se rapporte l'autocompletion, vous utiliserez le paramètre "field".
Indiquer les champs visibles dans l'autocompletion
Le paramètre "view" permet d'indiquer les champs que l'on souhaites voir lors de l'autocompletion. Pour spécifier les champs, il suffit d'en faire une liste séparée par des points virgules ";".
Nombre de caractères pour déclencher l'autocompletion
Par défaut, l'autocompletion est déclenchée dès la saisie du premier caractère. Si vous souhaitez modifier ce comportement, vous pouvez le faire en spécifiant le paramètre "length".
//La completion ne se déclenchera qu'au bout de 3 caractères
{autocomplete dao="ma_table" field="caption" length="3"}