NonoWeb > phpMyForm : Champ de type « multi

<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

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 :

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

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]
...
;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

mod description

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

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 :

default
switch
group_start

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 :

default
group_switch_start_end
group_end

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.

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

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

Source : https://www.nonoweb.net/phpmyform-champ-de-type-multi-check