Bonne utilisation des formulaires dans Mediboard

Utilisation des formulaires

Guide du développeur » Tutoriels et outils » Utilisation des formulaires

Description

Les formulaires permettent de recevoir des informations venant de l'utilisateurs d'effectuer certaines actions. Ces formulaires doivent suivre certaines règles dans leur codage.

Style

Différentes classes permettent d'afficher correctement un formulaire :

<table class="form">: tableau contenant un formulaire.

<th class="title">: titre d'un formulaire.

<th class="category">: categorie au sein d'un formulaire

<th>: contiendra le libellé d'un champ

<td>: contiendra un champ

<td class="button">: contiendra un ou des boutons

Propriétés des champs

Les libellés d'un champ seront encadrés par les balises <label></label> a qui on appliquera les propriétés suivantes:

for: cible l'id du champ du formulaire décrit.

title: description avancée du champ.

Les champs du formulaire devront comporter une propriété title permettant de faire les tests de validité en javascript (cf. les différentes propriétés?).

Types de formulaires

Il existe deux type principaux de formulaires : les formulaires en GET et les formulaires en POST.

Formulaires de type GET

Ils sont utilisés principalement pour que l'utilisateur rentre ses préférences concernant l'affichage (choix des informations à afficher, ...). Les noms et les valeurs des champs se retrouveront dans l'url (index.php?m=dPpatients&champ1=valeur1&champ2=valeur2 par exemple).

Formulaires de type POST

Ces formulaires seront utilisés pour envoyer des informations afin de modifier des données de la base. Ils appellent la plupart du temps un fichier do_object_aed qui effectuera les actions sql en fonction des paramètres. Voici en exemple le début d'un tel formulaire tiré du module dPcabinet :

<form name="editAntFrm" action="?m=dPcabinet" method="POST">
  <input type="hidden" name="m" value="dPpatients" />
  <input type="hidden" name="del" value="0" />
  <input type="hidden" name="dosql" value="do_antecedent_aed" />
  [..........]
</form>

action: decrit le module vers lequel on reviendra après l'action. (attention, pour passer d'autres paramètres, il faut mettre la redirection à null dans le do_aed)