フォームの定義

ActionClass から ActionForm オブジェクトを利用してフォーム値にアクセスするには、 ActionForm にどのようなフォーム値を受け取るかを定義する必要があります。

具体的には、 ActionForm のメンバ変数 $form に

'フォーム名' => array(...(属性定義)...),

という形で利用するフォーム値を列挙していきます。例えば 'id' と 'name' というフォーム値を利用する場合は以下のようになります。

class Sample_Form_Index extends Ethna_ActionForm
{
    protected $form = array(
        'id' => array(
            'type' => VAR_TYPE_INT,
        ),

        'name' => array(
            'type' => VAR_TYPE_STRING,
        ),
    );
}

フォーム名をキーとして、値にはフォーム値の属性を定義した配列を記述します。フォーム値の属性として最大値、使用可能文字を記述しておくことで入力された値をバリデーションしたり、テンプレートのフォームヘルパによって適切なフォームの型を出力することが可能となります。 上記の例では、最低限の属性としてフォーム値の型を指定しています。

タイプ (type)

フォームの値の型には以下の種類があります。

定数	説明
VAR_TYPE_INT	整数型
VAR_TYPE_FLOAT	浮動小数点数型
VAR_TYPE_STRING	文字列型
VAR_TYPE_DATETIME	日付(YYYY/MM/DD HH:MM:SS等)
VAR_TYPE_BOOLEAN	真偽値(1/0)
VAR_TYPE_FILE	ファイル

フォームタイプ (form_type)

テンプレート内で {form_input} タグを利用してフォームのHTMLを出力する際、 form_type を設定しておくことで、適切なフォームのタイプでHTMLを出力することができます。

定数	説明
FORM_TYPE_TEXT	テキストボックス
FORM_TYPE_PASSWORD	パスワード
FORM_TYPE_TEXTAREA	テキストエリア
FORM_TYPE_SELECT	セレクトボックス
FORM_TYPE_RADIO	ラジオボタン
FORM_TYPE_CHECKBOX	チェックボックス
FORM_TYPE_BUTTON	ボタン
FORM_TYPE_FILE	ファイル
FORM_TYPE_HIDDEN	隠れコントロール