次にジャンプする場合のルールの使用についてです。
addRuleで定義されたルールを利用できるのでしょうか？
HTML_QuickFormを使う一つの理由が、このaddRuleだったりします。
ということなのですが、実は私はHTML_QuickFormを使う時、ルールは使ってません。
ルールがHTML_QuickFormの最大の魅力のと思っておられる方が多いようなのですが、
なぜか私はルールに魅力を感じないんです。ルールってそんなに便利ですか？？？
でもせっかくなのでジャンプしてなおかつルールを使用する方法を確認してみました。
ルールの魅力がわかっていない私が確認した方法なので、ルールを愛用されている方
が見れば「これは違う！」と思われるかもしれませんが。。。
１ページ目が入力画面、２ページが確認画面、３ページが完了画面というよくある流れ
のサンプルです。長くなりますが、ソースをそのまま書いてしまいます。
（ブログにソースを載せる時の常識ってあるんでしょうか？Webアプリも初心者なら、
ブログはもっと初心者なもんで。。。ソースが字下げされないし、テンプレートは一部
表示が変です。回避方法がわかり次第修正します。）
<?php
////////////////////////////////////////////////////////////////////////////////
// ruleSample.php
// 2005.12.16 作成
////////////////////////////////////////////////////////////////////////////////
require_once './commonTips.php';
// 1ページ目
class FirstPage extends HTML_QuickForm_Page {
function buildForm() {
$this->_formBuilt = true;
$this->addElement('text',
'txtName',
''
);
$this->addRule('txtName', '必須項目です。', 'required');
$this->addElement('submit',
$this->getButtonName('AShowSecond'),
'送信');
$this->setDefaultAction('next');
}
}
// 2ページ目
class SecondPage extends HTML_QuickForm_Page {
function buildForm() {
$this->_formBuilt = true;
$this->addElement('static', 'lblName', '',
$_SESSION['inputName']);
$this->addElement('submit',
$this->getButtonName('AShowFirst'),
'戻る');
$this->addElement('submit',
$this->getButtonName('AShowLast'),
'送信');
$this->setDefaultAction('next');
}
}
// 3ページ目
class LastPage extends HTML_QuickForm_Page {
function buildForm() {
$this->_formBuilt = true;
$this->addElement('submit',
$this->getButtonName('AShowFirst'),
'終了');
$this->addElement('submit',
$this->getButtonName('AShowSecond'),
'戻る');
$this->setDefaultAction('next');
}
}
// 1ページを表示
class ActionShowFirst extends HTML_QuickForm_Action {
function perform(&$page, $actionName)
{
$page->isFormBuilt() or $page->buildForm();
$next =& $page->controller->getPage('PRuleFirst');
$next->handle('jump');
}
}
// 2ページを表示
class ActionShowSecond extends HTML_QuickForm_Action {
function perform(&$page, $actionName)
{
$page->isFormBuilt() or $page->buildForm();
if ($page->validate()) {
$pageName = $page->getAttribute('id');
if ($pageName == 'PRuleFirst') {
$data =& $page->controller->container();
$data['values'][$pageName] = $page->exportValues();
$_SESSION['inputName'] = $data['values'][$pageName]['txtName'];
}
$next =& $page->controller->getPage('PRuleSecond');
$next->handle('jump');
} else {
$page->handle('display');
}
}
}
// 3ページを表示
class ActionShowLast extends HTML_QuickForm_Action {
function perform(&$page, $actionName)
{
$page->isFormBuilt() or $page->buildForm();
$next =& $page->controller->getPage('PRuleLast');
$next->handle('jump');
}
}
class ActionDisplay extends HTML_QuickForm_Action_Display {
function _renderForm(&$page) {
$smartyObj = new tipsSmarty();
$renderer =& new HTML_QuickForm_Renderer_ArraySmarty($smartyObj);
$page->accept($renderer);
$smartyObj->assign('page', $renderer->toArray());
$page_action = $page->controller->getActionName();
$smartyObj->tipsDisplay($page_action[0]);
}
}
session_start();
$controller =& new HTML_QuickForm_Controller('form', false);
// 必要なページをすべて追加
$controller->addPage(new FirstPage('PRuleFirst'));
$controller->addPage(new SecondPage('PRuleSecond'));
$controller->addPage(new LastPage('PRuleLast'));
// ハンドラ設定
$controller->addAction('jump', new HTML_QuickForm_Action_Jump());
$controller->addAction('display', new ActionDisplay());
$controller->addAction('AShowFirst', new ActionShowFirst());
$controller->addAction('AShowSecond', new ActionShowSecond());
$controller->addAction('AShowLast', new ActionShowLast());
// 実行
$controller->run();
?>
commonTips.phpは勉強会ページで説明しているものと全く同じです。
まず、ruleSample.phpを作ります。
２ページ目を表示するためのアクション、ActionShowSecondで入力チェックをしてます。
入力が正しければ、２ページ目を表示、不正ならジャンプ前のページのままです。
今回は「１ページ目から２ページ目へ」と「３ページ目から２ページ目へ戻る」は同じ
アクションを使っているので、飛び元のページ名を取得して処理を分けています。
元々それぞれ別のアクションにしておくというのも一つの方法だと思います。
あと、テンプレートを作ります。2,3ページ目は特に目新しいことはないので省略
して、1ページ目PRuleFirst.tpl.htmlのみ載せておきます。
エラーメッセージを表示するため{$page.txtName.error}を追加してます。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>HTML_QuickFormController-Tips</title>
<meta http-equiv="Content-Type" content="text/html; charset=EUC-JP">
</head>
<body bgcolor="#99ccff">
<form {$page.attributes}>
</table>
<table width="100%" border="0">
<tr>
<td align="center">
名前を入力してください。
</td>
</tr>
<tr>
<td align="center">
{$page.txtName.error}
{$page.txtName.html}
</td>
</tr>
<tr>
<td align="center">
<!-- ボタンたち -->
{$page._qf_PRuleFirst_AShowSecond.html}
</td>
</tr>
</table>
</form>
</body>
</html>