PEAR Справочное руководство
Пред. След.

HTML_QuickForm::addGroup()

HTML_QuickForm::addGroup() -- Adds an element group

Synopsis

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 reference to added group of elements

Throws

Таблица 43-1. Возможные значения PEAR_Error

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

Эта функция не должна вызываться статически.

Пример

Пример 43-1. Using addGroup()

<?php

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

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

?>
Пред. Начало След.
HTML_QuickForm Уровень выше Class Summary HTML_QuickForm_group
    Поддержать сайт на родительском проекте КГБ