NonoWeb > phpMyForm : Champ de type « multi

<select multiple="multiple" name="field_name[]" id="field_name">
     <option value="value1">Option 1</option>
     <option value="value2">Option 2</option>
     <option value="value3">Option 3</option>
     ...
</select>

Le code HTML est indiqué pour information. Il est généré automatiquement par le script phpMyForm.

Attributs

Description des divers attributs possibles pour le champ de type multi_select.

Seul l'attribut field_type est requis.

Si les autres attributs ne sont pas définis, la valeur défaut est prise en compte.

field_type

[field_name]
field_type=multi_select
...

Ces deux lignes du fichier form_definition.ini sont les seules requises.

mod

[field_name] ...
;défaut : default
mod=group_start

Valeurs possibles :

default
group_start
group_start_end
group_inside
group_end
switch (field_type : checkbox, radio, select)
group_switch_start
group_switch_start_end

mod description

ini

[field_name]
...
;défaut : field_name.ini
ini=my_file

Nom fichier ini sans extension contenant les options.
Fichier ini dans le dossier form_name/ini.

Structure du fichier ini

Sections du fichier ini : select est obligatoire.
Le reste suivant select est libre, mais doit-être différent pour chaque option.

[select_1]
option=option 1 
value=value1 

[select_2]
group_start=Nom groupe 
option=option 2 
value=value2 

[select_3]
option=option 3 
value=value3 

[select_4]
group_end="/optgroup"
option=option 4 
value=value4 

[select_5]
option=option 5 
value=value5 

[select_6]
option=option 6 
value=value6 

...

Description des sections du fichier ini

Section [select...]
- value : Attribut value de <option>. Si omis une value du type field_name_option_value_n est générée automatiquement.
- option : Si omis, la valeur de value est utilisée.
- group_start : dans la 1ère option du groupe (nom du groupe).
- group_end : /optgroup dans la dernière option du groupe.

label

[field_name]
...
;defaut : ''
label=Texte du label

Texte affiché dans partie gauche (*)

Uniquement avec mod :

default
switch
group_start

mod description

(*) Voir les différentes options (col_label et pos_label) d'affichage du label dans les options du formulaire.

heading_group

[field_name]
...
;defaut : ''
heading_group=Lorem ipsum dolor sit amet, consectetur adipisicing elit.

Texte affiché au dessus du 1er champ d'un groupe.

Uniquement avec mod :

group_start
group_start_end
group_switch_start
group_switch_start_end

mod description

group_marge

[field_name]
...
;defaut : ''
group_marge=30px

Marge gauche (syntaxe CSS) d'un groupe de champs commutable.

Uniquement avec mod :

group_switch_start
group_switch_start_end

mod description

text_before_data

[field_name]
...
;defaut : ''
text_before_data=Lorem ipsum dolor sit amet, consectetur adipisicing elit.

Texte affiché en haut du bloc data.

Uniquement avec mod :

default
switch
group_start

mod description

text_after_data

[field_name]
...
;defaut : ''
text_after_data=Lorem ipsum dolor sit amet, consectetur adipisicing elit.

Texte affiché en bas du bloc data.

Uniquement avec mod :

default
group_switch_start_end
group_end

mod description

text_top

[field_name]
...
;defaut : ''
text_top=Texte affiché au dessus du champ

text_bottom

[field_name]
...
;defaut : ''
text_bottom=Texte affiché au-dessous du champ

height

[field_name]
...
height=100px

Syntaxe CSS.

<select multiple="multiple" style="height: 100px;" name="field_name[]" id="field_name">
     <option value="value1">Option 1</option>
     <option value="value2">Option 2</option>
     <option value="value3">Option 3</option>
     ...
</select>

size

[field_name]
...
;défaut : ''
size=6

<select multiple="multiple" size="6" name="field_name[]" id="field_name">
     <option value="value1">Option 1</option>
     <option value="value2">Option 2</option>
     <option value="value3">Option 3</option>
     ...
</select>

Attribut HTML size

marge

[field_name]
...
;défaut : ''
marge=30px

Marge à gauche de la liste.

syntaxe CSS.

link_check

[field_name]
...
;défaut : 0
link_check=1

Affiche les liens « Tout sélectionner | Sélectionner aucun | Inverser sélection » au dessus de la liste select.

txt_select_all

[field_name]
...
;défaut : Tout sélectionner
txt_select_all=Je coche tout

Texte personnalisé du lien « Tout sélectionner ».

txt_select_any

[field_name]
...
;défaut : Sélectionner aucun
txt_select_any=Je coche rien

Texte personnalisé du lien « Sélectionner aucun ».

txt_select_invert

[field_name]
...
;défaut : Inverser sélection
txt_select_invert="J'inverse tout"

Texte personnalisé du lien « Inverser sélection ».

sep_link_select

[field_name]
...
;défaut : |
sep_link_select=–

Caractère personnalisé de séparation des liens « Tout sélectionner | Sélectionner aucun | Inverser sélection ».

Laisser vide si on ne veut pas de caractère de séparation (Il y aura un espace par défaut).

number_check

[field_name]
...
;défaut : 0
number_check=1

Affiche le nombre d'options sélectionnées.

class

[field_name]
...
class=class1 class2

Si plusieurs class, les séparer par un espace.

<select multiple="multiple" class="class1 class2" name="field_name[]" id="field_name">
     <option value="value1">Option 1</option>
     <option value="value2">Option 2</option>
     <option value="value3">Option 3</option>
     ...
</select>

class_opt

[field_name]
...
class_opt=class1 class2

Si plusieurs class, les séparer par un espace.

<select multiple="multiple" name="field_name[]" id="field_name">
     <option class="class1 class2" value="value1">Option 1</option>
     <option class="class1 class2" value="value2">Option 2</option>
     <option class="class1 class2" value="value3">Option 3</option>
     ...
</select>

style

[field_name]
...
;defaut : ''
style="border: 1px solid green; background-color: red;"

Syntaxe CSS.

Le ; est obligatoire à la fin (en cas d'ajout de style par le script).

<select multiple="multiple" style="border: 1px solid green; background-color: red;" name="field_name[]" id="field_name">
     <option value="value1">Option 1</option>
     <option value="value2">Option 2</option>
     <option value="value3">Option 3</option>
     ...
</select>

required

[field_name]
...
;défaut : 0
required=1

Attribut HTML required

Utilisé avec jQuery Validation Plugin ou validation HTML5.

<select multiple="multiple" required name="field_name[]" id="field_name">
     <option value="value1">Option 1</option>
     <option value="value2">Option 2</option>
     <option value="value3">Option 3</option>
     ...
</select>

minlength

[field_name]
...
;défaut : ''
minlength=3

Utilisé avec jQuery Validation Plugin.

<select multiple="multiple" minlength="3" name="field_name[]" id="field_name">
     <option value="value1">Option 1</option>
     <option value="value2">Option 2</option>
     <option value="value3">Option 3</option>
     ...
</select>

maxlength

[field_name]
...
;défaut : ''
maxlength=5

Utilisé avec jQuery Validation Plugin.

<select multiple="multiple" maxlength="5" name="field_name[]" id="field_name">
     <option value="value1">Option 1</option>
     <option value="value2">Option 2</option>
     <option value="value3">Option 3</option>
     ...
</select>

rangelength

[field_name]
...
;défaut : ''
rangelength=3,5

Utilisé avec jQuery Validation Plugin.

Les [ ] seront ajoutés automatiquement.

<select multiple="multiple" rangelength="[3,5]" name="field_name[]" id="field_name">
     <option value="value1">Option 1</option>
     <option value="value2">Option 2</option>
     <option value="value3">Option 3</option>
     ...
</select>

rules

[field_name]
...
rules.rule1.value=rule1_value
rules.rule1.message=rule1_message
rules.rule2.value=rule2_value
rules.rule2.message=rule2_message
...

Définition des règles de validation du champ.

Règles de validation

Source : http://nonoweb.net/phpmyform-champ-de-type-multi-select