Pxxo_Widget_Input_Tag
Affiche un champ de saisie particulièrement bien adapter à la sélection d'étiquettes textuelles (tags). Les étiquettes ou tag sont de chaines de caractères associées ou non à un identifiant. L'internaute peut choisir une étiquette pré existante à l'aide d'une liste déroulante ou bien saisir sa propre étiquette si elle n'existe pas dans la liste.
Remarque : Ce widget peut-être utilisé tout seul mais en général il est directement utilisé par le widget Form.
Copie d'écran :
Paramètres
Ce widget partage une liste de paramètres génériques communs à tous les widgets Input. Veuillez consulter la documentation du widget Input pour connaître la liste des paramètres génériques.
Voici les paramètres spécifiques pour ce widget :
| Nom | Type | Valeur par défaut | Description |
|---|---|---|---|
| size | Array | array() | Taille (Size * 10 ~= largeur en pixel) |
| message | String | '' | Message d'aide qui s'affiche sous le champ de saisie |
| complete_callback | Callback | null | Callback permettant d'auto compléter le champ. Elle reçoit en entrée le mot saisie par l'internaute et retour un tableau associatif PHP de type clé, valeur |
| ajax_url | string | '?' | Url à utiliser pour générer l'appel ajax à la callback |
Si on utilise des données en provenance de la liste produite par la callback, on récupère non pas la valeur d'une ligne du tableau mais sa clé.
Exemple
require_once "Pxxo/Widget/Form.php"; require_once "Pxxo/Widget/Form.php"; $params = array(); $params['inputs'] = array(); $params['inputs'][] = array('id' => 'my_id', 'label' => 'Tags', 'type' => 'tag', 'value' => array('truc', 'bidule'), 'required' => true, 'size' => 35, 'message' => 'Choisir des régions ou des départements', 'complete_callback' => 'autocomplete_callback', ); function autocomplete_callback($tag) { return array( "Lorraine", "Alsace", '55' => 'Meuse', '54' => 'Meurthe et Moselle', ); } $o = new Pxxo_Widget_Form($params); ...