Champ de type « select »
<select 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 select.
Seul l'attribut field_type est requis.
Note : Si les autres attributs ne sont pas définis, la valeur défaut est prise en compte.
field_type
[field_name]
field_type=select
...
Ces deux lignes du fichier form_definition.ini sont les seules requises.
mod
[field_name]
...
;valeur 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
ini
[field_name]
...
;défaut : field_name.ini
ini=my_file
- Nom fichier ini sans extension contenant les options.
- Fichier ini dans le dossier phpMyForm/form/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.
[to_select]
option=--- Sélectionner une 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
...
[custom]
option=--- Valeur personnalisée ---
Description des sections du fichier ini
- Section [to_select]
- option : Si on ne veut pas d'option sélectionnée d'office.
- 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.
- Section [custom]
- option : Si omis, valeur defaut : Valeur personnalisée
custom_field
[field_name]
...
;ID d'un champ text ou textarea.
custom_field=field_name_01
Le champ text (ou textarea) doit avoir l'attribut custom à 1.
;exemple :
[select01]
field_type=select
custom_field=select_custom01
...
[select_custom01]
field_type=text
custom=1
...
Voir un exemple de champ select personnalisé
default
[field_name]
...
;Valeur défaut du champ.
default=value default
Affiche un bouton qui permet restaurer la valeur par défaut (si définie).
label
[field_name]
...
label=Texte du label
Texte affiché dans partie gauche (*)
Uniquement avec mod :
- default
- switch
- group_start
(*) Voir les différentes options (col_label et pos_label) d'affichage du label : Définition formulaire
heading_group
[field_name]
...
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
group_marge
[field_name]
...
;syntaxe CSS
group_marge=30px
Marge gauche d'un groupe de champs commutable.
Uniquement avec mod :
- group_switch_start
- group_switch_start_end
group_hidden
[field_name]
...
;défaut : 0
group_hidden=1
Le groupe de champs commutable sera désactivé et non visible.
Uniquement avec mod switch.
text_before_data
[field_name]
...
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
text_after_data
[field_name]
...
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
text_top
[field_name]
...
text_top=Texte affiché au dessus du champ
text_before
[field_name]
...
text_before=Texte affiché devant le champ
text_after
[field_name]
...
text_after=Texte affiché après le champ
text_bottom
[field_name]
...
text_bottom=Texte affiché au-dessous du champ
image
[field_name]
...
;Affichée devant le champ.
image=my_image.png
- extension : png, gif, jpg, ...
- Dimension : 24px × 24px
- Dans le dossier : phpMyForm/form/form_name/images/24x24.
class
[field_name]
...
;Un (ou plusieurs) nom(s) de class.
;Si plusieurs class, les séparer par un espace.
class=class1 class2
<select 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]
...
;Un (ou plusieurs) nom(s) de class.
;Si plusieurs class, les séparer par un espace.
class_opt=class1 class2
<select 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]
...
;syntaxe CSS
style="border: 1px solid green; background-color: red;"
Le ; est obligatoire à la fin (en cas d'ajout de style par le script).
<select 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
<select 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>
rules
Définition des règles de validation du formulaire : Règles de validation