HTML_QuickForm::addGroupRule()

HTML_QuickForm::addGroupRule() -- Ajoute une règle de validation pour un groupe donné

Synopsis

require_once 'HTML/QuickForm.php';

void HTML_QuickForm::addGroupRule (string $group, mixed $arg1 [, string $type = '' [, string $format = '' [, int $howmany = 0 [, string $validation = 'server' [, bool $reset = FALSE]]]]])

Description

Ajoute une règle de valifation pour un groupe d'éléments donné.

Seuls les groupes possédant un nom peuvent avoir une règle d'assignée. Utilisez addGroupRule() lorsque vous avez besoin de valider les éléments d'un groupe. Utilisez également addRule() si vous devez valider le groupe complet.

Paramètres

chaîne de caractères $group

Nom du groupe

mixed $arg1

Tableau d'éléments ou message d'erreur pour un élément. Si c'est un tableau, sa structure sera la suivante :
array (
    'nom de l'élément ou index' => array(
        array(règle),
        ...
        array(règle)
    ),
    ...
    'nom de l'élément ou index' => array(
        array(règle),
        ...
        array(règle)
    )
)
La règle ici correspond à l'ordre des paramètres ainsi que leurs signification pour la méthode addRule().

Note : Si ce paramètre est un tableau, tous les paramètres de sous séquence sont ignorés. Vous devriez passer tous les modificateurs pour les règles à ajouter dans ce tableau ( voir l'exemple ci-dessous).

chaîne de caractères $type

(optionnel) Type de règle. Utilisez getRegisteredRules() pour récupérer les types. Vous pouvez également passer le nom d'une classe pour un descendant de HTML_QuickForm_Rule ou une instance d'une telle classe.

chaîne de caractères $format

(optionnel) Requis pour les règles

entier $howmany

(optionnel) Nombre d'éléments valides devant être dans le groupe

chaîne de caractères $validation

(optionnel) Où l'on doit effectuer la validation : "server" (côté serveur), "client" (côté client)

booléen $reset

Côté client : si l'on doit réinitialiser la valeur des éléments lors de l'échec d'une validation.

Valeurs renvoyées

Tableau 42-1. Valeurs PEAR_Error possibles

Code erreurMessage d'erreurRaisonSolution
QUICKFORM_NONEXIST_ELEMENTGroup '$group' does not exist in HTML_QuickForm::addGroupRule()Tentative d'ajout d'une règle pour un groupe inexistantVérifiez le nom du groupe
QUICKFORM_NONEXIST_ELEMENTElement '$elementIndex' not found in group '$group' in HTML_QuickForm::addGroupRule()$arg1 est un tableau et contient un index pour un élément qui n'appartient pas au groupeVérifiez l'index de l'élément
QUICKFORM_INVALID_RULERule '$type' is not registered in HTML_QuickForm::addGroupRule()La règle est inconnue de QuickFormVérifiez le type de la règle ou utilisez la méthode HTML_QuickForm::registerRule().

Note

Disponible depuis la version 2.5.

Cette fonction ne peut pas être appelée de façon statique.

Exemple