<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.
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] ...
;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
function_ini
[field_name]
...
;défaut : ''
function_ini=my_function
Définition d'une fonction qui va générer dynamiquement le tableau associatif php issu normalement du parsing du fichier ini défini dans la section ini.
Cette fonction (si définie) prime sur l'utilisation du fichier ini contenu :
- Soit dans le dossier défini dans folder_ini.
- Soit dans le dossier défaut form_name/ini.
folder_ini
[field_name]
...
;défaut : ''
folder_ini=dossier 1/dossier 2...
Dossier (Pas de / à la fin) contenant le fichier ini des différentes options.
Voir attribut ini pour le nom du fichier. Ce fichier (si défini) prime sur celui contenu dans le dossier défaut form_name/ini.
Le dossier dossier 1 de départ doit se trouver à la racine du serveur.
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 : 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=http://www.mon-site.com/my-image.png.png
[mc_2]
option=Case 2
value=value2
checked=1
icon=http://www.mon-site.com/my-image.png.png
[mc_3]
option=Case 3
value=value3
checked=1
icon=http://www.mon-site.com/my-image.png.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 : Url de l'image devant la case (Optionnel).
- ext : png, gif, jpg, ...
- Dimension : 16px × 16px (Si l'image est plus grande, elle sera redimensionnée).
label
[field_name]
...
;défaut : ''
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 dans les options du formulaire
col_label
[field_name]
...
;défaut : 1
col_label=0
La colonne label ne sera pas affichée.
Si le texte de l'attribut label est défini, il sera ignoré.
A la différence de l'option col_label qui concerne tous les champs du formulaire, l'attribut col_label ne concerne que le champ courant.
heading_group
[field_name]
...
;défaut : ''
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]
...
;défaut : ''
group_marge=30px
Marge gauche (syntaxe CSS) d'un groupe de champs commutable.
Uniquement avec mod :
- group_switch_start
- group_switch_start_end
text_before_data
[field_name]
...
;défaut : ''
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]
...
;défaut : ''
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]
...
;défaut : ''
text_top=Texte affiché au dessus du champ
text_bottom
[field_name]
...
;défaut : ''
text_bottom=Texte affiché au-dessous du champ
height
[field_name]
...
;défaut : ''
height=100px
Syntaxe CSS.
Hauteur du bloc fieldset contenant les cases.
width
[field_name]
...
;défaut : ''
width=100px
Syntaxe CSS.
Largeur du bloc fieldset contenant les cases.
marge
[field_name]
...
;défaut : ''
marge=30px
syntaxe CSS.
Marge à gauche du bloc fieldset.
col
[field_name]
...
;défaut : ''
col=10em
syntaxe CSS.
Les cases seront affichées en colonne (largeur col) au lieu d'une case par ligne (défaut).
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.
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_all="J'inverse tout"
Texte personnalisé du lien « Inverser sélection ».
sep_link_select
[field_name]
...
;défaut : |
sep_link_select=–
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 de cases cochées.
class
[field_name]
...
;défaut : ''
class=class1 class2
Class appliquée sur le bloc fieldset.
Si plusieurs class, les séparer par un espace.
<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.
<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]
...
;défaut : ''
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]
...
;défaut : ''
maxlength=3
Utilisé avec jQuery Validation Plugin.
<fieldset id="field_name">
<legend>multi_check</legend>
<input maxlength="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>
rangelength
[field_name]
...
;défaut : ''
rangelength=3,5
Les [ ] seront ajoutés automatiquement.
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
[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.
Source : http://nonoweb.net/phpmyform-champ-de-type-multi-check