フォーム
API for CakePHP 1.3:FormHelper
フォームとフォームの部品を出力するためのヘルパー。inputメソッドは様々な部品を出力出来ます。
フォームの作成
echo $this->Form->create ($model=null, $options=array())
フォームの開始タグを出力。引数を全く指定しなければ、現在のコントローラーとアクション名からフォームタグのパラメーターが設定されます。
Usersコントローラのaddアクションのviewファイルでcreate()を使った時
echo $this->Form->create();
以下のようなフォームでidやactionのパラメータが自動的に設定されます。
<form id="UserAddForm" method="post" action="/users/add">
$optionsで指定できる事
‘type’、‘action’、‘url’、‘default’が指定できます。
$options[‘type’]
‘post’, ‘get’, ‘file’, ‘put’ , ‘delete’のいずれか。
‘file’を指定した場合は、method="post"でenctype="multipart/form-data"のフォームになります。
$options[‘action’]
フォームタグのactionで指定するURL部分のうちCakePHPスタイルのURL(コントローラ名/アクション名)のアクション名の部分を変更できます。HTMLのaction=で指定するURL全体を変更する訳ではありません。URL全体を指定したい場合は次の'url'を使用します。
$options[‘url’]
フォームタグのactionで指定するURLを全て変更します。文字列あるいは配列で指定します。
$options[‘default’]
'false'に設定するとsubmitボタンでフォームを送信しないようにする事が出来ます。Ajaxを利用するときなどに。
$options[‘inputDefaults’]
inputメソッドで使用できる'label'や'div'などのオプションのデフォルト値を設定できます。
echo $this->Form->create('User', array( 'inputDefaults' => array( 'label' => false, 'div' => false ) ));
フォームの部品
こちらのフォームの部品へ
フォームの完結
echo $this->Form->end($options=null)
フォームの終了タグを出力。
$optionsで指定できる事
$optionsを指定するとフォームの送信ボタン(submit)も出力します。
テキストまたは配列。テキストの場合は送信ボタンの名前(submitタグのvalue)が設定されます。
配列の場合は、'name','label','div'を指定できます。