Doc Saisies complémentaire

-  [exemples exemples de création de boutons radio et de menus select->#radio] select
-   autres saisies
-   [CSS  : mettre 2 saisies côte-à-côte->css]
- autres saisies
- CSS : mettre 2 saisies côte-à-côte
- vérifications de la conformité des valeurs saisies
-  Saisies « autonomes »

----
[radio<-]
----------------

Boutons radios et Sélections

La doc n’indique pas comment créer les options des select ou les différents boutons radio d’un ensemble, mais le log ainsi que les fichiers sources donnent des exemples :

Pour les saisies « boutons radio »

[(#SAISIE{radio, afficher_liste,
	label=<:plugin:afficher_liste:>,
	explication=<:plugin:explication_afficher_liste:>,
	datas=#ARRAY{
		cle1,valeur1,
		cle2,valeur2,
		cle3,valeur3} 
})] cle3,valeur3 }})] 


&#91;(#SAISIE{radio ,  maintenance} &#91;(#SAISIE{radio,maintenance} 
	{label=Durée de maintenance}
	{defaut=12}
	{datas=#ARRAY{
		12 12,12  mois , 12  24,24  mois,
		24 ,  24  36,36  mois,
		36 ,  36  mois} 
	} 
)] 
 }})]
 

Pour les saisies « select »

<code >
 [(#SAISIE{selection ,  maintenance} [(#SAISIE{selection,maintenance} 
	{label=Durée de maintenance}
	{option_intro=Sélectionnez la durée de maintenance}
	{defaut=12}
	{datas=#ARRAY{
		12 12,12  mois , 12  24,24  mois,
		24 ,  24  36,36  mois,
		36 ,  36  mois} 
	} 
)] 
 }})]
 

----
[autres<-]
----------------

Autres saisies

Il y a moultes saisies dans le plugin, fort utiles dans certains cas :

• 
  -   explication : cette saisie ne saisit rien, mais présente un texte d’explication
• 
  -   choix d’un n° d’article original (qui n’est pas une traduction)
  -* - choix d’une rubrique existante
• 
  -   choix de la langue
• 
  -   choix d’un article à l’intérieur d’une rubrique
• 
  -   choix d’un secteur
• ...
  _...

Certains font appel aux « selecteurs » définis dans SPIP Bonux Certains font appel aux «  selecteurs  » définis dans BONUX et font un ample usage d’ajax pour faciliter la sélection, par navigation arborescente dans les rubriques par exemple.

----
[css<-]
<a name=’css’></a >
----------------

CSS : mettre 2 saisies côte-à-côte

Par défaut, des # SAISIES successives sont affichées les unes sous les autres. (propriété < code>clear:both ;</code > clear:both sur les <li> définie dans habillage.css).

Pour faire apparaître une saisie à droite d’une autre, sur la même ligne, il faut surcharger les propriétés CSS de manière à corriger les valeurs définies dans habillage.css

Pour cela on créera un fichier perso perso .css css dans le dossier squelettes, qui contiendra les nouvelles valeurs.

Par exemple, pour un formulaire « identite » qui comporte une #saisie{input, prenom} immédiatement suivi d’une #saisie{input, nom}, pour que le nom apparaisse à droite du prénom, il suffit de mettre dans perso.css :

.formulaire_identite .editer {
        float: left;
}
.formulaire_identite  .editer_prenom {
        clear: left;
}
.formulaire_identite  .editer_nom {
        clear: right;
        margin-left: 10px;
}

L’affichage des erreurs n’est alors pas très agréable puisqu’en s’intercalant entre le label et la saisie, les erreurs rompent l’alignement horizontal des 2 zones de saisie voisine.

L’affichage des erreurs n’est alors pas très agréable puisqu’en s’intercalant entre le label et la saisie, les erreurs rompent l’alignement horizontal des deux zones de saisie voisines.
_ Pour remédier, on peutprobablement :

• 
  -   soit insérer d’insérer une pseudo saisie « erreur » juste avant, uniquement pour afficher l’erreur commune à ces deux 2 saisies ;
• soit définir un nouveau type de saisie «  prenom_nom  » qui intègre les deux  ;
• soit définir un nouveau type de saisie «  cote_a_cote  » qui intègre deux saisies quelles qu’elles soient .- soit de définir un nouveau type de saisie « prenom_nom » qui intègre les 2
  -  soit de définir un nouveau type de saisie « cote_a_cote » qui intègre 2 saisies quelles qu’elles soient

----
[verifier<-]
<a name=’verifier’></a >
----------------

Vérifications de la conformité des valeurs

Les #SAISIES peuvent être utilisées dans le cadre d’un formulaire CVT.

La partie ’verifier’ du code associé fait les vérifications adéquates. Elle peut pour cela faire appel aux vérifications prédéfinies par le plugin ’verifier’ (actuellement encore en dev).

Par exemple, pour vérifier un code postal français, ça s’utilise en faisant :

	
$verifier = charger_fonction('verifier','inc');
if ($err=$verifier(_request('cp '),  'entier err=$verifier  (_ request('cp'),'entier ',  array('min'=>1000 ,  'max'=>99999 array('min'=>1000,'max'=>99999 ))
     $erreurs['cp'] =  $err;

SAISIES propose également une fonction ’saisies_verifier($formulaire)’ qui vérifie et valide en un seul appel la conformité de toutes les saisies, et renvoie le tableau des erreurs dans le cas d’une non validité.

Pour cela,
-* - il faut disposer de la constitution du formulaire sous forme d’un tableau PHP. C’est le cas par exemple si la saisie est générée par ce même tableau php au moyen de #GENERER_SAISIES

• 
  -   chaque saisie doit avoir été créée avec une option supplémentaire de nom ’verifier’ et dont la valeur est un tableau définissant le type de validation à faire avec le plugin verifier.

Ce tableau contient 2 entrées :
-  ’type’
-  ’options’

Pour chaque saisie, saisies_verifier vérifie si elle a bien été saisie (dans le cas d’une saisie obligatoire), puis appelle la fonction de vérification avec les options indiquées.

Exemple :

$saisie_age = array(
	'saisie' => 'input',
	'options' => array(
		'nom' => 'age',
		'label' => 'Votre age',
		'size' => 2),
         'verifier' => array (type, entier
                 options => array (max=>7, min=>7)));

Comme indiqué dans [-> art3364] [->/ Saisies] , le tableau < code>$formulaire</code > $ formulaire rassemble toutes les saisies : $formulaire = array ($saisie_age, ...);

En passant par un ficher yaml yaml pour décrire les saisies, ça donne ceci :

  saisie: 'input'
  options:
    nom: 'age'
    label: 'Votre age'
    size: 2
  verifier:
    type: 'entier'
    options:
      min: 0
      max: 100 

----------------------