API for CakePHP 1.2x:FormHelper

フォームとフォームの部品を出力するためのヘルパー。inputメソッドは様々な部品を出力出来ます。

メソッド

button ($title, $options=array())
checkbox ($fieldName, $options=array())
create ($model=null, $options=array())
dateTime ($fieldName, $dateFormat= 'DMY', $timeFormat= '12', $selected=null, $attributes=array(), $showEmpty=true)
day ($fieldName, $selected=null, $attributes=array(), $showEmpty=true)
end ($options=null)
error ($field, $text=null, $options=array())
file ($fieldName, $options=array())
hidden ($fieldName, $options=array())
hour ($fieldName, $format24Hours=false, $selected=null, $attributes=array(), $showEmpty=true)
input ($fieldName, $options=array())
inputs ($fields=null, $blacklist=null)
isFieldError ($field)
label ($fieldName=null, $text=null, $attributes=array())
meridian ($fieldName, $selected=null, $attributes=array(), $showEmpty=true)
minute ($fieldName, $selected=null, $attributes=array(), $showEmpty=true)
month ($fieldName, $selected=null, $attributes=array(), $showEmpty=true)
password ($fieldName, $options=array())
radio ($fieldName, $options=array(), $attributes=array())
secure ($fields)
select ($fieldName, $options=array(), $selected=null, $attributes=array(), $showEmpty= '')
submit ($caption=null, $options=array())
submitImage ($path, $options=array())
text ($fieldName, $options=array())
textarea ($fieldName, $options=array())
year ($fieldName, $minYear=null, $maxYear=null, $selected=null, $attributes=array(), $showEmpty=true)

フォームの作成

$form->create ($model=null, $options=array())
フォームの開始タグを出力。引数を全く指定しなければ、現在のコントローラーとアクション名からフォームタグのパラメーターが設定されます。
Usersコントローラのaddアクションのviewファイルでcreate()を使った時

echo $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を利用するときなどに。

フォームの完結

$form->end($options=null)
フォームの終了タグを出力。

$optionsで指定できる事

$optionsを指定するとフォームの送信ボタン(submit)も出力します。
テキストまたは配列。テキストの場合は送信ボタンの名前(submitタグのvalue)が設定されます。
配列の場合は、'name','label','div'を指定できます。