DIV CSS 佈局教程網

CascadeView 級聯元件實現思路詳解(職責分離與單鏈表)
編輯:關於JavaScript     

本文分享我近期實作省市級聯這類級聯功能的思路。為了盡可能做到職責分離、表現與行為分離,我把整個功能拆成了兩個元件,並用單鏈表來承載關鍵的級聯邏輯。這雖然是個很常見的功能,但本方案的實現邏輯清晰、程式碼好讀,也脫離了「省市」這樣的具體語義,希望能為你的工作提供一些參考價值。

(註:效果需透過 http 才能運行,且資料為模擬資料,因此各級下拉內容相同。)

1. 功能分析

以三個級聯項為例:

1)每個級聯項可能需要一個用作輸入提示的 option:

也可能不需要提示 option:

2)若頁面是從資料庫查出、且對應字段有值,則把值回顯到級聯元件上;

3)各級聯項在資料結構上構成單鏈表關係,後一項的列表與前一項所選有關聯;

4)考慮效能,各級列表採用 ajax 異步加載;

5)初始化完成後自動加載第一個級聯項的列表;

6)前一項改變時,清空後面所有關聯項,若新值不為空則自動加載相鄰下一項;

7)充分考慮效能,避免重複加載;

8)考慮表單提交,任意級聯項改變後需把選定值同步到隱藏文本域。

2. 實現思路

資料結構:採用 parentId 關聯的扁平結構,id 唯一、透過 parentId 構建層級,text、code 為業務字段:

{ "id": 1, "text": "北京市", "code": 110000, "parentId": 0 },
{ "id": 2, "text": "河北省", "code": 220000, "parentId": 0 }

這樣查詢接口非常統一:/api/cascade?parentId=0 查第一項,/api/cascade?parentId=1 查第二項,以此類推。後端處理起來也很簡單,因為雖然結構上是樹形表,但每次查詢都是單層的。

拿到資料後,把每條記錄解析成一個 option,如 <option value="北京市" data-param-value="1">北京市</option>,既能完成下拉顯示,又能透過 select 收集選中值,還能在改變時取出 data-param-value 作為 parentId 去加載下一級。

不過要考慮靈活性:字段名不一定是 id/parentId/text/code,因此這些都應設計成可配置 option:

textField: 'text',       //顯示字段
valueField: 'text',    //value 字段
paramField: 'id',      //傳給後台的數據字段
paramName: 'parentId',  //查詢參數名
defaultParam: '',     //查詢第一級時傳入的值(0、'' 或 -1)

html 結構:初始結構有兩種,區別在於是否配置了用作輸入提示的空 option。注意:若需要該空 option,務必把 value 設為空,否則提交時會把提示文字一并提交。關鍵元素是 select,ul/li 只是為 UI 服務;一個 select 代表一個級聯項,順序由 HTML 默認順序控制。這樣能最大程度做到表現與行為分離。

職責分離與單鏈表:按職責可分為兩個核心元件——CascadeView 負責整體功能與內部級聯項管理,CascadeItem 負責單個級聯項的功能實現。把所有級聯項串成鏈表,透過發布-訂閱模式,後一項訂閱前一項的改變消息,消息可一路傳到最後一項。

表單提交:把整個級聯元件當作一個整體,對外提供 onChanged 事件,任意級聯項改變時都觸發,外部可藉此獲取所有級聯項的值。

ajax 緩存:需考慮兩個層級——元件層級(同一組件內切換回已加載過的選項時直接用緩存)和請求層級(頁面多個組件用相同參數請求同一接口時複用結果)。元件內部只實現第一層緩存,第二層對它透明。

3. 實現細節

最終實現包含三個元件:CascadeView、CascadeItem、CascadePublicDefaults。前兩個是核心,最後一個用來定義公共 option。我個人越來越傾向於用註釋而非長篇文字來解釋實現細節,因為開發者普遍具備閱讀源碼的能力,也更願意透過琢磨程式碼來理解思路。

以上就是 CascadeView 級聯元件的完整實現思路與關鍵程式碼,希望對從事元件化開發的朋友有所啟發。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved