object &HTML_QuickForm::addGroup (
array $elements
, string $name
= = null
, mixed $groupLabel = ''
, string $separator
= = null
, string $appendName
= = true
)
要素グループを追加します。
$elements
グループを構成する要素の配列。
$name
(オプション) グループ名。
$groupLabel
(オプション) グループのラベル。
$separator
(オプション) 要素を区切るために使用する、文字列あるいは文字列の配列。
$appendName
(オプション) フォーム要素の名前にグループ名を使用するかどうか、 つまり groupName[elementName] にするかそれとも elementName にするか。
追加された要素グループへの参照を返します。
エラーコード | エラーメッセージ | 原因 | 対応 |
---|---|---|---|
QUICKFORM_INVALID_ELEMENT_NAME | Element '$elementName ' already exists in HTML_QuickForm::addElement() |
既存の要素と同じ名前のグループを追加しようとしました。 | グループには別の名前を指定します。 |
since 2.8
This function can not be called statically.
addGroup() の使用法
<?php
$group[] =& HTML_QuickForm::createElement('text', 'first', 'First');
$group[] =& HTML_QuickForm::createElement('text', 'last', 'Last');
$form->addGroup($group, 'name', 'Name:', ', ');
?>