這支 ajaxJS.js 是為 pjblog 撰寫的評論提交腳本,特色是把「載入動畫」、「GET 取資料」、「POST 送資料」三件事都收在同一支檔案裡,而且沒有依賴任何框架。逐段讀一遍,對理解原生 Ajax 的骨架很有幫助。
腳本一開始就寫入一個隱藏的絕對定位 DIV,套用半透明底色、置中文字與一張 loading 動圖:
document.write('<DIV id="loadingg" style="...display:none;">
<br/><font color="#708090"><b>數據正在讀取中,請等候...</b></font><br/>
<img src="images/loading.gif"/></DIV>')
這個函式同時肩「切換顯示」與「重新定位」兩件事。定位的算法是用視窗可視寬高減去元素自身寬高再除以二,然後加上捲動偏移量:
obj.style.left = ((document.documentElement.clientWidth - parseFloat(obj.style.width)) / 2)
+ document.documentElement.scrollLeft + "px";
obj.style.top = ((document.documentElement.clientHeight - parseFloat(obj.style.height)) / 2)
+ document.documentElement.scrollTop + "px";
加上 scrollLeft / scrollTop 這一步很關鍵,否則頁面捲動後提示層就會浮到錯誤的位置。函式尾端以 display 是否為空字串來決定要顯示還是隱藏,達到一鍵切換的效果。
function $(id) { return document.getElementById(id); }
function echo(obj, html) { $(obj).innerHTML = html; }
function fopen(obj) { $(obj).style.display = ""; }
function fclose(obj) { $(obj).style.display = "none"; }
把 getElementById、寫入 HTML、顯示、隱藏這四個動作各包一層,後面的程式碼可讀性就完全不一樣了。
依序嘗試 Msxml2.XMLHTTP(MSXML 3.0/4.0 以上)、Microsoft.XMLHTTP(舊版),最後才檢查原生 XMLHttpRequest。建立成功後,若有 overrideMimeType 方法就順手把型別設為 text/xml:
if (!xmlhttp && typeof XMLHttpRequest != 'undefined') {
xmlhttp = new XMLHttpRequest();
if (xmlhttp.overrideMimeType) {
xmlhttp.overrideMimeType('text/xml');
}
}
這種「多層 try/catch 逐個降級」的寫法,是那個年代處理 IE 與非 IE 分歧的標準手法。
流程是:建立物件 → 顯示 loading → 綁定 onreadystatechange → open("GET", url, true) → send(null)。在 callback 中先展開目標容器,等 readyState == 4 且 status == 200 時,把 responseText 寫入 obj2,並隱藏 obj1 的提示層、關閉 loading。
obj1 與 obj2 分離的設計相當實用:obj1 放「正在載入」的提示,obj2 放真正的內容,兩者完成交接後再把提示層收起來。
與 GET 版本的差異有三處:一是改用 open("POST", url, true);二是必須設定 setRequestHeader("Content-Type", "application/x-www-form-urlencoded"),否則伺服器無法正確解析表單內容;三是 send(data) 帶入要送出的字串。
成功回應後會依序執行:重新拉取最新評論(reget(rnd),帶隨機數避免快取)、兩秒後清空結果提示、清空 Message 欄位、關閉 loading。一連串動作正好對應「送出 → 清空表單 → 更新列表」的正常使用流程。
lTrim 與 rTrim 皆以遞迴方式剝除字串兩端的空白(IE 當時尚未提供原生的 String.trim),trim 則是兩者串接。而 f(obj) 負責從名為 ajax_post 的表單中取值並去除空白:
function f(obj) {
return trim(eval("document.ajax_post." + obj + ".value"));
}
這個函式示範了完整的前端驗證順序:
typeof eval(document.ajax_post.validate) != "undefined" 判斷表單中是否存在驗證碼欄位——這種寫法讓同一支腳本能同時適配有/無驗證碼兩種表單。escape() 編碼後串成查詢字串,交給 postdata 送出。
data = "username=" + escape(f("username")) +
"&password=" + escape(password) +
"&validate=" + escape(validate) +
"&log_DisSM=" + escape(log_DisSM) +
"&log_DisURL=" + escape(log_DisURL) +
"&log_DisKey=" + escape(log_DisKey) +
"&Message=" + escape(f("Message")) +
"&logID=" + escape(f("logID")) +
"&action=" + escape(f("action"));
postdata("wbc_blogcomm.asp", "showresult", data);
整支腳本不到兩百行,卻把「跨瀏覽器物件建立、GET/POST 雙軌請求、載入提示、表單驗證、字串處理」全部涵蓋。對想擺脫框架、親手寫一遍原生 Ajax 的人來說,是份長度與難度都剛剛好的練習素材。