HTML_QuickForm::addGroup() – Adds an element group


require_once 'HTML/QuickForm.php';

object &HTML_QuickForm::addGroup ( array $elements , string $name = null , mixed $groupLabel = '' , string $separator = null , string $appendName = true )


Adds an element group.


array $elements

array of elements composing the group

string $name

(optional) group name

mixed $groupLabel

(optional) group label

mixed $separator

(optional) string or array of strings to separate elements

boolean $appendName

(optional) specify whether the group name should be used in the form element name: groupName[elementName] vs elementName

Return value

return reference to added group of elements


Possible PEAR_Error values
Error code Error message Reason Solution
QUICKFORM_INVALID_ELEMENT_NAME Element '$elementName' already exists in HTML_QuickForm::addElement() Tried to add a group having a name of an existing element Choose a different name for a group


since 2.8

This function can not be called statically.


Using addGroup()


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


Using groups (Previous) HTML class for a form element group (Next)
Last updated: Sat, 16 Feb 2019 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report.
View this page in:
  • English

User Notes:

There are no user contributed notes for this page.