Pxxo_Widget_Input_Select

Affiche une liste déroulante avec une aide ergonomique pour la sélection multiple.

Remarque : Ce widget peut-être utilisé tout seul mais en général il est directement utilisé par le widget Form.

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
value Array array() Contient la liste des éléments à pré-sélectionner. En mode multiple cette liste peut contenir plusieurs valeurs.
options Array array() Contient la liste des valeurs que l'on peut potentiellement sélectionner (clé/valeur = id interne/label)
optgroups Array array() Contient la liste des clés présentes dans le paramètre options qui serviront de titres pour grouper les éléments de la liste. (depuis la version 1.0.10)
multiple Bool false Permet d'afficher ou non la liste déroulante en mode sélection multiple
size Integer - détermine le nombre de ligne affichées en hauteur
jQueryMode Boolean true Utilise ou non jquery pour améliorer l'ergonomie du select en mode multiple

Exemples

Affiche une liste déroulante simple :

require_once "Pxxo/Widget/Form.php";
$params['inputs'] = array();
$params['inputs'][] = array('id'       => 'id_de_mon_select',
                            'label'    => 'Un champ select',
                            'type'     => 'select',
                            'value'    => array('cle3'),
                            'options'  => array('cle1'=>'France', 'cle2'=>'Angleterre', 'cle3'=>'Allemagne'),
                            'required' => true,
                            );
$o = new Pxxo_Widget_Form($params);
...

Affiche une liste déroulante avec sélection multiple :

require_once "Pxxo/Widget/Form.php";
$params['inputs'] = array();
$params['inputs'][] = array('id'       => 'id_de_mon_select2',
                            'label'    => 'Un champ select',
                            'type'     => 'select',
                            'value'    => array('cle1', 'cle3'),
                            'options'  => array('cle1'=>'France', 'cle2'=>'Angleterre', 'cle3'=>'Allemagne'),
                            'multiple' => true,
                            'required' => true,
                            'size' => 6,
                            );
$o = new Pxxo_Widget_Form($params);
...

Affiche des sections (sous-titres) dans la liste déroulante :

require_once "Pxxo/Widget/Form.php";
$params = array();
$params['inputs'] = array();
$params['inputs'][] = array('id'       => 'my_id',
                            'label'    => 'Un champ select',
                            'type'     => 'select',
                            'value'    => array('lyon'),
                            'options'  => array('europe' => 'Villes d\'Europe',
                                                'paris' => 'Paris',
                                                'lyon' => 'Lyon',
                                                'marseille' => 'Marseille',
                                                'orient' => 'Villes du Moyen Orient',
                                                'beyrouth' => 'Beyrouth',
                                                'istanbul' => 'Istanbul',
                                                'jerusalem' => 'Jérusalem',
                                                ),
                            'optgroups' => array('europe', 'orient'),
                            ); 
$o = new Pxxo_Widget_Form($params);
fr/doc/pxxo_widget_input_select.txt · Dernière modification: 2009/09/08 16:36 par kerphi
 
 

©2003-2010 Pxxo

Partenaires : INIST-CNRS | Sourcesup | Web2.0 chat server | Micropolia | Jeux gratuits | Areno