HTML_QuickForm::addGroup()

HTML_QuickForm::addGroup() -- Ajoute un élément à un groupe

Synopsis

require_once 'HTML/QuickForm.php';

object &HTML_QuickForm::addGroup (array $elements [, string $name = NULL [, mixed $groupLabel = '' [, string $separator = NULL [, string $appendName = TRUE]]]])

Description

Ajoute un élément à un groupe.

Paramètres

array $elements

Tableau d'éléments composant le groupe

chaîne de caractères $name

(optionnel) nom du groupe

mixed $groupLabel

(optionnel) Libellé du groupe

mixed $separator

(optionnel) chaîne ou tableau de chaînes pour séparer les éléments

booléen $appendName

(optionnel) spécifie si le nom du groupe doit être utilisé dans le nom de l'élément du formulaire : NomGroupe[NomElement] vs NomElement

Valeur retournée

Retourne une référence aux éléments ajoutés au groupe

Valeurs renvoyées

Tableau 42-1. Valeurs PEAR_Error possibles

Code erreurMessage d'erreurRaisonSolution
QUICKFORM_INVALID_ELEMENT_NAMEElement '$elementName' already exists in HTML_QuickForm::addElement()Tentative d'ajouter un groupe dont le nom correspond à un élément existantChoisissez un nom différent pour le groupe

Note

Disponible depuis la version 2.8.

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

Exemple