Yii2的表單驗(yàn)證之一:客戶端驗(yàn)證.

Yii2具有強(qiáng)大的表單驗(yàn)證功能,能用好表單驗(yàn)證,用戶輸入就基本掌握了,在這里我和各位聊聊Yii2的客戶端驗(yàn)證器
所謂客戶端驗(yàn)證器,就是在HTML代碼中使用JavaScript進(jìn)行驗(yàn)證的驗(yàn)證器。
什么?你在Yii2中沒有編寫過客戶端驗(yàn)證器!是的,那是因?yàn)閅ii2幫你把客戶端驗(yàn)證器自動生成了,讓我們一起來看一看Yii2自動生成的客戶端驗(yàn)證器長什么樣子吧!

上圖是一個很簡單的輸入表單,需要用戶輸入姓名和年齡,注意看一下,現(xiàn)在表單的兩個輸入框是灰色的。

如上圖,在“年齡”輸入框中輸入22,點(diǎn)擊“提交”按鈕后,“姓名”輸入框變成了紅色,并在其下方出現(xiàn)了一個提示信息:姓名不能為空。“年齡”輸入框變?yōu)?code>綠色,表示驗(yàn)證通過。這里就是Yii2客戶端驗(yàn)證器實(shí)現(xiàn)的驗(yàn)證效果。
Tip:如果你看到的提示信息是“姓名 cannot be blank”,修改一下你的Yii2語言設(shè)置:

配置文件:\advanced\frontend\config\main.php

將:

'language' => 'en',

修改為:

'language' => 'zh-CN',

如上圖,瀏覽器中,在“姓名不能為空。”文字上點(diǎn)擊鼠標(biāo)右鍵,在下拉框中選中“檢查”就會在界面下方出現(xiàn)前端調(diào)試窗口(我使用的Chrome瀏覽器)。

如上圖,在下方的前端調(diào)試窗口任意位置,點(diǎn)擊一下鼠標(biāo)左鍵,按Ctrl+f,會出現(xiàn)左下角紅框所示的搜索框,輸入“姓名不能為空”,你將會搜索出兩個結(jié)果,點(diǎn)擊搜索框右邊的箭頭,就可以查看到如圖中藍(lán)框所示的客戶端驗(yàn)證器代碼了。我們仔細(xì)看一下這部分JavaScript代碼:

jQuery(document).ready(function () {
jQuery('#w0').yiiActiveForm([{"id":"form1-name","name":"name","container":".field-form1-name","input":"#form1-name","error":".help-block.help-block-error","validate":function (attribute, value, messages, deferred, $form) {yii.validation.required(value, messages, {"message":"姓名不能為空。"});yii.validation.string(value, messages, {"message":"姓名必須是一條字符串。","min":2,"tooShort":"姓名應(yīng)該包含至少2個字符。","max":30,"tooLong":"姓名只能包含至多30個字符。","skipOnEmpty":1});}},{"id":"form1-age","name":"age","container":".field-form1-age","input":"#form1-age","error":".help-block.help-block-error","validate":function (attribute, value, messages, deferred, $form) {yii.validation.required(value, messages, {"message":"年齡不能為空。"});yii.validation.number(value, messages, {"pattern":/^\s*[-+]?[0-9]*\.?[0-9]+([eE][-+]?[0-9]+)?\s*$/,"message":"年齡必須是一個數(shù)字。","min":18,"tooSmall":"年齡的值必須不小于18。","max":60,"tooBig":"年齡的值必須不大于60。","skipOnEmpty":1});}}], []);  
});  

這些JavaScript就是Yii2為我們自動生成客戶端驗(yàn)證器,正是通過它們,前端的表單驗(yàn)證工作才得以有效實(shí)現(xiàn),而我們所需要做的就是去編寫rules()中的驗(yàn)證規(guī)則即可。Yii2框架已為我們做好了大量基礎(chǔ)工作
好,現(xiàn)在我們就一起來看看rules()是怎么編寫的吧!請仔細(xì)閱讀代碼中的注釋。

    public function rules() {
        return [
            [['name','age'],'required'],//name,age是必填項(xiàng)'required'
            //name項(xiàng)是個字符串(string),其長度不能少于2個字符,也不能多于30個字符
            ['name','yii\validators\StringValidator','min'=>2,'max'=>30,'enableClientValidation' =>true],//在一條規(guī)則中設(shè)置enableClientValidation可以控制此條驗(yàn)證規(guī)則的客戶端驗(yàn)證是否生效,默認(rèn)值是true  
            //['name','string','min'=>2,'max'=>30],//與上句等效,'string'是驗(yàn)證器'yii\validators\StringValidator'的別名
            //age項(xiàng)必須是一個有效的整數(shù)(integer),其值不能小于18,也不能大于60
            ['age','integer','min'=>18,'max'=>60],
        ];
    }  

在本例中提到了'string'是驗(yàn)證器'yii\validators\StringValidator'的別名,Yii2提供了23個核心驗(yàn)證器,都是可以使用別名直接書寫,非常簡潔。
關(guān)于這23個核心驗(yàn)證器,請參閱文檔:
http://www.yiiframework.com/doc-2.0/guide-tutorial-core-validators.html
需要說明的是,這23個核心驗(yàn)證器,并不是都能夠提供客戶端驗(yàn)證功能的,比如:uniqueexist等,這些驗(yàn)證器是需要在數(shù)據(jù)庫中查詢的驗(yàn)證器,在客戶端當(dāng)然是無法直接完成的了。當(dāng)然,這些驗(yàn)證器通過Ajax技術(shù)也實(shí)現(xiàn)了仿客戶端驗(yàn)證的良好效果。
客戶端驗(yàn)證可以使用通過enableClientValidation來進(jìn)行控制,默認(rèn)值是true,即客戶端驗(yàn)證默認(rèn)是生效的。
enableClientValidation可以在三處進(jìn)行設(shè)置:
1、在ActiveForm中對整個form進(jìn)行設(shè)置,請參見源碼中的注釋
2、在ActiveField中對field進(jìn)行單獨(dú)設(shè)置,請參見源碼中的注釋
3、在Model的rules中對驗(yàn)證規(guī)則進(jìn)行設(shè)置,請參見源碼中的注釋
本文所涉及到的程序源碼
文件位置:D:\phpwork\advanced\frontend\controllers\DemoController.php

<?php
namespace frontend\controllers;
use Yii;
class DemoController extends CommonController{
     public function actionForm1() {
        $model=new \frontend\models\Form1();
        if ($model->load(Yii::$app->request->post())) {
            if (Yii::$app->request->isAjax) {
                Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
                return \yii\bootstrap\ActiveForm::validate($model);
            }
            if($model->validate()){
                if ($model->save()) {
                    return $this->render('form1a',['model'=>$model]);
                }else{
                    $this->error('Sorry,Data save fail!');
                }
            }else{
                return $this->errorDisplay($model->getErrors());
            }
        }else{
            return $this->render('form1',['model'=>$model]);
        }
    }
}

其中errorDisplay()方法是調(diào)用自CommonController,請參見:
http://www.lxweimin.com/p/5d2c42166702

文件位置:D:\phpwork\advanced\frontend\models\Form1.php

<?php
namespace frontend\models;
use Yii;
class Form1 extends \yii\base\Model{
    public $name,$age;
    public function attributeLabels() {
        return [
            'name'=>'姓名',
            'age'=>'年齡',
        ];
    }
    public function rules() {
        return [
            [['name','age'],'required'],//name,age是必填項(xiàng)'required'
            //name項(xiàng)是個字符串(string),其長度不能少于2個字符,也不能多于30個字符
            ['name','yii\validators\StringValidator','min'=>2,'max'=>30,'enableClientValidation' =>true],//在一條規(guī)則中設(shè)置enableClientValidation可以控制此條驗(yàn)證規(guī)則的客戶端驗(yàn)證是否生效,默認(rèn)值是true
            //['name','string','min'=>2,'max'=>30],//與上句等效,'string'是驗(yàn)證器'yii\validators\StringValidator'的別名
            //age項(xiàng)必須是一個有效的整數(shù)(integer),其值不能小于18,也不能大于60
            ['age','integer','min'=>18,'max'=>60],
        ];
    }
    public function save() {
        return true;
    }
}

文件位置:D:\phpwork\advanced\frontend\views\demo\form1.php

<?php
use yii\bootstrap\ActiveForm;
use yii\helpers\Html;
$form = ActiveForm::begin([
    //在ActiveForm中設(shè)置enableClientValidation可以設(shè)置整個表單(form)的客戶端驗(yàn)證是否生效,默認(rèn)值是true;如果此值設(shè)置為false,則前端的js驗(yàn)證代碼將不會再生成。
    'enableClientValidation' => true,   
    'layout' => 'horizontal',
]);
?>
    <div class="panel panel-warning">
        <div class="panel-heading">
            <div class="panel-title">
                二、Yii2的表單驗(yàn)證——客戶端驗(yàn)證的驗(yàn)證器
            </div>
        </div>
        <div class="panel-body" style="height:500px;">
            <!-- 在ActiveField中設(shè)置enableClientValidation可以控制field項(xiàng)的客戶端驗(yàn)證是否生效,默認(rèn)值是true -->
            <?=$form->field($model,'name',['enableClientValidation'=>true])->textInput()?>
            <?=$form->field($model,'age',['inputOptions'=>['class'=>'form-control']])->textInput()?>
            <div class="row">
                <div class='col-md-2 col-md-offset-4'><?= Html::submitButton('提     交', ['class' => 'btn btn-primary form-control']) ?></div>
                <div class='col-md-2 col-md-offset-1'><?= Html::resetButton('重     置', ['class' => 'btn btn-default form-control']) ?></div>
            </div>

        </div>
    </div>
<?php ActiveForm::end(); ?>

文件位置:D:\phpwork\advanced\frontend\views\demo\form1a.php

<?php
use yii\helpers\Html;
use yii\widgets\DetailView;
?>
    <div class="panel panel-warning">
        <div class="panel-heading">
            <div class="panel-title">
                二、Yii2的表單驗(yàn)證——客戶端驗(yàn)證的驗(yàn)證器(提交數(shù)據(jù)的顯示)
            </div>
        </div>
        <div class="panel-body" style="height:500px;">
            <?php
            echo DetailView::widget([
                'model' => $model,
                'attributes' => [
                    'name:html',
                    'age',
                ],
                'template' => '<tr><th class="text-right" style="width:150px;">{label}</th><td>{value}</td></tr>',
            ]);
            ?>
            <button onclick="history.back()" class="btn btn-default">返 回</button>
        </div>
    </div>

歡迎深入閱讀:
一處編寫,三處運(yùn)行的Yii2表單驗(yàn)證

(全文完)

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,908評論 6 541
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,324評論 3 429
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,018評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,675評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 72,417評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,783評論 1 329
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,779評論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 42,960評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,522評論 1 335
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 41,267評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 43,471評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,009評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 44,698評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,099評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,386評論 1 294
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,204評論 3 398
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 48,436評論 2 378

推薦閱讀更多精彩內(nèi)容