DEFAULT_FORM_NAME
DEFAULT_FORM_NAME
フォームの生成とフォームへの値の復元を行うクラスです。
<?php
//-- フォームの開始タグを表示します。
Form::open('method="post" action="post.php"');
// あるいは Form::open(array('method' => 'post', 'action' => 'post.php'));
//-- フォームの閉じタグを表示します。
Form::close();
//-- テキストフォームを表示します。(echoやprintは不要です。)
Form::text('firstname');
// => <input type="text" name="firstname">
//-- ID名とクラス名を指定してテキストフォームを表示します。
// このID、クラス指定はすべてのフィールド生成メソッドで利用可能です。
//-- (フィールド名とID、クラス名の間にスペースが必要です。)
Form::text('firstname #input_firstname.form-control.regist-name');
// => <input type="text" name="firstname" id="input_firstname" class="form-control regist-name">
//-- 属性を指定してテキストフォームを表示します。
Form::text('firstname', array('required', 'maxlength' => '10'));
// 別の書き方 : Form::text('firstname', 'required maxlength="10"'));
// => <input type="text" name="firstname" required maxlength="10">
//-- フォームに値を復元させます。
// フォームに復元させる値を一括設定
Form::setValue(array(
'firstname' => 'Boy',
'lastname' => 'Tom',
// 自動的にエスケープされます。
'profile' => '<script>alert("\'Allo! \'Allo!")</script>'
));
Form::text('firstname');
Form::text('lastname');
Form::textarea('profile');
// => <input type="text" name="firstname" value="Tom">
// => <input type="text" name="lastname" value="Boy">
// => <textarea name="profile"><script>alert("\'Allo!\'Allo!")</sctipt></textarea>
//-- チェックボックスを表示します。
Form::checkbox('hobby[]', 'Golf');
Form::checkbox('hobby[]', 'Baseball');
// => <input type="checkbox" name="hobby[]" value="Golf">
// => <input type="checkbox" name="hobby[]" value="Baseball">
//-- セレクトボックスを表示します。
$selections = array('Select' => array('required', 'selected'), 'male' => 0, 'female' => 1);
Form::select('gender', $selections);
// => (実際の出力は整形されていません)
// <select name="gender">
// <option required selected>Select</option>
// <option value="0">male</option>
// <option value="1">female</option>
// </select>
setValue(array $value, string $form)
フォームに初期値を割り当てます。
割り当てる変数は以下のような形式でなければいけません
<?php
$values = array(
'name属性の値' => 'value属性の値',
// checkbox, select に対応する値を示すとき
// (選択された要素がひとつのみであれば、値はただの文字列でも問題ありません)
'checkboxのname属性の値' => array('選択値1', '選択値2')
);
この形式に沿わない場合、フィールド生成時に正しく値が復元されません���
array | $value | フォームに割り当てる初期値が入った配列 |
string | $form | (optional) 値を割り当て先グループ名(お好みの名前、省略可) |
hidden(string $name, string $value, array|string $attr, string $form)
不可視フィールドを生成し、出力します。
もし、第3引数でvalue属性が指定されていても 第2引数に指定したvalueが優先されます。
string | $name | フィールドの名前(name属性に設定されます) |
string | $value | value属性に設定する値 |
array|string | $attr | (省略可)HTMLに設定する属性。
|
string | $form | 初期値が設定されているグループ名 |
checkbox(string $name, string $value, array|string $attr, string $form)
チェックボックスを生成し、出力します。
string | $name | フィールドの名前(name属性に設定されます) |
string | $value | value属性に設定する値 |
array|string | $attr | (省略可)HTMLに設定する属性。
|
string | $form | 初期値が設定されているグループ名 |
radio(string $name, string $value, array|string $attr, string $form)
ラジオボタンを生成し、出力します。
string | $name | フィールドの名前(name属性に設定されます) |
string | $value | value属性に設定する値 |
array|string | $attr | (省略可)HTMLに設定する属性。
|
string | $form | 初期値が設定されているグループ名 |
select(string $name, string $selection, array|string $attr, string $form)
セレクトボックスを生成し、出力します。
第2引数 $selectionは以下の形式でなければなりません。
array(
'表示名' => "value属性の値",
// 属性を指定する場合は、配列の最初、もしくは、'value'キーにvalue属性の値を指定してください。
// '表示名' => array("value属性の値", '属性名' => '値', '属性名2' => '値2'),
// '表示名' => array('value' => '値', '属性名2' => '値2'),
'表示名2' => "value属性の値2",
)
TODO optgroup
string | $name | フィールドの名前(name属性に設定されます) |
string | $selection | value属性に設定する値 |
array|string | $attr | (省略可)HTMLに設定する属性。
|
string | $form | 初期値が設定されているグループ名 |