Manual:HTMLForm Tutorial 2/fr

La suite de cette page concerne l'utilisation de HTMLForm à travers les entrées génériques de  (valeurs communes à tous les types de champs). Nous allons donc travailler uniquement avec l'entrée HTMLTextField.

Sauter la partie générique et aller directement aux chapîtres de spécification des champs

Ici nous sommes dans  et nous travaillons avec la fonction   ...

Ajouter un texte simple
Nous souhaitons remplacer « Hello World » par un champ de texte appelé

Maintenant le formulaire ressemble à :



Ajouter une fonction de callback
Malheureusement, le code précédent affiche le formulaire, mais celui-ci ne fonctionne pas. Il faut écrire la logique qui va traiter l'entrée !

Maintenant le formulaire peut traiter les données saisies :



Méthodes de soumission
Le formulaire peut être configuré pour utiliser les méthodes d'envoi POST ou GET.


 * POST (par défaut): le contenu des champs du formulaire n'apparaissent pas dans l'URL de la page. Cette méthode doit être utilisée pour les formulaires qui modifient le contenu du wiki (par exemple les modifications de pages ou le blocage d'utilisateurs).
 * GET: le contenu des champs du formulaire apparaissent dans l'URL de la page. L'URL résultante peut être ajoutée au marque-pages ou être utilisée comme un lien pour permettre aux autres utilisateurs de la voir. Néanmoins cette méthode peut échouer avec de très longs formulaires (plusieurs kilo-octets de texte). Elle doit être utilisée pour des formulaires qui ne modifient pas le contenu du wiki (par exemple pour l'affichage d'une liste de pages).

Pour envoyer les données via une requête GET, vous devez ajouter ce qui suit :

Pour fonctionner correctement notez que les formulaires GET qui utilisent un champ  ou   doivent avoir un  « identifiant de formulaire » initialisé, de la même façon que lorsque vous utilisez plusieurs formulaires sur une même page – voir Utiliser plusieurs formulaires sur la même page ci-dessous.

Ajouter la validation
Les champs peuvent être contrôlés individuellement avant d'exécuter la fonction de callback.

D'abord il faut le dire à HTMLForm en ajoutant cette ligne :

dans :

Puis écrivez la logique de validation :

Maintenant, la logique de validation vérifie les données soumises avant de les traiter :



Champ obligatoire
Vous pouvez spécifier qu'un champ est obligatoire simplement en ajoutant :

dans le formDescriptor. Tout $validationcallback se substitue au caractère obligatoire. Si vous voulez valider un champ nécessaire, ajoutez la logique suivante à votre fonction callback de validation : Any validation-callback will overwrite required. If you want to validate a required field, add the following logic to your validation callback function:

Ajouter un filtrage
Le filtrage modifie l'entrée et se produit AVANT la validation.

Déclaration correspondante dans formDescriptor :

Logique de fltrage :

Ajouter l'internationalisation (prise en charge de i18n)
Il s'agit ici de traduire l'étiquette en fonction de la langue de l'interface utilisateur définie dans les préférences utilisateur. Il faut alors remplacer 'label' par 'label-message' dans formDescriptor pour automatiquement aller chercher la chaîne traduite à travers la routine i18n :

N'oubliez pas d'ajouter l'entrée correspondante dans les fichiers de localisation. Par exemple, ici en anglais et en français...

Pour le bouton submit, il faut le faire « manuellement » :

bien sûr, comme toujours, ajoutez l'entrée myform-submit dans les fichiers de localisation.

Ajouter des sections
Maintenant il nous faut ajouter des champs supplémentaires et les organiser; passons à un formDescriptor un peu plus conséquent.

La chaîne de la section affichée est automatiquement récupérée à partir des fichiers de localisation. C'est pourquoi à ce niveau nous devons l'ajouter dans en.json : Here we therefore need to add this in en.json :

Maintenant le formulaire ressemble à :



Cas des sous-sections
Les sections peuvent être facilement imbriquées grâce à la puissance incroyable de /.

Les ID i18n ressembleront à :

Maintenant le formulaire ressemble à :



Ajouter un texte d'aide
Et que pensez-vous de fournir une aide pour que les utilisateurs puissent se servir de votre formulaire facilement ? ou  (un nom de message i18n) sont faits pour vous.

Maintenant le formulaire ressemble à :



Ajouter CLASS et ID html
et  sont faits pour cela.

Modifier le nom de l'entrée
Par défaut, le nom de l'entrée est  ; dans l'exemple précédent, le nom de l'entrée est donc. Ceci peut être changé avec  :

Simplement pour vous donner une idée, voici le HTML généré en sortie :

Désactiver les entrées
Utilisez disabled pour cela et l'utilisateur ne pourra pas copier (CTRL-C) l'entrée. L'élément par contre ne pourra pas être envoyé.

c'est aussi simple que cela !

Mettre les entrées en lecture seulement
Utilisez readonly pour cela, et l'utilisateur ne pourra pas modifier l'entrée.

Encore une fois, aussi simple que cela !

Utiliser des fomulaires multiples sur une seule page
Si vous utilisez plusieurs formulaires sur une page spéciale unique (par exemple un pour afficher les résultats de recherche, et un autre pour modifier un résultat), vous devez utiliser des identificateurs de formulaire pour permettre à HTMLForm de détecter d'où provient le submit. L'identifiant peut être une chaîne quelconque, mais doit être différente pour chaque formulaire de la page.

Pour des raisons techniques, ceci est aussi nécessaire lorsque vous utilisez un champ  ou   dans un formulaire GET; sinon HTMLForm ne peut pas détecter si le formulaire a été soumis et donc s'il doit charger les valeurs par défaut ou non.

PAGE SUIVANTE DU TUTORIEL