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.

Parameter

array $elements

Tableau d'éléments composant le groupe

string $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

boolean $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

Return value

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

Throws

Possible PEAR_Error values
Code erreur Message d'erreur Raison Solution
QUICKFORM_INVALID_ELEMENT_NAME Element '$elementName ' already exists in HTML_QuickForm::addElement() Tentative d'ajouter un groupe dont le nom correspond à un élément existant Choisissez un nom différent pour le groupe

Note

Disponible depuis la version 2.8.

This function can not be called statically.

Example

Exemple avec addGroup()

<?php
$group
[] =& HTML_QuickForm::createElement('text''first''First');
$group[] =& HTML_QuickForm::createElement('text''last''Last');

$form->addGroup($group'name''Nom:'',&nbsp;');
?>