早期做表單驗證,很多人會選擇 Really_easy_field_validation_with_Prototype 這套以 Prototype 為基礎的 lightweight 方案。它的思路很樸素:靠 CSS class 宣告規則,靠 Prototype 的事件觀察機制掛上驗證。以下把整個接入流程走一遍。
<link href="${ctx}/skin/css/validation.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="${ctx}/scripts/prototype.js"></script>
<script type="text/javascript" src="${ctx}/scripts/effects.js"></script>
<script type="text/javascript" src="${ctx}/scripts/validation.js"></script>
注意順序:Prototype 一定要排在 validation.js 之前,否則 Event.observe 之類的 API 會直接報錯。
把下面這段放進共用的 meta.jsp(每個頁面都會 include 它),就能省去逐頁設定的麻煩。這裡用輪詢等待 DOM 就緒,並只針對 name="method:save" 的表單建立驗證。
function afterLoaded() {
if (document.all) {
var forms = document.forms;
if (forms.length > 0) {
for (var i = 0; i < forms.length; i++) {
if (forms[i]["method:save"]) new Validation(forms[i]);
}
}
window.clearInterval(inteval);
inteval = null;
}
}
var inteval = window.setInterval("afterLoaded();", 500);
要驗證某個欄位,只要在 class 上加上標記即可,完全不必寫 JavaScript:
<input type="text" name="payable.howMuch" value="" id="payable_howMuch"
class="required validate-number" />
這行程式的意思是:該欄位必填,且內容必須是數字。其他可用標記直接翻到 validation.js 檔案末尾,那裡有完整的清單。
原始碼預設監聽表單的 submit 事件,但我們的表單常有好幾顆按鈕,只有 method:save 那顆需要觸發驗證。於是把:
if (this.options.onSubmit) Event.observe(this.form, 'submit', this.onSubmit.bind(this), false);
改成:
if (this.options.onSubmit) Event.observe(this.form["method:save"], 'click', this.onSubmit.bind(this), false);
這樣做並非萬能——如果使用者按 Enter 提交,驗證就不會觸發——但在按鈕數量固定的表單場景裡,這個取捨是划算的。
框架自帶的樣式表會替按鈕、輸入框加上邊框,容易和既有設計打架。實務上最省事的做法是把 validation.css 中所有 border 相關宣告移除,只保留錯誤狀態的提示樣式。
這套框架的規則集合偏向固定情境,若要靈活擴充仍得讀原始碼;好消息是它提供了 callback 機制,下載原始檔後在附帶的 HTML 範例中可以看到完整的演示用法。對於只需要「必填 + 數字 + 長度」這類基本檢查的後台表單,它依然是相當輕巧的選擇。