HTML_QuickForm::addGroup()
Вернуться к: Using groups
HTML_QuickForm::addGroup()
Synopsis
object &HTML_QuickForm::addGroup ( array $elements , string $name = null , mixed $groupLabel = '' , string $separator = null , string $appendName = true )
Adds an element group.
Parameter
- 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
Throws
| 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 |
Note
since 2.8
This function can not be called statically.
Example
Using addGroup()
<?php
$group[] =& HTML_QuickForm::createElement('text', 'first', 'First');
$group[] =& HTML_QuickForm::createElement('text', 'last', 'Last');
$form->addGroup($group, 'name', 'Name:', ', ');
?> Вернуться к: Using groups