Yii Framework 开发教程(7) 使用CHtml 创建Form

以你之姓@ 2023-10-16 19:13 58阅读 0赞

在创建Yii 应用的MVC做的View时，可以直接使用HTML语言直接构造页面视图，Yii 也提供了几个帮助（helper）类简化视图编写。例如， 要创建一个文本输入域，我们可以调用 CHtml::textField()； 要创建一个下拉列表，则调用 CHtml::dropDownList()。在前面的Hangman例子的几个View就是使用CHtml来创建View的。

信息: 你可能想知道使用帮助类的好处，如果它们所需的代码量和直接写纯HTML的代码量相当的话。 答案就帮助类可以提供比 HTML 代码更多的功能。例如， 如下代码将生成一个文本输入域，它可以在用户修改了其值时触发表单提交动作。

CHtml::textField($name,$value,array('submit'=>''));

不然的话你就需要写一大堆 JavaScript 。

回忆一下Hangman中页面play的定义：

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1. This is the game of Hangman.
2. You must guess a word, a letter at a time.
3. If you make too many mistakes, you lose the game!
4. 
5. <?php echo CHtml::beginForm(); ?>
6. 
7. <?php echo CHtml::radioButtonList('level', null, $levels); ?>
8. 
9. 
10. <?php echo CHtml::submitButton('Play!'); ?>
11. 
12. <?php if($error): ?>
13. You must choose a difficulty level!
14. <?php endif; ?>
15. 
16. <?php echo CHtml::endForm(); ?>

This is the game of Hangman.
 You must guess a word, a letter at a time.
 If you make too many mistakes, you lose the game!
 
 <?php echo CHtml::beginForm(); ?>
 
 <?php echo CHtml::radioButtonList('level', null, $levels); ?>
 
 
 <?php echo CHtml::submitButton('Play!'); ?>
 
 <?php if($error): ?>
 You must choose a difficulty level!
 <?php endif; ?>
 
 <?php echo CHtml::endForm(); ?>

[![20121215001][]][20121215001 1]

使用CHtml构造页面总是以CHtml::beginForm()开始以 CHtml::endForm()结尾。实际上这两，个方法生成From标签的开始和结束标记。  
对于HTML表单支持的UI组件，如button, radioButton, checkbutton 等UI组件，CHtml类都提供了对应的方法，比如上面的radioButtonList 和 submitButton。

除radioButtonList等之外，CHtml还提供了一组activeXXX ,比如activeRadioButtonList ，这些方法需要和CFormModel 配合使用，对于Hangman这样的例子我们没有另外使用Model，因此就没有使用activeRadioButtonList方法，将在后面介绍MVC中的Model时介绍。

对与CHtml所支持的全部UI组件可以参考[Yii类参考文档][Yii]。

从版本 1.1.1 开始，提供了一个新的小物件 [CActiveForm][] 以简化表单创建。 这个小物件可同时提供客户端及服务器端无缝的、一致的验证。这些在Yii支持的UI组件时一并介绍。

[view plain]: http://blog.csdn.net/mapdigit/article/details/8298246#
[20121215001]: http://www.imobilebbs.com/wordpress/wp-content/uploads/2012/12/20121215001.png
[20121215001 1]: http://www.imobilebbs.com/wordpress/archives/3906/attachment/20121215001
[Yii]: http://www.yiiframework.com/doc/api/1.1/CHtml
[CActiveForm]: http://www.yiiframework.com/doc/api/1.1/CActiveForm