YII和AJAX结合经典 CActiveForm讲解.docVIP

CActiveForm讲解 CActiveForm提供了一些方法，这些方法能够方便的去创建一个与数据模型相关联的Form表单。CActiveForm继承自CWidget，所以他需要实现CWidget的init() 和 run() 方法，同时它也实现了一些自己的封装方法。CActiveForm很重要的一个特性就是它支持Ajax校验。我们可以设置CActiveForm的enableAjaxValidation属性为ture来启动Ajax校验。例如，当用户在input框中输入一些值后就会触发Ajax校验。CActiveForm会向服务器提交Ajax请求，用来校验用户当前输入的值。服务器的校验一般是调用模型类Model的validate()方法。如果校验失败，相对应的错误信息将会被返回并显示给用户。即使用户在浏览器禁用javascript，他也会通过整个页面的提交自动回滚到传统的页面验证。 在客户端，Yii认为input框可以存在四个状态：初始化，校验，错误和成功。为了区分这些状态，CActiveForm自动指定了不同的CSS样式给包含此input框的HTML element。默认情况下，这些CSS样式类的名字为：validating，error，success。当然我们可以使用CActiveForm的options属性去自定义他们。 CActiveForm的提交和校验是基于Ajax模式的。如果你的Form表单中有很大量的数据需要提交，那么这种Ajax模式的提交可能就不那么好了。这种情况下，你可以设计自己轻量级的Ajax校验。使用Yii对JQuery的支持？ 使用CActiveForm来做Ajax校验，我们需要使用两个JS库：jquery.js和jquery.yiiactiveform.js。他们的位置在工程根目录下：assets\5ce53e17\文件夹中。不用担心，这些JS库Yii会自动发布到你的工程中。虽然这些动作Yii会悄悄的做，当你必须知道。 首先我们来看我们的模型类，这里我们使用CFormModel： class LoginForm extends CFormModel { public $username; public $password; public function rules() { return array( array(username, password, required), array(username, authenticate), ); } public function authenticate($attribute,$params) { if($this-username==admin) $this-addError(username,can not login with admin!); } } 我们的模型类非常简单，只有username和passsword两个属性。username的校验规则是不为空，且不能是“admin”，而password的校验规则只是不为空。注意，当我们检查到用户输入的username的值为“admin”时候，校验失败，我们添加错误信息为“can not login with admin”，这段信息会在页面中的Yii提供的error元素中输出。 我们可以在rules方法中指定任何一条验证规则的错误信息，我们需要使用message属性。例如：array(username, required,message=’not null’)，当username的内容为空的时候，我们会使用message指定的内容在页面上显示错误信息。当然我们可以使用中文，如果出现乱码，可以这样设置：array(username, required,message=iconv(gb2312,utf-8,不能为空)) 你将main.php里的app配置加上language=zh_cn,系统默认的提示就是中文的了! 其他验证规则案例： array(title, content, status, required), array(title, length, max=128), array(status, in, range=array(0, 1, 2)), array(tags, match, pattern=/^[\w\s,]+$/,message=Tags can only contain word characters.), 我们的页面代码如下： div class=form ?php $form=$this-beginWidget(CActiveForm, array(id=login-form,enableAjaxValidation=true,ac