先更正一篇舊文裡的錯誤說法:「要在 Rails 中使用 Ajax,局部模板是必須的」——這是錯的。實踐之後可以確認,透過 insert_html、replace_html 這類輔助方法,可以直接操作頁面上的元素,完全不需要局部模板。實踐是檢驗真理的唯一標準,此言不虛。
原本產生樹狀結構的做法,是把伺服器取回的所有資料一次性交給一連串 JavaScript 函式,在瀏覽器端一口氣建出整棵樹。這方式用在系統功能選單上游刃有餘,但當樹裡有上千筆資料時,瀏覽器要花十幾秒才把整棵樹建好並畫到螢幕上——對使用者難以忍受,對開發者也是。
可行的方向很明確:用 Ajax 先顯示第一層節點,使用者點了某個節點,才向伺服器要它的子節點並展開。這樣每次來回的資料量都不大,頁面回應自然快得多。
第一次嘗試:沿用舊版的 JavaScript 函式。舊版的思路是在伺服器端把樹資料透過迴圈與遞歸,生成好一長串要在客戶端執行的函式呼叫,再整串回傳給頁面執行。前半段其實還算符合 Ajax 精神,但後半段就完全不是了——整串函式一次回傳、一次執行,等於沒給 Ajax 留下任何插入的空間。此路不通。
第二次嘗試:移植 .NET 版的 Ajax 樹。網上找到一個 C# 寫的版本,架好 IIS 之後跑起來還挺順,功能也強:節點的新增、刪除、編輯、拖曳移動都有,程式碼由一個 htm 頁與一個 aspx 頁組成,後者在伺服器端組出要回傳的 HTML 片段。但移植並不容易:一來對它生成 HTML 的思路不熟、不好控制;二來它是用 response.write 整段吐回,和 RJS 那種「直接指定頁面元素操作」的思路不一樣。
繞過這兩圈之後,思路反而清楚了,最後決定自己動手在 Rails 下做一個。
問題一:insert_html 無法在 table 最後追加一行。即使寫一個極簡的測試程式也一樣。最後的解法是用 div 與 span 當容器,每個樹節點各自用一個「只有一行的 table」來裝載。
問題二:render :update 裡只能放一句輔助方法呼叫。只要多加一個 if 判斷,或想再呼叫另一個輔助方法,整段程式碼就全部失效。原本打算先用 insert_html 加入元素、再用 call 呼叫 JavaScript 函式,完全行不通。最後改成預先在要插入的位置放一個空容器,再用 replace_html 把空內容換成回傳的 HTML 片段,同樣達到了加入元素的效果。
問題三:組出的 HTML 裡嵌 Ruby 碼斷不出來。由於節點本身還要帶 Ajax 連結,原本想用 #{} 把 Ruby 程式碼嵌進字串裡——理論上可行,實際操作卻幾乎都不生效。無奈之下,只好先讓頁面顯示第一層節點,檢視輸出的原始碼,照著實際生成的 Ajax 碼樣子手寫出來。這段程式碼說有多難看就有多難看。
一、加號要避開。節點文字中若含加號「+」,而該文字同時又是要送往伺服器的參數,組 HTML 時加號會被當成字串串接運算子。解法是在該處先把加號替換成不會被誤解的符號(例如底線「_」),傳給資料庫查詢時再換回來。Ruby 的 gsub 正好勝任:
str.gsub("+", "_") # 第一個參數也可以傳 Regular Expression
二、每個節點一個单行 table。除了繞開 insert_html 的限制,這麼做還有一個好處:每個節點都能獨立控制顯示位置,不必煩惱 colspan,只要在前面補上指定數量的 td 即可。
三、用級數控制縮排。點擊節點時,除了送出該節點的 ID,也一併回傳它的級數(第一層節點的級數為 0)。產生子節點時把父節點級數加一,就是子節點的級數;接著依級數做迴圈,在裝載子節點的 table 前面補上對應數量的 td,並在其中填入若干個 (一般 2~3 個)做縮排。要注意空格必須與 td 搭配使用才不會錯位;另一個做法是先用小畫家做一張白色小方塊的 bmp(尺寸配合節點前方展開/收合用的圖示),再把它嵌進 td 裡。以某個二級節點為例,它的 HTML 片段就是:
<table><tr><td> </td><td>二級節點</td></tr></table>
回頭看,這次折騰的價值不在那棵樹本身,而在釐清了「Ajax 樹該在哪裡切資料」:不是把整棵樹的渲染邏輯搬到前端,而是讓伺服器只負責回傳「某一層的片段」,前端只負責把它放到正確的位置。這個分工一旦想通,無論用 RJS、還是用今天的任何框架重寫,做法都會自然得多。