用 Ajax 做留言功能,前端需要的不只是「把文字送出去」,還有一整套配套的零件:等待提示、內容寫入、顯示隱藏、請求物件、字串清理、表單檢查。這份 ajaxJS.js 就是作者把這些零件一次備齊、再拿去用在部落格留言上的成果。
腳本一開始用 document.write 直接寫出一個 id 為 loadingg 的絕對定位 div:205×65 像素、半透明黑底、白色粗邊框、橘色粗體字寫著「數據正在讀取中,請等候...」,預設 display:none。showloading() 則負責切換它,並在顯示時把 left 與 top 算成視窗中心——用 clientWidth 減去自身寬度再除以二,然後加上 scrollLeft 補上捲動量。這個算法兼顧了畫面捲動的情況,是很實用的技巧。
作者把常用的 DOM 操作包成單字元或短名稱,讓後面的程式碼寫起來乾淨不少:$ 依 id 取元素、echo 寫入 innerHTML、fopen 與 fclose 切換 display。這種「自製迷你函式庫」的做法在小專案裡很常見,prototype 等框架後來把這件事做得更完整。
createxmlhttp() 則是標準的跨瀏覽器工廠:先試 Msxml2.XMLHTTP、再試 Microsoft.XMLHTTP,都失敗才在支援時改用原生 XMLHttpRequest 並在可能的情況下 overrideMimeType 為 text/xml,最後回傳物件。
getdata(url, obj1, obj2) 用 GET 取得資料並顯示在 obj2,obj1 則是過程中的提示區。它先 showloading,把 onreadystatechange 指向內部的 requestdata;在 readyState 為 4 且 status 為 200 時,若 obj1 與 obj2 不同就把提示區隱藏,再把 responseText 寫進 obj2,最後關掉載入動畫。
postdata(url, obj, data) 走 POST:先產生一個隨機數 rnd,open 之後明確設定 Content-Type 為 application/x-www-form-urlencoded,再 send(data)。成功時除了寫入回應,還會做幾件善後:以 rnd 呼叫 reget 重新抓一次留言列表、兩秒後清空 showresult 區、清空 Message 欄位、關掉載入動畫。送出後立刻清空輸入框並關閉提示,這些細節組起來就是完整的送出體驗。
lTrim 與 rTrim 都用遞迴實作:檢查第一個(或最後一個)字元是否為空格,是就切掉再呼叫自己。trim 則是兩者串起來。遞迴寫 trim 很直觀,迴圈或正規表示式會更有效率,但在這種短字串上差異可以忽略。
f(obj) 是為這個表單量身做的取值器:它從 document.ajax_post 這個表單中取出指定欄位的值再 trim 過。SaveReply() 則是送出前的檢查:使用者名稱不可空白、內容不可空白;接著依核取方塊決定要不要收集 log_DisKey、log_DisURL、log_DisSM 這三個顯示選項;若表單裡存在 validate 或 password 欄位就一併收取;最後把全部欄位 escape 之後用 & 串成查詢字串,交給 postdata 送到 wbc_blogcomm.asp。
使用方式是先在頁面上放一個 id 為 ShowComm 的空白 div,載入 ajaxJS.js,然後定義 reget(str) 去呼叫 getdata 抓取留言列表,最後立刻呼叫一次 reget('get') 完成初次載入。網址上那個隨機小數參數同樣是為了繞過快取。
把這些零件拼起來看,會發現一個非同步留言區真正需要的東西其實不多:一個等待提示、一組讀寫函式、幾行驗證。剩下的功夫,都在把邊界情況處理得體面一些。