phpMyForm : 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.

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 :

mod description


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 :


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

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


label

[field_name]
...
;défaut : ''
label=Texte du label

Texte affiché dans partie gauche (*)

Uniquement avec mod :

mod description

(*) 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 :

mod description


group_marge

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

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

Uniquement avec mod :

mod description


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 :

mod description


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 :

mod description


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.


[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 ».


[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

Attribut HTML required

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.

Règles de validation