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