Curry
PHP Framework

core

db

html

utility

HtmlForm::addCheckboxes

public FormElementSet addCheckboxes ( string $name = null, array $list = null, string|array $defaultValue = null, array $attributes = null )
複数選択のチェックボックスのタグとして、type属性が"checkbox"であるinputタグを生成し、追加します。
このメソッドでは、チェックボックスのコンテナタグとしてspanを生成し、$listで指定されたデータを元にチェックボックスを複数生成し、spanの下に追加します。
生成したFormElementSetのインスタンスを戻り値として返すため、後からインスタンスへの設定などの操作が可能です。

パラメーター

名前 型 内容
$name string name属性値を指定します。
$list array value属性値とラベルテキストの組合せの配列を指定します。
配列は、キーにvalue属性値、値にラベルテキストという形式で定義します。
$defaultValue string|array チェックボックス選択項目の中から初期選択状態としたい項目のvalue属性を指定します。
配列で複数指定することで復数の項目を初期選択状態とすることも可能です。
$attributes array タグの属性値を定義した配列を指定します。
配列は、キーに属性名、値に属性値という形で復数指定することが可能です。

返り値

生成したFormElementSetのインスタンスを返します。