Champ de type « multi_check »
<fieldset id="field_name">
<legend>multi_check</legend>
<input name="field_name[]" id="field_name_0" type="checkbox" value="value1" />Case 1
<input name="field_name[]" id="field_name_1" type="checkbox" value="value2" />Case 2
<input name="field_name[]" id="field_name_2" type="checkbox" value="value3" />Case 3
<input name="field_name[]" id="field_name_3" type="checkbox" value="value4" />Case 4
...
</fieldset>
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_check.
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=multi_check
...
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 : mc est obligatoire.
Le reste suivant mc est libre, mais doit-être différent pour chaque case checkbox.
[mc_1]
option=Case 1
value=value1
checked=1
icon=test16.png
[mc_2]
option=Case 2
value=value2
checked=1
icon=test16.png
[mc_3]
option=Case 3
value=value3
checked=1
icon=test16.png
...
Description des sections du fichier ini
- Section [mc...]
- value : Attribut value de la case checkbox. Si omis une value du type field_name_checkbox_value_n est générée automatiquement.
- option : Libellé de la case. Si omis, la valeur de value est utilisée.
- checked
- 0 : Défaut
- 1 : la case sera initialement cochée par défaut.
- icon : Image devant la case.
- ext : png, gif, jpg, ...
- Dimension : 16px × 16px.
- Dans le dossier phpMyForm/form/form_name/images/16x16.
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
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_bottom
[field_name]
...
text_bottom=Texte affiché au-dessous du champ
height
[field_name]
...
;Hauteur du bloc (fieldset) contenant les cases.
;syntaxe CSS
height=100px
width
[field_name]
...
;Largeur du bloc (fieldset) contenant les cases.
;syntaxe CSS
width=100px
marge
[field_name]
...
;Marge à gauche du bloc (fieldset).
;syntaxe CSS
marge=30px
col
[field_name]
...
;Les cases seront affichées en colonne (largeur col) au lieu d'une case par ligne (défaut)
;syntaxe CSS
col=10em
border
[field_name]
...
;défaut : 1
border=0
Bordure autour du bloc de checkbox.
link_check
[field_name]
...
;défaut : 0
link_check=1
Affiche les liens « Tout sélectionner | Sélectionner aucun | Inverser sélection » au dessus du bloc de checkbox.
number_check
[field_name]
...
;défaut : 0
number_check=1
Affiche le nombre de cases cochées.
class
[field_name]
...
;Un (ou plusieurs) nom(s) de class.
;Si plusieurs class, les séparer par un espace.
class=class1 class2
<fieldset class="class1 class2" id="field_name">
<legend>multi_check</legend>
<input name="field_name[]" id="field_name_0" type="checkbox" value="value1" />Case 1
<input name="field_name[]" id="field_name_1" type="checkbox" value="value2" />Case 2
<input name="field_name[]" id="field_name_2" type="checkbox" value="value3" />Case 3
<input name="field_name[]" id="field_name_3" type="checkbox" value="value4" />Case 4
...
</fieldset>
required
[field_name]
...
;défaut : 0
required=1
Utilisé avec jQuery Validation Plugin ou validation HTML5.
<fieldset id="field_name">
<legend>multi_check</legend>
<input required data-pmf-multi="field_name" name="field_name[]" id="field_name_0" type="checkbox" value="value1" />Case 1
<input name="field_name[]" id="field_name_1" type="checkbox" value="value2" />Case 2
<input name="field_name[]" id="field_name_2" type="checkbox" value="value3" />Case 3
<input name="field_name[]" id="field_name_3" type="checkbox" value="value4" />Case 4
...
</fieldset>
minlength
[field_name]
...
minlength=3
Utilisé avec jQuery Validation Plugin.
<fieldset id="field_name">
<legend>multi_check</legend>
<input minlength="3" data-pmf-multi="field_name" name="field_name[]" id="field_name_0" type="checkbox" value="value1" />Case 1
<input name="field_name[]" id="field_name_1" type="checkbox" value="value2" />Case 2
<input name="field_name[]" id="field_name_2" type="checkbox" value="value3" />Case 3
<input name="field_name[]" id="field_name_3" type="checkbox" value="value4" />Case 4
...
</fieldset>
maxlength
[field_name]
...
maxlength=5
Utilisé avec jQuery Validation Plugin.
<fieldset id="field_name">
<legend>multi_check</legend>
<input maxlength="5" data-pmf-multi="field_name" name="field_name[]" id="field_name_0" type="checkbox" value="value1" />Case 1
<input name="field_name[]" id="field_name_1" type="checkbox" value="value2" />Case 2
<input name="field_name[]" id="field_name_2" type="checkbox" value="value3" />Case 3
<input name="field_name[]" id="field_name_3" type="checkbox" value="value4" />Case 4
...
</fieldset>
rangelength
[field_name]
...
;Les [ ] seront ajoutés automatiquement.
rangelength=3,5
Utilisé avec jQuery Validation Plugin.
<fieldset id="field_name">
<legend>multi_check</legend>
<input rangelength="[3,5]" data-pmf-multi="field_name" name="field_name[]" id="field_name_0" type="checkbox" value="value1" />Case 1
<input name="field_name[]" id="field_name_1" type="checkbox" value="value2" />Case 2
<input name="field_name[]" id="field_name_2" type="checkbox" value="value3" />Case 3
<input name="field_name[]" id="field_name_3" type="checkbox" value="value4" />Case 4
...
</fieldset>
rules
Définition des règles de validation du formulaire : Règles de validation