本文示範如何在 prototype.js 基礎上擴充出「表單驗證」與「進度條提示」功能,並以一個管理員登入頁面為例。
先引入修改後的 prototype.js,然後撰寫登入與回呼函式。登入時先用 CheckForm 驗證表單,再建立 ProgressBar 顯示狀態:
<script type="text/Javascript" src="../scripts/prototype.JS"></script>
<script type="text/Javascript">
var progressBar;
/* 功能:admin 登錄 */
function UserLogin()
{
//驗證頁面控制項
var checkform = new CheckForm();
if(!checkform.checkForm(document.getElementById('formLogin'))) return false;
//開始提交資料
progressBar = new ProgressBar();
progressBar.SetStatus("正在發送資料到伺服器.");
var url = "../admin.do";
var pars = "action=Login&username=" + $F('username') + "&password=" + $F('passWord') + "&rnd=" +$F('rnd');
var myAjax = new AJax.Request(
url,
{method: 'post', parameters: pars, onComplete: UserLogin_CallBack}
);
}
回呼函式解析伺服器回傳的 XML,判斷登入是否成功並更新進度條狀態:
/* 功能:admin 登錄 - CallBack */
function UserLogin_CallBack(originalRequest)
{
var objXml = originalRequest.responseXML;
try
{
if(objXML.getElementsByTagName("return")[0].firstChild.nodeValue == "true")
{
progressBar.isNeedConfirmButton = false;
progressBar.isNeedProgressBar = true;
progressBar.SetStatus("登錄成功,正在載入,請稍候..");
location.href='admin_index.htm';
}
else
{
progressBar.isNeedConfirmButton = true;
progressBar.isNeedProgressBar = false;
progressBar.focusItem = "username";
progressBar.SetStatus("對不起,登錄失敗!" + objXML.getElementsByTagName("msg")[0].firstChild.nodeValue);
$('btnOK').disabled = false;
}
}
catch(err)
{
progressBar.isNeedConfirmButton = true;
progressBar.isNeedProgressBar = false;
progressBar.focusItem = "username";
progressBar.SetStatus("對不起,登錄失敗!" + err.message);
$('btnOK').disabled = false;
}
}
</script>
表單包含使用者名稱、密碼與驗證碼三個欄位,每個輸入框都透過 chname(中文提示名)與 notempty(是否必填)等自訂屬性,交由 CheckForm 進行驗證:
<input type="text" tabindex="1" id="username" name="username" chname="用戶名" notempty="true" size="20" style="width:180px;" />
<input type="password" tabindex="2" id="password" name="passWord" chname="密碼" notempty="true" size="20" style="width:180px;" />
<input type="text" style="width:120px;" id="rnd" tabindex="3" chname="驗證碼" class="input_1" notempty="true" onKeyUp="value=value.replace(/[^\d]/g,'')"/>
<img alt="驗證碼" src="../rnd.do?type=admin_rnd" border="0"/>
如此一來,按下登入鈕時會先驗證欄位是否填寫完整,再送出非同步請求;伺服器回應後,進度條會依成功或失敗顯示對應的提示訊息與狀態。