Yii Framework 开发教程(11) UI 组件 ActiveForm示例

前面在介绍Yii Framework 开发教程(7) 使用CHtml 创建Form和Yii Framework 开发教程(8) 使用FormModel 已经对CActiveForm做了简要的介绍。过几天就是圣诞节了，这里帮助圣诞老人做个调查表，调查每个人希望得到的圣诞节礼物和圣诞大餐想吃的食品：-）。

这里共享一部分代码，做为后续例子的框架，基本上是复制Hello World的例子，添加了一个空的DataModel，使用缺省的Controller（SiteController）和缺省的Action（actionIndex），使用缺省的配置文件，代码下载。

通过HTML表单收集用户数据是Web程序开发的主要工作之一。除了表单设计外， 开发者还需要将现存的或默认的数据填充到表单，验证用户输入， 对无效的输入显示适当的错误信息，保存输入到持久性存储器。Yii通过其 MVC 结构极大地简化了此工作流程。

在 Yii 中处理表单时，通常需要以下步骤：

1. 创建用于表现所要收集数据字段的模型类。
2. 创建一个控制器动作，响应表单提交。
3. 在视图脚本中创建与控制器动作相关的表单。

创建DataModel

class DataModel extends CFormModel
{
	public $firstName;
	public $lastName;

	public $favouriteGift;

	public $favouriteDinner;

	public function rules()
	{
		return array(
			array('firstName, lastName', 'required'),
			array('favouriteGift,favouriteDinner', 'safe')

			);
	}

	static $gifts=array(
		'1'=>'iPad',
		'2'=>'Remote control helicopter',
		'3'=>'60 inch 3D LED TV',
		'4'=>'Holy Bible',
		);

	static $meals=array(
		'1'=>'Egg',
		'2'=>'Ham',
		'3'=>'Chicken',
		'4'=>'Pork',
		'5'=>'Beer',
		'6'=>'Coke',
		'7'=>'Wine',
		);
}

firstName，lastName 用于记载用户姓名，$favouriteGift和$favouriteDinner 记载用户的礼物和食品名称。$gifts，$meals静态定义了可供用户选择的礼物种类和食品种类。这里要注意的是firstName，lastName是必填的，而$favouriteGift和$favouriteDinner 设为可以安全复制的，这些由Model的rules来定义。

定义Action

修改SiteController 的Action方法：

public function actionIndex()
{

	$model=new DataModel();

	if(!empty($_POST['DataModel']))
	{
		$model->attributes=$_POST['DataModel'];

		if($model->validate())
		{
			$this->render('choice', array(
				'model' => $model,

				));
			return;
		}

	}

	$this->render('index', array(
			'model' => $model,

			));
}

这里定义了两个View，index 用于获取用户输入，choice 显示用户选择结果。$model->attributes=$_POST['DataModel']; 正如我们在 安全的特性赋值 中所讲的， 这行代码使用用户提交的数据填充模型。 attributes 属性由 CModel定义，它接受一个名值对数组并将其中的每个值赋给相应的模型特性。

定义View

首先是定义index.php ，本例使用CActiveForm，CActiveForm同时提供客户端及服务器端无缝的、一致的验证。

<?php $form = $this->beginWidget('CActiveForm', array(
    'id'=>'user-form',
    'enableAjaxValidation'=>true,
    'enableClientValidation'=>true,
    'focus'=>array($model,'firstName'),
)); ?>

本例比较简单，没有使用这些复杂的校验，只要求FirstName,LastName非空，这是由DataModel中的rules 的 required 来定义的。

<div class="form">
<?php $form=$this->beginWidget('CActiveForm'); ?>

    <?php echo $form->errorSummary($model); ?>

    <div class="row">
        <?php echo $form->label($model,'firstName'); ?>
        <?php echo $form->textField($model,'firstName') ?>
    </div>

	<div class="row">
        <?php echo $form->label($model,'lastName'); ?>
        <?php echo $form->textField($model,'lastName') ?>
	</div>

	<p>Choose your Christmas Gift</p>
	<div class="row">
         <?php echo $form->radioButtonList($model,'favouriteGift',
         DataModel::$gifts) ?>

    </div>

   <p>Choose your Christmas dinner</p>
	<div class="row">
         <?php echo $form->checkBoxList($model,'favouriteDinner',
         DataModel::$meals) ?>

    </div>

    <div class="row submit">
        <?php echo CHtml::submitButton('Submit'); ?>
    </div>

<?php $this->endWidget(); ?>
</div><!-- form -->

View Choice 就更简单，显示用户选择结果：

<?php echo "Merry Christmas "; ?>
<?php echo $model->firstName . ' ' . $model->lastName . '.' ;?>
<p />
<p>You will be given
	<?php
		echo DataModel::$gifts[$model->favouriteGift];
	?>
on Christmas Day.</p>

<p>And you will have
	<?php
		foreach($model->favouriteDinner as $dinner)
		{
			echo DataModel::$meals[$dinner] . ' ';
		}
	?>
for Christmas dinner.</p>

<p><?php echo CHtml::link('Start Again',array('index')); ?></p>

运行结果如下：
本例 下载