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);
...

fr/doc/pxxo_widget_input_tag.txt · Dernière modification: 2012/01/14 00:12 (édition externe)