core
db
html
utility
HtmlForm::createCheckboxes
public FormElementSet createCheckboxes
( string $name = null, array $list = null, string|array $defaultValue = null, array $attributes = null )
複数選択のチェックボックスのタグとして、type属性が"checkbox"であるinputタグを生成し、取得します。
このメソッドでは、チェックボックスのコンテナタグとしてspanを生成し、$listで指定されたデータを元にチェックボックスを複数生成し、spanの下に追加します。
またこのメソッドではformへの追加は行わないので、取得したインスタンスをaddFormElementメソッドで追加する必要があります。
このメソッドでは、チェックボックスのコンテナタグとしてspanを生成し、$listで指定されたデータを元にチェックボックスを複数生成し、spanの下に追加します。
またこのメソッドではformへの追加は行わないので、取得したインスタンスをaddFormElementメソッドで追加する必要があります。
パラメーター
| 名前 | 型 | 内容 |
|---|---|---|
| $name | string | name属性値を指定します。 |
| $list | array | value属性値とラベルテキストの組合せの配列を指定します。 配列は、キーにvalue属性値、値にラベルテキストという形式で定義します。 |
| $defaultValue | string|array | チェックボックス選択項目の中から初期選択状態としたい項目のvalue属性を指定します。 配列で複数指定することで復数の項目を初期選択状態とすることも可能です。 |
| $attributes | array | タグの属性値を定義した配列を指定します。 配列は、キーに属性名、値に属性値という形で復数指定することが可能です。 |
返り値
生成したFormElementSetのインスタンスを返します。