diff --git a/doc/LS.entities.xml b/doc/LS.entities.xml index 16cd103e..1adce6e3 100644 --- a/doc/LS.entities.xml +++ b/doc/LS.entities.xml @@ -40,5 +40,7 @@ LSformElement"> LSformElements"> +LSformRule"> +LSformRules"> diff --git a/doc/contrib/contrib.docbook b/doc/contrib/contrib.docbook index f3779f04..c0030877 100644 --- a/doc/contrib/contrib.docbook +++ b/doc/contrib/contrib.docbook @@ -604,4 +604,43 @@ du type textarea, ou encore du type url dérivé du type text. + + LSformRules + + Les &LSformRules; sont les règles syntaxiques applicables aux champs des formulaires. Ces règles serviront à s'assurer que les + valeurs des champs récupérées des formulaires sont syntaxiquement correctes. Elles seront configurables via le paramètre + check_data des attributs des &LSobjects;. + + Pour chaque type implémenté, on trouvera une classe PHP dérivée de la classe LSformRule et devant s'appeler + LSattr_rule_[nom du type]. Dans celle-ci, il devra être défini la méthode statique validate() qui + implémentera le contrôle syntaxique. Cette méthode prendra en paramètres : + + + + $value + + La valeur à tester. + + + + + $options + + Un tableau des options définies dans la configuration pour ce contrôle syntaxique. + + + + + $formElement + + Une référence au champ du formulaire (objet &LSformElement;). + + + + + + Cette méthode devra retourner True ou False si la valeur testée est respectivement valide ou + invalide. + +