Changeset 79553 in spip-zone


Ignore:
Timestamp:
Dec 22, 2013, 12:21:10 PM (5 years ago)
Author:
bystrano@…
Message:

étoffe un peu la doc + autofill

File:
1 edited

Legend:

Unmodified
Added
Removed
  • _plugins_/saisie_liste/trunk/README.md

    r79552 r79553  
    33===============
    44
    5 Cette saisie permet de gérer des listes. On passe à la saisie une liste
    6 de saisies qui définissent alors un élément de la liste, et la saisie
    7 générée permet à l'utilisateur d'éditer, de créer ou de supprimer des
    8 éléments de la liste et/ou de modifier leur ordre. Elle peut fonctionner
    9 sans javascript, mais pour les utilisateurs qui l'activent, on peux
    10 réordonner les éléments par glisser-déposer via le plugin
    11 jqueryui.sortable.
     5Cette saisie permet de gérer des listes. On passe à la saisie une
     6liste de saisies qui définissent alors un élément de la liste, et la
     7saisie générée permet à l'utilisateur d'éditer, de créer ou de
     8supprimer des éléments de la liste et/ou de modifier leur ordre. Elle
     9peut fonctionner sans javascript, mais pour les utilisateurs qui
     10l'activent, on peux réordonner les éléments par glisser-déposer via le
     11plugin jqueryui.sortable.
    1212
    1313Un fois le plugin installé, on peut voir la saisie en plein action sur
    14 la page :
    15 
    16 `/ecrire/?exec=exemples_saisie_liste`.
     14la page `/ecrire/?exec=exemples_saisie_liste`.
    1715
    1816Appel de la saisie
     
    4846
    4947```php
    50 $ma-saisie = array(
     48$ma_saisie = array(
    5149    'saisie'  => 'liste',
    5250    'options' => array(
     
    7876Pour que la saisie puisse fonctionner correctement, notamment pour les
    7977utilisateurs qui n'ont pas activé le javascript, il faut executer des
    80 traitement au début des fonctions vérifier et traiter. Il est impératif de
    81 toujours commencer vos fonctions verifier par :
     78traitement au début des fonctions vérifier et traiter. Le plus simple
     79est de toujours commencer vos fonctions verifier et traiter par :
    8280
    8381```php
     
    9391```
    9492
    95 où 'ma-liste' est le nom de la saisie liste que vous avez créé.
    96 Si le formulaire contient plusieurs saisies liste, il faut passer à ces
     93où 'ma-liste' est le nom de la saisie liste que vous avez créé. Si le
     94formulaire contient plusieurs saisies liste, il faut passer à ces
    9795fonctions un tableau des noms des saisies, p.ex :
    9896
     
    102100```
    103101
    104 Ce code permet de prendre la main sur les fonctions vérifier et traiter
    105 définies pour le formulaire quand l'utilisateur clique sur "monter",
    106 "supprimer" ou un autre submit spécifique à la saisie liste.
     102Les fonctions `saisies_liste_verifier` et `saisies_liste_traiter`
     103s'occupent de préparer les valeurs postées de manière à cacher celles
     104qui ne sont utiles que pour le fonctionnement interne de la
     105saisie. Utiliser la fonction `_request` avant des les avoir appelées
     106est à vos riques et périls… Elle retournent le nom de la saisie si le
     107formulaire à été posté par un submit propre à une saisie liste, comme
     108le bouton supprimer ou les flèches. Dans ce cas on souhaite alors en
     109général interrompre les traitements du formulaire.
    107110
    108 Ceci fait, on peut récupérer les valeurs saisies en appelant
     111Dans le cas où le formulaire à été posté par un autre submit,
     112`saisies_liste_verfier` et `saisies_liste_traiter` retournent
     113`FALSE`. On récupère alors les valeurs saisies en appelant :
    109114
    110115```php
     
    128133
    129134On peut évidement utiliser un tableau de ce genre pour pré-remplir la
    130 saisie dans la fonction charger, ou pour passer des valeurs par défaut à
    131 la saisie.
     135saisie dans la fonction charger, ou pour passer des valeurs par défaut
     136à la saisie.
    132137
    133138Personnalisation du glisser-déposer
    134139-----------------------------------
    135140
    136 Pour personaliser l'appel au plugin jquerui.sortable, on peut surcharger
    137 le squelette `javascript/saisie_liste.js.html` (voir le code de ce
    138 squelette pour plus d'infos). On peut aussi créer un fichier
    139 `javascript/saisie_ma-liste.js.html` pour surcharger une saisie
    140 particulière.
     141Pour personaliser l'appel au plugin jquerui.sortable, on peut
     142surcharger le squelette `javascript/saisie_liste.js.html` (voir le
     143code de ce squelette pour plus d'infos). On peut aussi créer un
     144fichier `javascript/saisie_ma-liste.js.html` pour surcharger une
     145saisie particulière.
Note: See TracChangeset for help on using the changeset viewer.