DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
寫一次就夠:通用表單驗證函式設計
編輯:XML詳解     

不管是動態網站還是其他 B/S 架構的系統,都離不開表單。表單作為客戶端向伺服器提交資料的載體,角色舉足輕重——而這立刻帶出一個問題:使用者送出的資料合法嗎?

於是每個專案都要寫一大堆驗證函式,開新專案再寫一次,然後再除錯一次。本文要談的是怎麼把這件事做成一次性的投資。

驗證該包含兩件事

我的看法是,表單驗證其實有兩個職責:

  1. 判斷使用者輸入的資料是否合法。
  2. 告訴使用者「為什麼不合法」。

只做到第一點的驗證,使用者只會看到表單沒反應,然後-repeat 三次後離開。因此通用函式需提供三個能力:取值 GetValue(el)、驗證 CheckForm(oForm)、以及錯誤時的提示與回焦 GoBack(el)。

關鍵:把規則寫在 HTML 上

IE 支援自訂屬性,這是整個方案的基礎。我們可以在每個表單元素上描述自己的規則, conceptually 很接近 XML 的思路:

  • check 屬性:存放該欄位合法性的正規表達式。
  • warning 屬性:存放驗證失敗時的提示訊息。

觸發點是表單的 onsubmit,寫法必須是 return CheckForm(this)——少寫 return 就前功盡棄。

<form onsubmit="return CheckForm(this)">

整體流程因此非常清爽:讀取表單元素的 check 屬性取得字串,據此建構 RegExp,拿來比對欄位值;通過就放行,失敗則讀取 warning 屬性彈出提示並把焦點移回該欄位。剩下的工作,就是把正規表達式寫好。

先把表單元素分類

依行為共性可分三大類:

一、文字輸入類(直接取 el.value)

<input type="text"     name="txt">
<input type="password" name="pwd">
<input type="hidden"   name="hid">
<input type="file"     name="myfile">
<textarea name="txts"></textarea>

二、核取與單選類(同一 name 構成一組,需回傳「選了幾個」)

<input type="checkbox" name="c">
<input type="radio"    name="r">

三、下拉選單類

<select name="sel"></select>
<select name="sels" multiple></select>

Check.js

/*
 * 客戶端表單通用驗證 CheckForm(oForm)
 *
 * 使用:
 *   <form name="form1" onsubmit="return CheckForm(this)">
 *     <input type="text" name="id"
 *            check="^\S+$" warning="帳號不能為空,且不能含有空格">
 *     <input type="submit">
 *   </form>
 *
 * 注意:撰寫正規表達式時務必嚴謹,別讓人有可乘之機。
 */

// 主函式:遍歷所有表單元素
function CheckForm(oForm) {
    var els = oForm.elements;
    for (var i = 0; i < els.length; i++) {
        if (els[i].check) {                       // 需要驗證
            var sReg = els[i].check;              // 正規表達式字串
            var sVal = GetValue(els[i]);          // 通用取值
            var reg  = new RegExp(sReg, "i");     // 不區分大小寫
            if (!reg.test(sVal)) {
                alert(els[i].warning);            // 顯示提示
                GoBack(els[i]);                   // 回焦
                return false;                     // 阻止提交
            }
        }
    }
    return true;
}

// 通用取值:分三類處理
function GetValue(el) {
    switch (el.type) {
        case "text":
        case "hidden":
        case "password":
        case "file":
        case "textarea":
            return el.value;
        case "checkbox":
        case "radio":
            return GetValueChoose(el);
        case "select-one":
        case "select-multiple":
            return GetValueSel(el);
    }
    return "";

    // 以 "0" 表示一個被選中的項目,撰寫正規式時可用 0{2,} 表示至少選兩項
    function GetValueChoose(el) {
        var sValue = "";
        var group = document.getElementsByName(el.name);
        for (var i = 0; i < group.length; i++) {
            if (group[i].checked) sValue += "0";
        }
        return sValue;
    }

    // 單選/多選下拉同理
    function GetValueSel(el) {
        var sValue = "";
        for (var i = 0; i < el.options.length; i++) {
            // 提示用的選項請將 value 設為空字串
            if (el.options[i].selected && el.options[i].value != "") {
                sValue += "0";
            }
        }
        return sValue;
    }
}

// 通用回焦:驗證未通過時的焦點處理
function GoBack(el) {
    switch (el.type) {
        case "text":
        case "hidden":
        case "password":
        case "file":
        case "textarea":
            el.focus();
            var rng = el.createTextRange ? el.createTextRange() : null;
            if (rng) { rng.collapse(false); rng.select(); }
            break;
        case "checkbox":
        case "radio":
            document.getElementsByName(el.name)[0].focus();
            break;
        case "select-one":
        case "select-multiple":
            el.focus();
            break;
    }
}

這裡有兩處刻意修正了常見的抄寫版本:一是每個 case 尾端補上 break,否則會一路穿透執行到下一個分支;二是 createTextRange 加上存在性檢查,避免在非 IE 瀏覽器上丟出錯誤。

demo.htm

<script language="JavaScript" src="Check.js"></script>

<form name="form1" onsubmit="return CheckForm(this)">
test:<input type="text" name="test">不驗證<br>

帳號:<input type="text" name="id"
      check="^\S+$" warning="帳號不能為空,且不能含有空格">不能為空<br>

密碼:<input type="password" name="pwd"
      check="\S{6,}" warning="密碼六位以上">六位以上<br>

電話:<input type="text" name="number"
      check="^\d+$" warning="電話號碼含有非法字元"><br>

相片上傳:<input type="file" name="pic"
      check="(.*)(\.jpg|\.bmp)$" warning="相片應為 JPG、BMP 格式"><br>

出生日期:<input type="text" name="dt"
      check="^\d{4}-\d{1,2}-\d{1,2}$" warning="日期格式 2004-08-10"><br>

省份:
<select name="sel" check="^0$" warning="請選擇所在省份">
  <option value="">請選擇
  <option value="1">福建省
  <option value="2">湖北省
</select><br>

選擇你喜歡的運動:<br>
游泳<input type="checkbox" name="c" check="^0{2,}$" warning="請選擇 2 項或以上">
籃球<input type="checkbox" name="c">
足球<input type="checkbox" name="c"><br>

你的學歷:
大學<input type="radio" name="r" check="^0$" warning="請選擇一項學歷">
中學<input type="radio" name="r">
小學<input type="radio" name="r"><br>

個人介紹:
<textarea name="txts" check="^[\s\S]{20,}$"
          warning="個人介紹不少於 20 字"></textarea><br>

<input type="submit">
</form>

核取方塊那組要注意:check 屬性只寫在第一個 checkbox 上即可,因為 GetValueChoose 會依 name 把整組一起撈出來算。

幾個實務提醒

  • 自訂屬性並非標準。這套寫法在 IE 上如魚得水,但在其他瀏覽器上,els[i].check 讀不到自訂屬性。跨瀏覽器時請改用 el.getAttribute('check')。
  • 正規表達式要寫得保守。像 ^\d+$ 這種帶錨點的寫法比 \d+ 安全得多,後者會讓「abc123」也通過。
  • 前端驗證只是第一道防線。使用者可以關掉 JavaScript 或直接送出手工打造的請求,因此伺服器端務必再驗一次,兩邊共用同一份規則定義最理想。
  • 想更省事:如今 HTML5 已提供 required、pattern、type="email" 等原生屬性,能取代其中相當一部分的正規式;若要處理複雜規則,再搭配 jQuery Validation 這類成熟套件。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved