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'を指定できます。

CakePHP Note (v1.3)

Index