首頁那種「點標題才展開摘要、再點一次收起來」的版面,背後通常是一支以 ID 為軸心的腳本。這份 ajax.js 就是這樣的東西:它讓每一個分類、每一篇文章都能各自按需載入,並把展開狀態交給 session 記住。
整個腳本的基礎是一個把回應直接寫進指定元素的函式。它先依瀏覽器建立物件(Mozilla 系走原生 XMLHttpRequest 並在支援時用 overrideMimeType 指定 text/xml,IE 則依序嘗試 Msxml2.XMLHTTP 與 Microsoft.XMLHTTP),全都失敗就提示放棄。
接著有一個值得注意的設計:它用一個全域的 success 旗標搭配 onreadystatechange。alertContents 只在 readyState 為 4 且 status 為 200 時把 success 設為 true,否則提示請求發生問題;makeRequest 送出之後立刻檢查 success,為真才把 responseText 寫進傳入的目標元素,並用 try/catch 包住寫入動作。
這裡有個真實的 bug 值得指出:success==false; 這一行用的是比較運算子而不是指派運算子,所以它什麼都沒做,success 永遠不會被重設。這正是「用全域旗標傳遞非同步結果」最容易出錯的地方——今天更好的做法是把 DOM 更新直接寫進回呼函式裡,不繞這一圈。
setCatlog(ID, Order, LeftNumber) 先用 'Cate'+ID 拼出容器 id,交給 setdisplay 決定要展開還是收起。setdisplay 的邏輯是:目前隱藏就顯示並填入 Loading...,目前顯示就隱藏。真正顯示時才依狀態決定要請求哪個網址——展開時帶上 Order 與 LeftNumber(排序與起始筆數),收起時則帶 RemoveID=1 通知後端做清理。兩者都附上一個 Math.random() 參數來避開快取。
這個「用參數告知後端是展開還是收起」的設計,讓伺服器端能同步維護狀態,而不是讓前端獨自記住一切。
這兩個函式的結構幾乎相同:找出 'top'+ArticleID 與 'bottom'+ArticleID 兩個元素,各自檢查 display 是否為 none 並切換。差別在於 setArticleList 在展開下方元素時會順便發出請求(網址帶上編碼後的連結與隨機參數),DisplayContent 則只切換顯示狀態、不重新取資料。一個負責「載入並顯示」,一個負責「只顯示」,分工清楚。
用 top / bottom 兩個元素夾住同一篇文章,是為了讓同一段內容能在頁面上、下兩個位置各自展開,互不干擾。
ShowAllList(Order, LeftNumber, TagName) 用 getElementsByTagName 掃過指定標籤,只挑 className 為 SiteList 的元素,從它的 id 推回分類編號(把 "Cate" 換掉),再走一次 setdisplay2 與 makeRequest。setdisplay2 與 setdisplay 的差別是它依 ShowAllListFlag 決定要不要顯示,而這個旗標在函式末尾會在 1 與 2 之間翻轉——也就是「全部展開/全部收起」的開關。
ExpandListBySession(Str, Order, LeftNumber) 則是把字串形式的展開清單用 | 切開,逐一呼叫 setCatlog。整段包在 try/catch 裡,因為一旦某個 ID 不存在就會出錯。這讓伺服器可以把「上次展開了哪些分類」記在 session 裡,下次進站自動還原。
這個腳本最值得學的,是它用「ID 命名慣例 + 一字之差的參數」撐起整套按需載入行為——聰明、輕量,但也提醒我們:慣例越隱含,接手的人越難懂。